Lookup – Übersicht

Lookup beantwortet Fragen über einen Empfänger, bevor Sie an ihn senden. Geben Sie eine Telefonnummer ein, und Lookup sagt Ihnen, was die Nummer ist: das zustellende Netz, das Land, ob die Nummer das Netz gewechselt hat und um welche Art von Anschluss es sich handelt. Geben Sie eine E-Mail-Adresse ein, und Lookup sagt Ihnen, ob sich der Versand an diese Adresse lohnt.

Beides ist eine Anfrage und eine Antwort. Sie müssen nichts anlegen, nichts abfragen und nichts aufräumen. Die Lookup-Seite im Dashboard führt dieselben beiden Operationen einzeln aus – der schnellste Weg, eine Antwort zu sehen, bevor Sie Code schreiben.

Jede Abfrage wird dem Guthaben Ihrer Organisation belastet, und genau das sollten Sie verstehen, bevor Sie darauf aufbauen.

Eine Telefonnummer-Abfrage wird immer einmal für die Basisabfrage berechnet. Zusätzlich können Sie Properties anfordern, weitere Fakten aus einer kostenpflichtigen Datenquelle. Jede angeforderte Property wird einzeln berechnet, aber nur wenn sie geliefert wird. Eine Property, die nicht beantwortet werden konnte, kommt mit einem Status zurück, der das anzeigt, und kostet Sie nichts.

Eine E-Mail-Adress-Abfrage wird einmal pro beantworteter Adresse berechnet. Jedes Ergebnis wird berechnet, undeliverable eingeschlossen: Das ist die Antwort, die Sie angefordert haben, und sie bewahrt Sie vor einem Bounce.

Nichts wird berechnet, wenn eine Abfrage fehlschlägt. Eine fehlerhafte Nummer, eine von uns abgelehnte Adresse oder eine nicht erreichbare Datenquelle kosten nichts.

Lookup-Preise listet die Tarife für die Basisabfrage, für jede Property und für eine E-Mail-Adress-Abfrage auf.

Diese Aufteilung ist das gesamte Design der Telefonnummer-Abfrage und verdient eine klare Erklärung.

Die Basisabfrage läuft immer. Sie liefert das zustellende Netz, das Netz, das die Nummer vergeben hat, das Land, ob die Nummer jemals das Netz gewechselt hat, und einen groben line_type (Mobilfunk, Festnetz, VoIP, gebührenfrei usw.). Kann die Basisabfrage nicht beantwortet werden, schlägt die gesamte Anfrage fehl, statt eine halb leere Antwort zurückzugeben, die Sie erst inspizieren müssten, um die Leere zu entdecken.

Properties sind das, was Sie darüber hinaus hinzufügen, indem Sie sie in type angeben. Sie beantworten feinere Fragen: den exakt zugewiesenen Dienst des Nummernbereichs, den vollständigen Portierungsverlauf, ob die Nummer gerade im Netz aktiv ist, ob sie roamt, wann die SIM zuletzt gewechselt wurde und einen Glaubwürdigkeitswert. Eine Property, die nicht beantwortet werden kann, lässt die Anfrage nie fehlschlagen. Sie fällt auf einen Status zurück, und die Basisabfrage wird weiterhin geliefert.

Jeder Property-Block hat einen status, und ihn auszulesen ist nicht optional.

ok bedeutet, dass die Property beantwortet wurde, ihr Wert in der Antwort enthalten ist und sie berechnet wurde.

unavailable bedeutet, dass keine Antwort eintraf und die Property nichts beiträgt. Sie wurde nicht berechnet.

inconclusive bedeutet, dass eine Antwort eintraf, die Property aber nicht auflöst: Die Nummer liegt außerhalb der Abdeckung der dahinterliegenden Daten, oder die Quelle lieferte einen Wert, den diese Property nicht abbildet. Es ist ein echtes Ergebnis und kein fehlendes, und es wurde ebenfalls nicht berechnet.

status ist ein offenes Vokabular, weitere Werte können hinzukommen. Verzweigen Sie auf ok und behandeln Sie alles andere wie "not answered", dann bleibt Ihr Code korrekt, egal wie es sich erweitert.

Lookup ist dafür da, vor dem Senden zu entscheiden, jeweils für einen Empfänger: eine Nummer oder Adresse bei der Registrierung prüfen, einen Lead screenen, bevor Sie darauf reagieren, oder eine Nachricht je nach Anschlussart anders routen. Es kostet Geld pro Prüfung und liefert Ihnen eine Antwort, auf die Sie handeln können.

Wenn Sie lediglich den Versand an Adressen stoppen wollen, die bereits gebounced haben oder sich beschwert haben, brauchen Sie Lookup nicht. Suppressions erledigen das automatisch und kostenlos.

Keine der beiden Operationen hat eine Batch-Variante, und die lookup-Begrenzung der Anfragerate beginnt bei 10 Anfragen pro Minute pro Credential. Eine ganze Liste zu prüfen ist also nicht das, wofür der Dienst heute ausgelegt ist. Sprechen Sie uns an, wenn Sie ein höheres Limit benötigen.