View a markdown version of this page

Auswahl einer 10DLC-Telefonnummer anhand der Vorwahl - AWS SMS-Nachrichten für Endbenutzer

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.

Auswahl einer 10DLC-Telefonnummer anhand der Vorwahl

Wenn Sie eine Telefonnummer mit einer 10-stelligen Vorwahl (10DLC) anfordern, können Sie nach einer bestimmten Nummer suchen und diese auswählen, anstatt eine zufällige Zuweisung zu erhalten. Sie können nach einer Vorwahl oder nach einem Muster innerhalb der Telefonnummer suchen. Sie können auch eine genaue Telefonnummer anfordern. Diese Funktion ist nur für 10DLC-Telefonnummern in den Vereinigten Staaten verfügbar.

Die Auswahl der Telefonnummer erfolgt in zwei Schritten:

  1. Suche — Verwenden Sie die ListAvailablePhoneNumbers API oder die Konsole, um verfügbare 10DLC-Nummern zu durchsuchen, die nach Vorwahl oder Muster gefiltert sind.

  2. Anfrage — Verwenden Sie die RequestPhoneNumber API mit dem optionalen NumberPreference Parameter oder wählen Sie eine Nummer in der Konsole aus, um eine bestimmte Telefonnummer anzufordern.

Voraussetzungen

Bevor Sie nach einer 10DLC-Telefonnummer suchen und diese auswählen können, müssen Sie über Folgendes verfügen:

Die Suche nach Telefonnummern gibt Nummern zurück, die über den Aggregator verfügbar sind, der mit Ihrer 10DLC-Kampagnenregistrierung verknüpft ist. Sie müssen keinen Aggregator angeben.

Typen von Suchmustern

Sie können mithilfe der folgenden Mustertypen nach verfügbaren Telefonnummern suchen:

Mustertyp Description Beispiel
StartsWith Gibt Zahlen zurück, die mit den angegebenen Ziffern beginnen. Verwenden Sie diese Option, um nach der Vorwahl zu suchen. Der Filter +1510 gibt Zahlen in der 510-Vorwahl zurück, z. +15103921111 B.
EndsWith Gibt Zahlen zurück, die mit den angegebenen Ziffern enden. Der Filter 1234 gibt Zahlen zurück, die auf 1234 enden, wie +12025551234 z. B.
Contains Gibt Zahlen zurück, die die angegebenen Ziffern an einer beliebigen Stelle in der Zahl enthalten. Der Filter 555 gibt Zahlen zurück, die 555 enthalten, z. +15105559876 B.
ExactMatch Fordert eine bestimmte Telefonnummer an. Dieser Typ ist nur mit der RequestPhoneNumber API gültig, nicht mitListAvailablePhoneNumbers. Der Filter +15103921234 fordert genau diese Zahl an.

Wichtige Überlegungen

  • Die Verfügbarkeit der Telefonnummer ist nicht garantiert. Eine in den Suchergebnissen angezeigte Nummer kann von einem anderen Kunden gekauft werden, bevor Sie sie anfordern. In diesem Fall fordern Sie eine andere Nummer an oder suchen Sie erneut.

  • Die Suchergebnisse stellen keine Reservierung dar. Zwischen dem Suchschritt und dem Anforderungsschritt werden keine Zahlen für Sie gespeichert.

  • Die Suchergebnisse geben maximal 10 Zahlen pro Seite zurück. Verwenden Sie den NextToken Parameter, um weitere Seiten mit Ergebnissen abzurufen.

  • Wenn Sie NumberPreference beim Telefonieren keine angebenRequestPhoneNumber, bleibt das bestehende Verhalten unverändert, und AWS End User Messaging SMS weist automatisch eine Telefonnummer zu.

  • Diese Funktion ist nur für 10DLC (TEN_DLC) -Telefonnummern in den Vereinigten Staaten verfügbar.

Suchen Sie nach einer 10DLC-Telefonnummer und fordern Sie sie an

Sie können nach einer bestimmten 10DLC-Telefonnummer suchen und diese anfordern, indem Sie entweder die AWS End User Messaging-SMS-Konsole oder die verwenden. AWS CLI

Console

Sie können während der Rufnummernanforderung in der AWS End User Messaging SMS-Konsole nach einer bestimmten 10DLC-Telefonnummer suchen und diese auswählen.

Wählen Sie eine 10DLC-Telefonnummer anhand der Vorwahl (Konsole)
  1. Öffnen Sie die AWS End User Messaging SMS-Konsole unter. https://console.aws.amazon.com/sms-voice/

  2. Wählen Sie im Navigationsbereich unter Konfigurationen die Option Telefonnummern und dann Absender anfordern aus.

  3. Wählen Sie auf der Seite „Land auswählen“ im Drop-down-Menü „Nachrichten-Zielland“ die Option Vereinigte Staaten (USA) aus. Wählen Sie Weiter aus.

  4. Füllen Sie den Abschnitt Messaging-Anwendungsfall aus und wählen Sie Weiter aus.

  5. Wählen Sie unter Originatortyp den 10DLC-Nummerntyp aus und ordnen Sie Ihre registrierte Marke und Kampagne zu.

  6. (Optional) Suchen Sie im Schritt „Bevorzugte Nummer“ nach einer bestimmten Telefonnummer:

    1. Wählen Sie einen Suchmustertyp aus: Beginnt mit , Endet mit oder Enthält.

    2. Geben Sie ein Muster ein. Geben Sie beispielsweise ein, 510 um nach Zahlen in der Vorwahl 510 zu suchen. Die Konsole formatiert Ihre Eingabe automatisch mit dem Landeskennzahl-Präfix.

    3. Wählen Sie Search (Suchen) aus. In einer Tabelle werden bis zu 10 verfügbare Telefonnummern angezeigt.

    4. Wählen Sie die gewünschte Telefonnummer aus, und klicken Sie dann auf Weiter.

    Wenn Sie diesen Schritt überspringen, weist AWS End User Messaging SMS automatisch eine Telefonnummer zu.

  7. Konfigurieren Sie bei Bedarf die gemeinsame Nutzung von Ressourcenrichtlinien und wählen Sie dann Weiter.

  8. Bestätigen Sie unter Prüfen und anfordern Ihre Einstellungen und wählen Sie Anfordern aus.

AWS CLI

Verwenden Sie die AWS CLI , um nach verfügbaren 10DLC-Telefonnummern zu suchen und dann eine bestimmte Nummer anzufordern.

Schritt 1: Suchen Sie nach verfügbaren Nummern

Verwenden Sie den Befehl list-available-phone-numbers, um nach verfügbaren 10DLC-Telefonnummern zu suchen. Im folgenden Beispiel wird nach Nummern in der Vorwahl 510 gesucht:

$ aws pinpoint-sms-voice-v2 list-available-phone-numbers \ --iso-country-code US \ --number-type TEN_DLC \ --registration-id registration-1234567890 \ --number-preference '[{"PreferenceType": ["StartsWith"], "Filter": ["+1510"]}]'

Wenn Nummern verfügbar sind, die Ihren Suchkriterien entsprechen, enthält die Antwort eine Liste von Telefonnummern im folgenden E.164 Format:

{ "AvailablePhoneNumbers": [ "+15103921111", "+15103922222", "+15103923333", "+15103924444", "+15103925555" ], "NextToken": "AAMAJDUwNzE4ZTQwLWJkOTUtNDk4Ny..." }

Nehmen Sie im vorherigen Befehl die folgenden Änderungen vor:

  • Ersetze es registration-1234567890 durch die ID deiner genehmigten 10DLC-Kampagnenregistrierung.

  • Ersetze es +1510 durch die Vorwahl oder das Muster, nach dem du suchen möchtest.

  • StartsWithErsetzen Sie durch EndsWith oderContains, um den Suchmustertyp zu ändern.

Wenn die Antwort einen NextToken Wert enthält, geben Sie ihn in einer nachfolgenden Anfrage weiter, um die nächste Ergebnisseite abzurufen. Wenn Null NextToken ist, gibt es keine weiteren Ergebnisse.

Schritt 2: Fordern Sie eine bestimmte Nummer an

Nachdem Sie eine Telefonnummer in den Suchergebnissen gefunden haben, verwenden Sie den Befehl request-phone-number mit dem --number-preference Parameter, um diese Nummer anzufordern.

Im folgenden Beispiel wird eine genaue Telefonnummer angefordert:

$ aws pinpoint-sms-voice-v2 request-phone-number \ --iso-country-code US \ --message-type TRANSACTIONAL \ --number-type TEN_DLC \ --number-capabilities SMS \ --registration-id registration-1234567890 \ --number-preference '{"PreferenceType": ["ExactMatch"], "Filter": ["+15103921111"]}'

Sie können eine Telefonnummer auch anhand eines Musters anfordern. Im folgenden Beispiel wird jede verfügbare Nummer in der Vorwahl 510 abgefragt:

$ aws pinpoint-sms-voice-v2 request-phone-number \ --iso-country-code US \ --message-type TRANSACTIONAL \ --number-type TEN_DLC \ --number-capabilities SMS \ --registration-id registration-1234567890 \ --number-preference '{"PreferenceType": ["StartsWith"], "Filter": ["+1510"]}'

Nehmen Sie in den vorherigen Befehlen die folgenden Änderungen vor:

  • Ersetze es registration-1234567890 durch die ID deiner genehmigten 10DLC-Kampagnenregistrierung.

  • Ersetzen Sie TRANSACTIONAL durchPROMOTIONAL, wenn Sie Werbebotschaften senden.

  • SMSErsetzen Sie es durch die Funktionen, die Sie benötigen. Sie können SMSMMS, und angebenVOICE.

  • Ersetzen Sie die Telefonnummer oder das Muster in Filter durch Ihren bevorzugten Wert.

Wenn die angeforderte Nummer verfügbar ist, entspricht die Antwort einer RequestPhoneNumber Standardantwort, einschließlich der Status Felder PhoneNumberIdPhoneNumber, und. Wenn die genaue Nummer nicht mehr verfügbar ist, gibt die Anfrage einen Fehler zurück. Suchen Sie erneut, um eine andere verfügbare Nummer zu finden.