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
<a name="notify-getting-started"></a>

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
<a name="notify-getting-started-prereqs"></a>
+ Ein AWS-Konto.
+ IAM-Berechtigungen für SMS-Vorgänge mit AWS Endbenutzer-Messaging. Weitere Informationen finden Sie unter [Identitäts- und Zugriffsmanagement für AWS Endbenutzer-Messaging-SMS](security-iam.md).

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 (wie`SendNotifyTextMessage`,`SendNotifyVoiceMessage`,`DescribeNotifyConfigurations`, `CreateNotifyConfiguration``UpdateNotifyConfiguration`, und`DeleteNotifyConfiguration`). Für Aktionen, die keine Berechtigungen auf Ressourcenebene unterstützen (wie`DescribeNotifyTemplates`,,, und) `ListNotifyCountries` `SetNotifyMessageSpendLimitOverride``DeleteNotifyMessageSpendLimitOverride`, ist Folgendes erforderlich. `PutMessageFeedback` `"Resource": "*"`

## Schritt 1: Erstellen Sie eine Notify-Konfiguration
<a name="notify-getting-started-create"></a>

------
#### [ Console ]

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

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

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

1. Geben Sie **unter Anzeigename** Ihren Markennamen ein (z. B.`AcmeCorp`).

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

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

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

1. 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:

PENDING  
Die Konfiguration wird überprüft.

ACTIVE  
Bereit zum Senden von Nachrichten.

REQUIRES\_VERIFICATION  
Der Markenname muss vor der Aktivierung überprüft werden.

ABGELEHNT  
Die Konfiguration wurde abgelehnt. Suchen Sie `RejectionReason` nach Einzelheiten.

## Schritt 2: Verfügbare Vorlagen durchsuchen
<a name="notify-getting-started-templates"></a>

Ü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
<a name="notify-getting-started-send"></a>

------
#### [ Console ]

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

1. Wählen Sie die Registerkarte **Test**.

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

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

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

1. 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
<a name="notify-getting-started-countries"></a>

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
<a name="notify-getting-started-next"></a>
+ [Notify-Konfigurationen verwalten](notify-configurations.md)— Erfahre mehr über alle Konfigurationsoptionen.
+ [Mit Notify-Vorlagen arbeiten](notify-templates.md)— Durchsuchen und verstehen Sie die verfügbaren Vorlagen.
+ [Stufen benachrichtigen](notify-tiers.md)— Erfahren Sie mehr über die Stufen und erfahren Sie, wie Sie ein Upgrade auf Advanced durchführen können.
+ [Ausgabenlimits benachrichtigen](notify-spend-limits.md)— Verwalte deine Notify-Ausgabenlimits.