Présentation de Lookup

Lookup répond à des questions sur un destinataire avant que vous ne lui envoyiez quoi que ce soit. Donnez-lui un numéro de téléphone et il vous dit ce qu'est ce numéro : le réseau qui le dessert, le pays, s'il a changé de réseau, et le type de ligne. Donnez-lui une adresse e-mail et il vous dit si l'adresse vaut la peine d'être contactée.

Les deux se résument à une requête et une réponse. Il n'y a rien à créer, rien à interroger périodiquement, et rien à nettoyer après coup. La page Lookup dans le tableau de bord exécute les deux mêmes opérations une à la fois, ce qui est le moyen le plus rapide de voir à quoi ressemble une réponse avant d'écrire le moindre code.

Ce que coûte chaque lookup

Chaque lookup est facturé sur le portefeuille de votre organisation, et c'est la partie qu'il vaut la peine de comprendre avant de construire dessus.

Un lookup de numéro de téléphone facture toujours une fois pour le lookup de base. En plus de cela, vous pouvez demander des propriétés, des informations supplémentaires provenant d'une source de données payante. Chaque propriété demandée est facturée séparément, mais uniquement lorsqu'elle est effectivement renvoyée. Une propriété qui n'a pas pu être résolue revient avec un statut l'indiquant et ne vous coûte rien.

Un lookup d'adresse e-mail facture une fois par adresse résolue. Chaque verdict est facturé, undeliverable compris : c'est la réponse que vous avez demandée, et c'est celle qui vous évite un rebond.

Rien n'est facturé lorsqu'un lookup échoue. Un numéro mal formé, une adresse que nous refusons ou une source de données injoignable ne coûtent rien.

Tarification de Lookup liste le tarif du lookup de base, de chaque propriété et d'un lookup d'adresse e-mail.

Le lookup de numéro comporte deux niveaux

Cette distinction est au cœur de la conception du lookup de numéro de téléphone, et il vaut la peine de l'expliciter.

Le lookup de base s'exécute toujours. Il renvoie le réseau desservant le numéro, le réseau qui l'a attribué, le pays, si le numéro a déjà changé de réseau, et un line_type approximatif (mobile, ligne fixe, VoIP, numéro gratuit, etc.). Si le lookup de base ne peut pas être résolu, la requête entière échoue plutôt que de renvoyer une réponse à moitié vide que vous devriez inspecter pour découvrir qu'elle est vide.

Les propriétés sont ce que vous ajoutez par-dessus, en les nommant dans type. Elles répondent à des questions plus fines : le service alloué précis de la plage, l'historique complet de portabilité, si le numéro est actif sur le réseau en ce moment, s'il est en itinérance, quand sa SIM a été changée pour la dernière fois, et un score de crédibilité. Une propriété qui ne peut pas être résolue ne fait jamais échouer la requête. Elle se dégrade en un statut, et le lookup de base est quand même renvoyé.

Seul ok porte une valeur, et seul ok est facturé

Chaque bloc de propriété possède un status, et le lire n'est pas facultatif.

ok signifie que la propriété a été résolue, sa valeur figure dans la réponse, et elle a été facturée.

unavailable signifie qu'aucune réponse n'est arrivée, donc la propriété n'apporte rien. Elle n'a pas été facturée.

inconclusive signifie qu'une réponse est arrivée mais ne résout pas la propriété : le numéro se trouve hors de la couverture des données sous-jacentes, ou la source a renvoyé une valeur que cette propriété ne reporte pas. C'est un constat réel plutôt qu'une donnée manquante, et il n'a pas été facturé non plus.

status est un vocabulaire ouvert, de nouvelles valeurs peuvent donc être ajoutées. Branchez-vous sur ok et traitez tout le reste comme "not answered" : votre code restera correct quelle que soit son évolution.

Choisir entre Lookup et la validation à l'envoi

Lookup sert à décider avant de vous engager, un destinataire à la fois : vérifier un numéro ou une adresse à l'inscription, qualifier un prospect avant d'agir dessus, ou router un message différemment selon le type de ligne. Cela coûte de l'argent par vérification et vous donne une réponse exploitable.

Si vous voulez simplement arrêter d'envoyer aux adresses qui ont déjà rebondi ou fait l'objet d'une plainte, vous n'avez pas besoin de Lookup. Les suppressions le font automatiquement et gratuitement.

Aucune des deux opérations n'a de forme par lot, et la limitation du débit de lookup commence à 10 requêtes par minute par identifiant, donc vérifier une liste entière n'est pas ce pour quoi c'est dimensionné aujourd'hui. Contactez-nous pour augmenter la limite si c'est ce dont vous avez besoin.

Étapes suivantes

• Rechercher un numéro de téléphone couvre le lookup de base, chaque propriété, et ce que chacune renvoie.
• Rechercher une adresse e-mail couvre les verdicts et ce qu'il faut faire de chacun.
• Référence API de Lookup documente chaque champ.
• Idempotence explique comment réessayer un lookup sans le payer deux fois.