Anfordern einer Telefonnummer - Amazon Pinpoint-SMS
Telefonnummernstatus

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.

Anfordern einer Telefonnummer

Mithilfe der Amazon Pinpoint-SMS-Konsole empfehlen wir je nach Anwendungsfall eine der folgenden Ursprungsidentitäten. Empfehlungen basieren auf Ihren Eingabekriterien, einschließlich der Frage, ob Sie SMS- und/oder Sprachfunktionen benötigen, einer bidirektionalen Zahl und der Schätzung der monatlichen Nachrichten.

Anmerkung

Die folgenden Telefonnummerntypen müssen in der Support Center Console angefordert werden.

Sie können entweder die Amazon Pinpoint-SMS-Konsole oder verwenden AWS CLI , um eine neue Telefonnummer anzufordern.

Request a phone number (Console)

Gehen Sie zum Anfordern einer Telefonnummer mit der Amazon-Pinpoint-Konsole wie folgt vor:

Anfordern einer Telefonnummer (Konsole)

  1. Öffnen Sie die Amazon-Pinpoint-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. Auf der Seite Land auswählen müssen Sie aus dem Dropdown-Menü das Zielland der Nachricht auswählen, an das die Nachrichten gesendet werden sollen. Wählen Sie Weiter aus.

  4. Geben Sie im Abschnitt Anwendungsfall für Messaging Folgendes ein:

    • Wählen Sie unter Rufnummernfunktionen je nach Ihren Anforderungen entweder SMS, Sprachnachrichten oder beides aus.

      Wichtig

      Die Funktionen für SMS und Sprache können nach dem Kauf der Telefonnummer nicht mehr geändert werden.

      • SMS – Wählen Sie dies aus, wenn Sie SMS-Funktionen benötigen.

      • Sprache (Text zu Audio) – Wählen Sie dies aus, wenn Sie Sprachfunktionen benötigen.

    • Wählen Sie unter Geschätztes monatliches SMS-Nachrichtenvolumen – optional die geschätzte Anzahl der SMS-Nachrichten aus, die Sie jeden Monat versenden werden.

    • Wählen Sie für Firmensitz – optional eine der folgenden Optionen aus:

      • Lokal – Wählen Sie dies aus, wenn sich der Unternehmenshauptsitz in demselben Land befindet wie Ihre Kunden, die SMS-Nachrichten wieder aufnehmen werden. Sie würden diese Option beispielsweise wählen, wenn sich Ihr Hauptsitz in den USA befindet und sich Ihre Benutzer, die Nachrichten erhalten, ebenfalls in den USA befinden.

      • International – Wählen Sie dies aus, wenn sich der Unternehmenshauptsitz nicht im selben Land wie Ihre Kunden befindet, die SMS-Nachrichten abrufen werden.

    • Wählen Sie für bidirektionales Messaging Ja aus, wenn Sie bidirektionales Messaging benötigen.

  5. Wählen Sie Weiter aus.

  6. Wählen Sie unter Ursprungstyp auswählen entweder den empfohlenen Telefonnummertyp oder einen der verfügbaren Nummerntypen aus. Die verfügbaren Optionen basieren auf den Anwendungsfallinformationen, die Sie in den vorherigen Schritten ausgefüllt haben.

    Wenn Sie 10DLC wählen und bereits eine registrierte Kampagne haben, können Sie die Kampagne aus der Kampagne Mit registrierter Kampagne verknüpfen auswählen, um die 10DLC-Telefonnummer zur 10DLC-Kampagne hinzuzufügen.

    Wenn der gewünschte Nummerntyp nicht verfügbar ist, können Sie Zurück wählen, um zurückzugehen und Ihren Anwendungsfall zu ändern. Überprüfen Sie auch die , Unterstützte Länder und Regionen (SMS-Kanal) um sicherzustellen, dass der gewünschte Ursprungstyp im Zielland unterstützt wird.

    Wenn Sie eine Kurz- oder Langwahlnummer anfordern möchten, müssen Sie einen Fall bei öffnen AWS Support. Weitere Informationen finden Sie unter Anfordern von Kurzwahlnummern für SMS-Nachrichten mit Amazon Pinpoint SMS und Anfordern dedizierter Langwahlnummern für SMS-Nachrichten mit Amazon Pinpoint SMS.

  7. Wählen Sie Weiter aus.

  8. Unter Überprüfung und Anfrage können Sie Ihre Afrage überprüfen und bearbeiten, bevor Sie sie absenden. Wählen Sie Request (Anfrage).

  9. Abhängig von der Art der von Ihnen angeforderten Telefonnummer wird möglicherweise das Fenster Registrierung erforderlich angezeigt. Ihre Telefonnummer oder Absender-ID ist mit dieser Registrierung verbunden und kann erst dann Nachrichten senden, wenn Ihre Registrierung genehmigt wurde. Weitere Informationen zu den Registrierungsanforderungen finden Sie unter Anmeldungen.

    1. Geben Sie unter Name des Anmeldeformulars einen benutzerfreundlichen Namen ein.

    2. Wählen Sie Registrierung beginnen, um die Registrierung der Telefonnummer abzuschließen, oder Später registrieren.

      Wichtig

      Ihre Telefonnummer oder Absender-ID kann erst dann Nachrichten senden, wenn Ihre Registrierung genehmigt wurde.

      Ihnen wird weiterhin die wiederkehrende monatliche Leasinggebühr für die Telefonnummer in Rechnung gestellt, unabhängig vom Registrierungsstatus. Weitere Informationen zu den Registrierungsanforderungen finden Sie unter Anmeldungen.

Request a phone number (AWS CLI)

Sie können den request-phone-number Befehl verwenden, um Ihrem Konto neue Telefonnummern hinzuzufügen. Die Verfügbarkeit von Telefonnummern und die unterstützten Features variieren je nach Land.

Wichtig

Möglicherweise müssen Sie die Telefonnummer oder Absender-ID registrieren, nachdem Sie die Anfrage abgeschlossen haben. Ihnen wird weiterhin die wiederkehrende monatliche Leasinggebühr für die Telefonnummer in Rechnung gestellt, unabhängig vom Registrierungsstatus. Weitere Informationen zu den Registrierungsanforderungen finden Sie unter Anmeldungen.

So fordern Sie eine Telefonnummer an:

  • Geben Sie in der Befehlszeile folgenden Befehl ein:

    $ aws pinpoint-sms-voice-v2 request-phone-number \
> --iso-country-code XX \
> --message-type TRANSACTIONAL \
> --number-capabilities VOICE \
> --number-type LONG_CODE \
> --pool-id poolId \
> --deletion-protection-enabled \
> --opt-out-list-name optOutListName \
> --registration-id CO123EX

    Nehmen Sie im vorherigen Befehl die folgenden Änderungen vor:

    • Ersetzen Sie XX durch den zweistelligen ISO-3166-Alpha-2-Code für das Land, in dem die Telefonnummer registriert ist (z. B. CA für Kanada).

    • Wenn Sie die Telefonnummer für den Versand von Werbe- oder Marketinginhalten verwenden möchten, ersetzen Sie TRANSACTIONAL durch PROMOTIONAL. Verwenden Sie andernfalls TRANSACTIONAL.

    • Wenn Sie eine Telefonnummer für den Versand von SMS-Nachrichten anfordern möchten, ersetzen Sie VOICE durch SMS. Sie können auch eine Telefonnummer anfordern, die zum Senden von SMS- und Sprachnachrichten verwendet werden kann, indem Sie SMS VOICE angeben.

    • Ersetzen Sie LONG_CODE durch den Typ der Telefonnummer, die Sie anfordern möchten. Akzeptable Werte sind LONG_CODE, TOLL_FREE und TEN_DLC.

    • Ersetzen Sie poolId durch die ID oder den Amazon-Ressourcennamen (ARN) des Pools, zu dem Sie die Telefonnummer hinzufügen möchten. Dieser Parameter ist optional. Wenn Sie die Telefonnummer nicht zu einem Pool hinzufügen möchten, lassen Sie diesen Parameter weg.

    • Wenn Sie den Löschschutz für diese Telefonnummer aktivieren möchten, fügen Sie den --deletion-protection-enabled Parameter hinzu. Der Löschschutz ist standardmäßig deaktiviert. Wenn der Löschschutz aktiviert ist, können Sie die Telefonnummer nicht mit der ReleasePhoneNumber API löschen, es sei denn, Sie aktualisieren die Konfiguration der Telefonnummer, um diese Funktion zu deaktivieren.

    • Ersetzen Sie optOutListName durch den Namen oder ARN der Opt-Out-Liste, die Sie der Telefonnummer zuordnen möchten. Dieser Parameter ist optional. Wenn Sie die Telefonnummer nicht mit einer Opt-Out-Liste verknüpfen möchten, lassen Sie diesen Parameter weg.

    • Wenn Sie eine Telefonnummer für eine 10DLC-Kampagne anfordern, ersetzen Sie CO123EX durch die ID der 10DLC-Kampagne, die Sie verwenden möchten.

      Anmerkung

      Wenn Sie eine 10DLC-Telefonnummer verwenden möchten, müssen Sie Ihr Unternehmen und Ihre Kampagne registrieren. Derzeit besteht die einzige Möglichkeit, diese Registrierungsprozesse abzuschließen, darin, die Amazon Pinpoint-SMS-Konsole zu verwenden. Weitere Informationen zur 10DLC-Registrierung finden Sie unter 10DLC-Registrierungsprozess.

Wenn die Nummer erfolgreich zu Ihrem Konto hinzugefügt wurde, wird Ihnen eine Ausgabe ähnlich der folgenden angezeigt:

{
    "PhoneNumberArn": "arn:aws:sms-voice:us-east-1:111122223333:phone-number/phone-615790209ea34aea8da9b729fexample",
    "PhoneNumberId": "phone-615790209ea34aea8da9b729fexample",
    "PhoneNumber": "+12045550123",
    "Status": "PENDING",
    "IsoCountryCode": "CA",
    "MessageType": "TRANSACTIONAL",
    "NumberCapabilities": [
        "SMS"
    ],
    "NumberType": "LONG_CODE",
    "MonthlyLeasingPrice": "1.00",
    "TwoWayEnabled": false,
    "SelfManagedOptOutsEnabled": false,
    "OptOutListName": "Default",
    "DeletionProtectionEnabled": false,
    "CreatedTimestamp": 1645568542.0
}
Anmerkung

Wenn Sie zum ersten Mal eine Telefonnummer kaufen, ist der Wert des Status-Attributs PENDING. Wenn die Telefonnummer einsatzbereit ist, ändert sich der Wert von Status auf ACTIVE.

Wenn eine Telefonnummer, die den von Ihnen angegebenen Parametern entspricht, nicht verfügbar ist, schlägt die Anfrage mit einem Fehler fehl.

Modify phone number capabilities (AWS CLI)

Nachdem Sie eine Telefonnummer angefordert haben, können Sie die update-phone-number CLI verwenden, um die Einstellungen dieser Telefonnummer zu ändern oder zusätzliche Funktionen zu aktivieren. Sie können mehrere Telefonnummerneinstellungen ändern, darunter den Pool und die Opt-Out-Liste, die mit der Telefonnummer verknüpft sind, sowie die Einstellung für den Löschschutz.

Ein Beispiel für ein zusätzliches Feature, das Sie durch die Aktualisierung einer Telefonnummer aktivieren können, ist die bidirektionale Nachrichtenübermittlung. Die Unterstützung für bidirektionales Versenden von Nachrichten hängt davon ab, in welches Land Sie Nachrichten senden möchten. Eine Liste der unterstützten Länder finden Sie unter Unterstützte Länder und Regionen (SMS-Kanal).

$ aws pinpoint-sms-voice-v2 update-phone-number \
> --phone-number-id phone-d2b0f5dd4fd14ebdb2a3b9128example \
> --deletion-protection-enabled true \
> --opt-out-list-name optOutListName \ 
> --self-managed-opt-outs-enabled true \
> --two-way-enabled true \
> --two-way-channel-arn arn:aws:sns:us-east-1:111122223333:MyTopic

Gehen Sie im vorhergehenden Befehl wie folgt vor:

  • Ersetzen Sie phone-d2b0f5d4fd14ebdb2a3b9128example durch die PhoneNumberID oder den Amazon-Ressourcennamen (ARN) der Telefonnummer, die Sie aktualisieren möchten. Sie können beide Werte mithilfe der DescribePhoneNumbers-Operation finden.

  • Ersetzen Sie optOutListName durch den Namen der Opt-Out-Liste, die Sie dieser Telefonnummer zuordnen möchten.

  • Wenn Sie das Feature zum Löschschutz deaktivieren möchten, ändern Sie den Wert des DeletionProtectionEnabled-Parameters in false.

  • Wenn Sie die Funktion zur Selbstverwaltung von SMS-Opt-Outs verwenden möchten, ändern Sie den Wert des SelfManagedOptOutsEnabled Parameters in false.

  • Wenn Sie bidirektionale SMS-Nachrichten für diese Telefonnummer deaktivieren möchten, ändern Sie den Wert des TwoWayEnabled Parameters in false.

  • Wenn Sie das Feature für bidirektionale Nachrichtenfunktion für die Telefonnummer aktivieren, müssen Sie den ARN eines Amazon-SNS-Themas angeben. Ersetzen Sie arn:aws:sns:us-east-1:111122223333:MyTopic durch den ARN des Amazon SNS-Themas, das Sie verwenden möchten. Wenn Sie eingehende Nachrichten erhalten, werden diese an das von Ihnen angegebene Thema gesendet.

Der PhoneNumberId-Parameter ist der einzige erforderliche Parameter für diesen Befehl. Sie können jeden der anderen Parameter weglassen, wenn Sie die entsprechenden Einstellungen nicht ändern möchten.

List phone numbers (AWS CLI)

Sie können die verwendendescribe-phone-numbers, um weitere Informationen zu den Ursprungstelefonnummern in Ihrem Amazon Pinpoint-Konto zu erhalten.

So listen Sie alle Telefonnummern in Ihrem Konto mithilfe der auf AWS CLI

  • Geben Sie in der Befehlszeile folgenden Befehl ein:

    $ aws pinpoint-sms-voice-v2 describe-phone-numbers

Die Ausgabe dieses Befehls enthält Details zu allen Telefonnummern in Ihrem Konto. Sie können auch Informationen zu bestimmten Telefonnummern anzeigen, indem Sie den PhoneNumberId-Parameter angeben.

So zeigen Sie Informationen zu einer bestimmten Telefonnummer mithilfe der an AWS CLI

  • Geben Sie in der Befehlszeile folgenden Befehl ein:

    $ aws pinpoint-sms-voice-v2 describe-phone-numbers \
>  --phone-number-id phone-d2b0f5dd4fd14ebdb2a3b9128example

Ersetzen Sie im vorherigen Beispiel phone-d2b0f5d4fd14ebdb2a3b9128example durch die PhoneNumberID oder den Amazon-Ressourcennamen (ARN) der Telefonnummer, zu der Sie weitere Informationen anzeigen möchten.

Sie können den filter-Parameter auch verwenden, um die Liste der Telefonnummern anhand von Kriterien zu filtern, die Sie definieren. Sie können beispielsweise nach dem Land der Telefonnummer oder nach ihren Funktionen (d. h. ob sie SMS oder Sprachnachrichten oder beides unterstützt) filtern.

So zeigen Sie eine gefilterte Liste von Telefonnummern mit der an AWS CLI

  • Geben Sie in der Befehlszeile folgenden Befehl ein:

    $ aws pinpoint-sms-voice-v2 describe-phone-numbers \
> --filters Name=number-capability,Values=SMS \
> --filters Name=iso-country-code,Values=CA

Beim Filter Name kann es sich um einen den folgenden Werte handeln:

  • status: Der aktuelle Status der Telefonnummer, z. B. ACTIVE.

  • iso-country-code: Der zweistellige ISO-3166-Alpha-2-Code des Landes der Telefonnummer.

  • message-type: Die Art der Nachrichten, für deren Versand die Telefonnummer verwendet wird. Die möglichen Wert sind TRANSACTIONAL oder PROMOTIONAL.

  • number-capability: Die Nachrichtenkanäle, die die Telefonnummer unterstützt. Mögliche Werte sind SMS und VOICE.

  • number-type: Die Art der Telefonnummer, z. B. LONG_CODE, SHORT_CODE oder TOLL_FREE.

  • two-way-enabled: Ein boolescher Wert, der angibt, ob bidirektionaler SMS-Versand aktiviert ist oder nicht.

  • self-managed-opt-outs-enabled: Ein boolescher Wert, der angibt, ob selbstverwaltete SMS-Opt-Outs aktiviert sind oder nicht.

  • opt-out-list-name: Der Name der Opt-Out-Liste, die der Telefonnummer zugeordnet ist.

  • deletion-protection-enabled: Ein boolescher Wert, der angibt, ob die Telefonnummer mithilfe der DeletePhoneNumber-Operation gelöscht werden kann oder nicht.

Themen

Telefonnummernstatus

Wenn Sie zum ersten Mal eine Telefonnummer kaufen, lautet der Status Nummer der Telefonnummer PENDING. Wenn die Telefonnummer einsatzbereit ist, lautet der Status der Telefonnummer ACTIVE. Wenn die Telefonnummer eine Registrierung erfordert, muss dies abgeschlossen sein, bevor der Status Nummer der Telefonnummer in geändert wirdACTIVE.

Telefonnummernstatus

  1. Öffnen Sie die Amazon-Pinpoint-SMS-Konsole unter https://console.aws.amazon.com/sms-voice/.

  2. Wählen Sie im Navigationsbereich unter Konfigurationen die Option Telefonnummern.

  3. In den Telefonnummern wird der Telefonnummernstatus in der Spalte Nummernstatus aufgeführt.

    • PENDING – Die Telefonnummer ist nicht einsatzbereit. Möglicherweise müssen Sie die Telefonnummer registrieren. Weitere Informationen finden Sie unter Anmeldungen.

    • ACTIVE – Die Telefonnummer ist einsatzbereit.