Stromträger

Der Einblick "Aktueller Betreiber" identifiziert den Mobilfunknetzbetreiber, der einer bestimmten Telefonnummer derzeit zugewiesen ist. Im Gegensatz zu Erkenntnissen, die auf der ursprünglichen Zuweisung basieren, spiegelt diese Funktion die Nummernübertragbarkeit wider und bietet aktuelle Informationen darüber, mit welchem Betreiber eine Telefonnummer verbunden ist.

Dieser Einblick ist in Szenarien wichtig, in denen Kommunikationseffizienz, Zustellbarkeit und Benutzerüberprüfung entscheidend sind. Durch die Bestätigung, ob eine Nummer aktiv einem Mobilfunknetz zugewiesen ist, können Unternehmen eine genaue Weiterleitung von SMS-, Sprach- oder datenbasierter Kommunikation sicherstellen. Auf diese Weise können Unternehmen unnötige Kosten und betriebliche Ineffizienzen vermeiden, die mit der Kontaktaufnahme zu deaktivierten (keinem Betreiber zugeordneten) oder nicht mobilen Numbers verbunden sind.

Einer der wichtigsten Anwendungsfälle ist die Bereinigung und Aktualisierung von Kundendatenbanken, um sicherzustellen, dass die Kontaktinformationen aktuell und gültig sind. Wenn beispielsweise festgestellt wird, dass eine Nummer nicht mehr einem Mobilfunkanbieter zugewiesen ist, können fehlgeschlagene Nachrichten vermieden, Wiederholungsversuche reduziert und eine hohe Qualität der Nutzerbindung aufrechterhalten werden. Außerdem unterstützt es den Schutz der Privatsphäre, indem es sich auf Mobilfunknummern konzentriert, die im Vergleich zu Festnetz-, virtuellen oder Premium-Anschlüssen in der Regel persönlicher sind und wahrscheinlich von einer Person genutzt werden.

Bei der Betrugsprävention und Identitätsüberprüfung kann die Kenntnis des aktuellen Mobilfunkanbieters als Signal dienen, um die Legitimität des Nutzers zu überprüfen und das Risiko zu verringern.

Durch die Nutzung dieser Erkenntnisse erhalten Unternehmen eine bessere Kontrolle über ihre Kommunikationsabläufe, verbessern die Benutzerfreundlichkeit und optimieren ihre Kontaktstrategien auf der Grundlage von Echtzeit-Telefonnummern.

Hinweis: Diese Einsicht gilt nur für Handynummern.

Voraussetzungen

Um Identity Insights nutzen zu können, müssen Sie sicherstellen, dass Ihr Account korrekt konfiguriert ist; siehe die Erste Schritte Leitfaden für weitere Informationen über:

  • Erstellen Sie Ihren Account,
  • Erstellen einer Vonage-Anwendung zur Verwendung mit der Identity Insights API,
  • Die verschiedenen verfügbaren Umgebungen und wie Sie Ihren Account für deren Nutzung konfigurieren,
  • Und wie Sie die Dashboard-Einstiegs-UI verwenden, um die API zu nutzen, ohne Code zu schreiben.

In diesem Leitfaden wird erklärt, wie Sie Current Carrier Insight programmatisch mit cURL nutzen können.

Die Identity Insights API ist über mehrere regionale Endpunkte verfügbar. Die Beispiele in diesem Leitfaden verwenden den EU-Endpunkt, aber Sie finden die vollständige Liste unter Technische Details.

Einen API-Aufruf tätigen

Die Authentifizierung für die Identity Insights API erfolgt über JWTs, ein kompaktes und in sich geschlossenes JSON-Token. Um ein JWT zu generieren, können Sie unser Online-Generatoroder verwenden Sie alternativ die Vonage CLI. Sie benötigen Ihre Anwendungs-ID und Ihren privaten Schlüssel, um das JWT zu erzeugen. Sobald Sie Ihr JWT haben, können Sie eine Anfrage an die API senden.

Dieses Beispiel zeigt eine cURL-Anfrage für den Einblick in den aktuellen Netzbetreiber:

curl -X POST https://api-eu.vonage.com/v0.1/identity-insights \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "14040000000",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
      "current_carrier": {}
        }
    }'

Die API liefert dann Informationen über das Netz, dem die Telefonnummer derzeit zugewiesen ist, einschließlich des Namens, des Netztyps und der Landesvorwahl:

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "current_carrier": {
         "name": "Orange Espana, S.A. Unipersonal",
         "network_type": "MOBILE",
         "country_code": "ES",
         "network_code": "21403",
         "status": {
            "code": "NO_COVERAGE",
            "message": "Success"
         }
      }
  }
}

Sie sehen die folgenden Felder im Fenster current_carrier Array:

Feld Beschreibung
name Der vollständige Name des Luftfahrtunternehmens, das phone_number assoziiert ist.
network_type Die Art des Netzes, das phone_number zugeordnet ist. Wird immer zurückkehren MOBILE.
country_code Zweistelliger Ländercode für phone_number. Dies ist in ISO 3166-1 alpha-2 Format.
network_code Mobilfunk-Ländercodes (MCC) + Mobilfunknetzcodes (MNC). E.212 Internationale mobile Teilnehmeridentität.
status Gibt den Status der Informationen an, die für die angegebene Telefonnummer zurückgegeben werden.
code Code, der den Status der Anfrage angibt. Muss einer der folgenden sein:

NO_COVERAGE: Das Land oder das Mobilfunknetz wird von den verfügbaren Anbietern nicht unterstützt.
INVALID_PURPOSE: Der verwendete Zweck ist für diese Einsicht nicht gültig oder zulässig.
UNAUTHORIZED: Die Anfrage konnte für die Kombination aus Antrag, Lieferant und Telefonnummer nicht autorisiert werden.
INTERNAL_ERROR: Bei der Bearbeitung der Anfrage ist ein interner Fehler aufgetreten.
SUPPLIER_ERROR: Der Anbieter hat bei der Bearbeitung der Anfrage einen Fehler gemeldet.
NOT_FOUND: Die Rufnummer konnte für diese Einsicht nicht gefunden werden.
INVALID_NUMBER_FORMAT: Das Format der Telefonnummern ist für die Zuweisung durch die Netzbetreiber an die Benutzer nicht gültig.
PARTIAL_SUCCESS: Einige Antwortattribute wurden weggelassen, weil sie nicht anwendbar oder nicht verfügbar waren.
OK: Alle Insight-Attribute sind verfügbar und in der Antwort enthalten.
message Ausführlichere Statusbeschreibung.

Weitere Lektüre