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.

Erste Schritte mit Notify

In diesem Tutorial erfahren Sie, wie Sie eine Notify-Konfiguration erstellen und Ihre erste OTP-Nachricht senden. Sie können dieses Tutorial in etwa 5 Minuten abschließen.

Voraussetzungen

Die folgende IAM-Richtlinie gewährt Berechtigungen zum Senden von Nachrichten und zum Durchsuchen von Vorlagen:

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "sms-voice:SendNotifyTextMessage",
                "sms-voice:SendNotifyVoiceMessage",
                "sms-voice:DescribeNotifyTemplates",
                "sms-voice:DescribeNotifyConfigurations",
                "sms-voice:ListNotifyCountries",
                "sms-voice:PutMessageFeedback"
            ],
            "Resource": "*"
        }
    ]
}

Die folgende Richtlinie gewährt vollständige Benachrichtigungsverwaltungsberechtigungen:

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "sms-voice:CreateNotifyConfiguration",
                "sms-voice:UpdateNotifyConfiguration",
                "sms-voice:DeleteNotifyConfiguration",
                "sms-voice:DescribeNotifyConfigurations",
                "sms-voice:DescribeNotifyTemplates",
                "sms-voice:ListNotifyCountries",
                "sms-voice:SendNotifyTextMessage",
                "sms-voice:SendNotifyVoiceMessage",
                "sms-voice:SetNotifyMessageSpendLimitOverride",
                "sms-voice:DeleteNotifyMessageSpendLimitOverride",
                "sms-voice:PutMessageFeedback"
            ],
            "Resource": "*"
        }
    ]
}

Um die Berechtigungen auf eine bestimmte Notify-Konfiguration zu beschränken, verwenden Sie den Konfigurations-ARN für Aktionen auf Ressourcenebene (wieSendNotifyTextMessage,SendNotifyVoiceMessage,DescribeNotifyConfigurations, CreateNotifyConfigurationUpdateNotifyConfiguration, undDeleteNotifyConfiguration). Für Aktionen, die keine Berechtigungen auf Ressourcenebene unterstützen (wieDescribeNotifyTemplates,,, und) ListNotifyCountries SetNotifyMessageSpendLimitOverrideDeleteNotifyMessageSpendLimitOverride, ist Folgendes erforderlich. PutMessageFeedback "Resource": "*"

Schritt 1: Erstellen Sie eine Notify-Konfiguration

Console

1. Öffnen Sie die SMS-Konsole für AWS Endbenutzernachrichten unter https://console.aws.amazon.com/sms-voice/.

2. Wählen Sie im Navigationsbereich unter Notify die Option Notify configurations aus.

3. Wählen Sie „Notify-Konfiguration erstellen“ aus.

4. Geben Sie unter Anzeigename Ihren Markennamen ein (z. B.AcmeCorp).

5. Für den Anwendungsfall ist die Codeverifizierung automatisch ausgewählt.

6. Wählen Sie für Kanäle die Option SMS, VOICE oder beides aus.

7. (Optional) Erweitern Sie Erweiterte Einstellungen, um Länder, eine Standardvorlage oder einen zugehörigen Pool auszuwählen oder den Löschschutz zu aktivieren.

8. Wählen Sie „Notify-Konfiguration erstellen“.

Ihre Konfiguration wird mit dem Status Ausstehend erstellt, während das System Ihr Konto validiert. Nach der Validierung ändert sich der Status in Aktiv und Sie können mit dem Senden von Nachrichten beginnen.

Anmerkung

Die Konfigurationserstellung umfasst die automatische Kontovalidierung und die Überprüfung von Markennamen. Die meisten Konfigurationen werden innerhalb von Sekunden aktiviert. Wenn Ihr Markenname verifiziert werden muss, lautet der Status „Überprüfung erforderlich“.

AWS CLI

aws pinpoint-sms-voice-v2 create-notify-configuration \
    --display-name "AcmeCorp" \
    --use-case CODE_VERIFICATION \
    --enabled-channels SMS

Status der Konfiguration:

Schritt 2: Verfügbare Vorlagen durchsuchen

Überprüfe vor dem Senden, welche Vorlagen für deine Stufe und deinen Kanal verfügbar sind:

aws pinpoint-sms-voice-v2 describe-notify-templates \
    --filters '[{"Name":"channels","Values":["SMS"]},{"Name":"tier-access","Values":["BASIC"]}]'

Schritt 3: Senden Sie eine Testnachricht

Console

1. Wählen Sie in der Liste mit den Benachrichtigungskonfigurationen Ihre Konfiguration aus.

2. Wählen Sie die Registerkarte Test.

3. Wählen Sie eine Vorlage aus der Vorlagentabelle aus.

4. Geben Sie für Zieltelefonnummer eine Telefonnummer im E.164-Format ein (z. B.+12065550100).

5. Füllen Sie die Vorlagenvariablen aus (geben Sie sie beispielsweise 123456 für die Codevariable ein).

6. Wählen Sie Send (Senden) aus.

AWS CLI

aws pinpoint-sms-voice-v2 send-notify-text-message \
    --notify-configuration-id "nc-1234567890abcdef0" \
    --destination-phone-number "+12065550100" \
    --template-id "notify-code-verification-english-001" \
    --template-variables '{"code":"123456"}'

Python (boto3)

import boto3

client = boto3.client('pinpoint-sms-voice-v2')

response = client.send_notify_text_message(
    NotifyConfigurationId='nc-1234567890abcdef0',
    DestinationPhoneNumber='+12065550100',
    TemplateId='notify-code-verification-english-001',
    TemplateVariables={
        'code': '123456'
    }
)

print(f"Message ID: {response['MessageId']}")
print(f"Resolved body: {response['ResolvedMessageBody']}")

Schritt 4: Überprüfen Sie die verfügbaren Länder

Hier ListNotifyCountries erfährst du, welche Länder für deine Stufe und deinen Kanal verfügbar sind:

aws pinpoint-sms-voice-v2 list-notify-countries \
    --channels SMS \
    --tier BASIC

Nächste Schritte