View a markdown version of this page

Verwenden Sie den Carrier-Lookup-Service - AWS SMS-Nachrichten für Endbenutzer
Anwendungsfälle für die Suche nach MobilfunkanbieternUnterstützte TelefonnummernformateVerwenden Sie den Netzbetreiber-Suchdienst in der AWS CLI

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden Sie den Carrier-Lookup-Service

AWS End User Messaging SMS umfasst einen Dienst zur Suche nach Mobilfunkanbietern, mit dem Sie Informationen zu einer Telefonnummer abrufen können, einschließlich der Frage, ob die Telefonnummer gültig ist. Der Netzbetreiber-Suchdienst gibt die folgenden Informationen für eine Telefonnummer zurück:

  • Die Telefonnummer im E164-Format (bereinigt von der ursprünglichen Eingabe).

  • Der Typ der Telefonnummer (z. B. ungültig, Festnetz, Handy, andere).

  • Der Name des Landes oder der Region für die Telefonnummer.

  • Die numerische Vorwahl des Landes oder der Region für die Telefonnummer.

  • Die zweistellige Landes- oder Regionalvorwahl im Format ISO 3166-1 Alpha-2 für die Telefonnummer.

  • Für Handynummern die Landesvorwahl des Mobiltelefons (MCC).

  • Für Handynummern der Mobilfunkcode (MNC).

  • Der Mobilfunkanbieter oder Dienstanbieter, bei dem die Telefonnummer derzeit registriert ist. In einigen Ländern und Regionen kann es sich bei diesem Wert um den Mobilfunkanbieter oder Dienstanbieter handeln, bei dem die Telefonnummer ursprünglich registriert war.

Für die Nutzung des Mobilfunkanbieter-Suchdienstes fallen zusätzliche Gebühren an. Weitere Informationen finden Sie unter SMS-Preise für AWS Endbenutzer-Nachrichten.

Anwendungsfälle für die Suche nach Mobilfunkanbietern

Sie können den Carrier Lookup Service verwenden, um verschiedene Anwendungsfälle zu ermöglichen, darunter die folgenden:

  • In einem Webformular angegebene Telefonnummern nachschlagen — Wenn Sie webbasierte Formulare verwenden, um Kontaktinformationen für Ihre Kunden zu sammeln, können Sie vor dem Absenden des Formulars nach den Telefonnummern suchen, die Kunden angegeben haben. Verwenden Sie das Backend Ihrer Website, um die Nummer mithilfe der SMS-API für AWS Endbenutzernachrichten nachzuschlagen und zu validieren. In der API-Antwort wird angegeben, ob die Nummer gültig ist, z. B. ob die Telefonnummer korrekt formatiert ist. Wenn Sie feststellen, dass die vom Kunden angegebene Telefonnummer ungültig ist, kann Ihr Webformular den Kunden auffordern, eine gültige Nummer anzugeben.

  • Bereinigen Ihrer vorhandenen Kontaktdatenbank — Wenn Sie über eine Datenbank mit Kunden-Telefonnummern verfügen, können Sie jede Telefonnummer nachschlagen und Ihre Datenbank anhand der Ergebnisse der Suche nach Mobilfunkanbietern aktualisieren. Wenn Sie beispielsweise Endpunkte mit Telefonnummern finden, die keine SMS-Nachrichten empfangen können, können Sie die Eigenschaft ChannelType des Endpunkts von SMS in VOICE ändern.

  • Auswählen des richtigen Kanals, bevor Sie eine Nachricht senden: Wenn Sie eine SMS-Nachricht senden möchten, aber feststellen, dass die Zieltelefonnummer ungültig ist, können Sie die Nachricht über einen anderen Channel an den Empfänger senden. Wenn der Endpunkt beispielsweise keine SMS-Nachrichten empfangen kann, können Sie stattdessen eine Sprachnachricht senden.

Unterstützte Telefonnummernformate

Telefonnummern müssen im Format E164 sein und mit einem Pluszeichen (+) beginnen, gefolgt von der Landesvorwahl und der Telefonnummer (z. B. +12065551234). Der Netzbetreiber-Suchdienst akzeptiert verschiedene Formatierungszeichen und entfernt sie bei der Verarbeitung automatisch. Sie können die folgenden Formatierungszeichen in Ihre Telefonnummerneingabe aufnehmen:

  • Klammern: +1 (555) 123-4567

  • Klammern: +1 [555] 123-4567

  • Leerzeichen: +1 555 123 4567

  • Bindestriche: +1-555-123-4567

  • Perioden: +1.555.123.4567

  • Kommas: +1,555,123,4567

  • Gemischte Formatierung: +1 (555)-123.4567

Alle Formatierungszeichen werden bei der Verarbeitung automatisch entfernt, und der Dienst gibt die Telefonnummer im Standardformat E164 (z. B.+15551234567) in das E164PhoneNumber Antwortfeld zurück.

Verwenden Sie den Netzbetreiber-Suchdienst in der AWS CLI

Das folgende Beispiel zeigt, wie Sie den Carrier-Suchdienst in der verwenden AWS CLI. Der Dienst akzeptiert Telefonnummern mit verschiedenen Formatierungszeichen (Klammern, Klammern, Leerzeichen, Bindestriche, Punkte, Kommas) und konvertiert sie zur Verarbeitung automatisch in das E164-Format. Weitere Informationen finden Sie CarrierLookupin der SMS-API-Referenz für AWS Endbenutzernachrichten oder unter Carrier-Lookup in der Befehlsreferenz. AWS CLI

Um den Carrier Lookup Service (CLI) zu verwenden

  • Geben Sie in der Befehlszeile den folgenden Befehl ein: Sie können verschiedene Rufnummernformate verwenden. Der Dienst akzeptiert Sonderzeichen wie Klammern, Klammern, Leerzeichen, Bindestriche, Punkte und Kommas:

    $ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number "+1 (555) 555-5333"

    Oder mit dem E164-Format:

    $ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number +15555555333

Antworten bei der Suche nach Netzbetreibern

Die Informationen, die der Netzbetreiber-Suchdienst bereitstellt, variieren geringfügig, je nachdem, welche Daten für die von Ihnen angegebene Telefonnummer verfügbar sind. Dieser Abschnitt enthält Beispiele für die Antworten, die der Netzbetreiber-Suchdienst zurückgibt.

Anmerkung

Die vom Carrier-Suchdienst bereitgestellten Daten basieren auf Informationen, die von Telekommunikationsanbietern und anderen Unternehmen auf der ganzen Welt bereitgestellt werden. Anbieter aktualisieren diese Daten in einigen Ländern möglicherweise seltener als Anbieter in anderen Ländern. Wenn Sie beispielsweise eine Anfrage zur Überprüfung einer Handynummer stellen und die von Ihnen angegebene Nummer von einem Mobilfunkanbieter auf einen anderen übertragen wurde, kann die Antwort des Netzbetreiber-Suchdienstes den Namen des ursprünglichen Netzbetreibers und nicht den Namen des aktuellen Mobilfunkanbieters enthalten.

Gültige Mobiltelefonnummern

Die folgende Antwort ist ein Beispiel für die Informationen, die für eine gültige Handynummer CarrierLookup zurückgegeben werden:

{
    "E164PhoneNumber": "+15555555333",
    "DialingCountryCode": "1",
    "IsoCountryCode": "US",
    "Country": "United States",
    "MCC": "310",
    "MNC": "260",
    "Carrier": "ExampleCorp Mobile",
    "PhoneNumberType": "MOBILE"
}
Gültige Festnetztelefonnummern

Die folgende Antwort ist ein Beispiel für die Informationen, die für eine gültige Festnetznummer CarrierLookup zurückgegeben werden:

{
    "E164PhoneNumber": "+15555555333",
    "DialingCountryCode": "1",
    "IsoCountryCode": "CA",
    "Country": "Canada",
    "Carrier": "ExampleCorp Landline",
    "PhoneNumberType": "LANDLINE"
}
Ungültige Telefonnummern

Wenn Ihre Anfrage eine ungültige Telefonnummer enthält, gibt der Netzbetreiber-Suchdienst Informationen zurück, die dem folgenden Beispiel ähneln:

{
    "E164PhoneNumber": "+15555555333444666",
    "PhoneNumberType": "INVALID"
}}

Beachten Sie, dass die Eigenschaft PhoneNumberType in dieser Antwort angibt, dass diese Telefonnummer INVALID ist und dass keine Informationen zur Telefongesellschaft oder zum Ort der Telefonnummer enthalten sind. Senden Sie keine SMS- oder Sprachnachrichten an Telefonnummern, deren PhoneNumberType den Wert INVALID hat, weil sie wahrscheinlich keinen tatsächlichen Empfängern gehören.

Andere Telefonnummern

Telefonnummern, die nicht als Mobil-, Festnetz- oder ungültige Nummern eingestuft sind, werden mit einem PhoneNumberType Wert von OTHER zurückgegeben.