**Hinweis zum Ende des Supports:** Am 30. Oktober 2026 AWS wird der Support für Amazon Pinpoint eingestellt. Nach dem 30. Oktober 2026 können Sie nicht mehr auf die Amazon-Pinpoint-Konsole oder die Amazon-Pinpoint-Ressourcen (Endpunkte, Segmente, Kampagnen, Journeys und Analytik) zugreifen. Weitere Informationen finden Sie unter [Ende des Amazon-Pinpoint-Supports](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Hinweis:** APIs In Bezug auf SMS sind Sprach-, mobile Push-, OTP- und Telefonnummernvalidierung von dieser Änderung nicht betroffen und werden von AWS End User Messaging unterstützt.

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.

# Tutorials
<a name="tutorials"></a>

Die Tutorials in diesem Abschnitt sollen neuen Amazon-Pinpoint-Benutzern zeigen, wie man einige wichtige Aufgaben erledigt. Wenn Amazon Pinpoint für Sie neu ist, oder wenn Sie nur mit bestimmten Funktionen nicht vertraut sind, sind diese Tutorials ein guter Ausgangspunkt.

Die Tutorials in diesem Handbuch umfassen Aufgaben, die sich an Entwickler oder Systemadministratoren richten. In diesen Tutorials erfahren Sie, wie Sie Aufgaben mithilfe der Amazon Pinpoint Pinpoint-API AWS SDKs, der und der AWS CLI ausführen. 

**Topics**
+ [Verwenden von Postman mit Amazon Pinpoint](tutorials-using-postman.md)
+ [Richten Sie ein SMS-Registrierungssystem ein](tutorials-two-way-sms.md)

# Tutorial: Verwenden von Postman mit der Amazon-Pinpoint-API
<a name="tutorials-using-postman"></a>

Postman ist ein beliebtes Tool zum Testen APIs in einer easy-to-use grafischen Umgebung. Sie können mit Postman API-Anfragen an eine REST-API senden und Antworten auf Ihre Anfragen empfangen. Postman bietet eine bequeme Möglichkeit, die Aufrufe an die Amazon-Pinpoint-API zu testen und Fehler zu beheben. Dieses Tutorial behandelt Verfahren zur Einrichtung und Verwendung von Postman mit Amazon Pinpoint.

**Anmerkung**  
Postman wird von einem Drittanbieter entwickelt. Es wird von Amazon Web Services (AWS) nicht entwickelt oder unterstützt. Weitere Informationen zur Verwendung von Postman oder Hilfe bei Problemen im Zusammenhang mit Postman erhalten Sie im [Support Center](https://support.postman.com/hc/en-us) auf der Postman-Website.

## Über dieses Tutorial
<a name="tutorials-using-postman-about"></a>

Dieser Abschnitt enthält einen Überblick über dieses Tutorial.

**Zielgruppe**  
Dieses Tutorial richtet sich an Entwickler und Systemimplementierer. Sie müssen nicht mit Amazon Pinpoint oder Postman vertraut sein, um die Schritte in diesem Tutorial ausführen zu können. Sie sollten mit der Verwaltung von IAM-Richtlinien und der Änderung von JSON-Codebeispielen vertraut sein.

Die Verfahren in diesem Tutorial wurden entwickelt, um zu verhindern, dass neue Benutzer API-Operationen verwenden, die Amazon-Pinpoint-Ressourcen dauerhaft löschen können. Fortgeschrittene Benutzer können diese Einschränkung aufheben, indem sie die Richtlinie ändern, die ihren -Benutzern zugeordnet ist.

**Verwendete Funktionen**  
Dieses Tutorial enthält Anwendungsbeispiele für das folgende Amazon-Pinpoint-Feature:
+ Interaktion mit der Amazon-Pinpoint-API mithilfe von Postman

**Benötigte Zeit**  
Es sollte etwa 15 Minuten dauern, bis Sie dieses Tutorial abgeschlossen haben.

**Regionale Einschränkungen**  
Es sind keine regionalen Einschränkungen mit der Nutzung dieser Lösung verbunden.

**Kosten der Ressourcennutzung**  
Die Erstellung eines AWS Kontos ist kostenlos. Durch die Implementierung dieser Lösung können Ihnen jedoch AWS Nutzungskosten entstehen, wenn Sie Postman für eine der folgenden Aufgaben verwenden:
+ Senden von Nachrichten per E-Mail, SMS, Mobile Push oder Voice
+ Erstellen und Senden von Kampagnen
+ Verwenden der Funktion zur Telefonnummernüberprüfung

Weitere Informationen zu den Gebühren, die mit der Nutzung von Amazon Pinpoint verbunden sind, finden Sie unter [Amazon Pinpoint – Preise](https://aws.amazon.com/pinpoint/pricing/).

# Voraussetzungen für die Verwendung von Postman mit Amazon Pinpoint
<a name="tutorials-using-postman-prerequisites"></a>

Bevor Sie mit diesem Tutorial beginnen, müssen Sie die folgenden Voraussetzungen erfüllen:
+ Sie müssen ein AWS Konto haben. Um ein AWS Konto zu erstellen, gehen Sie zu [https://console.aws.amazon.com/](https://console.aws.amazon.com/)und wählen Sie **Neues AWS Konto erstellen**.
+ Stellen Sie sicher, dass das Konto, mit dem Sie sich anmelden, neue IAM-Richtlinien und -Rollen erstellen AWS-Managementkonsole kann.
+ Stellen Sie sicher, dass Sie mindestens ein Beispielprojekt erstellt haben, für das E-Mail aktiviert ist und für das eine verifizierte E-Mail-Identität vorliegt. Weitere Informationen finden Sie unter [Erstellen eines Amazon-Pinpoint-Projekts mit E-Mail-Unterstützung](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) im *Amazon-Pinpoint-Benutzerhandbuch*.
+ Stellen Sie sicher, dass Sie eine AWS Konto-ID haben. Ihre AWS Konto-ID finden Sie in der oberen rechten Ecke der Konsole oder Sie können die Befehlszeilenschnittstelle (CLI) verwenden. Weitere Informationen findest du unter [Deine AWS Konto-ID finden](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId).
+ Sie müssen Postman herunterladen und auf Ihrem Computer installieren. Sie können Postman von der [Postman-Website](https://www.getpostman.com) herunterladen.
+ Nachdem Sie Postman auf Ihrem Computer installiert haben, müssen Sie ein Postman-Konto erstellen. Wenn Sie die Postman-Anwendung zum ersten Mal starten, werden Sie aufgefordert, sich anzumelden oder ein neues Konto zu erstellen. Folgen Sie den Anweisungen von Postman, um sich bei Ihrem Konto anzumelden oder ein Konto zu erstellen, sofern Sie noch kein Konto haben.

**Weiter**: [Erstellen von IAM-Richtlinien und -Rollen](tutorials-using-postman-iam-user.md)

# Erstellen Sie IAM-Richtlinien und -Rollen für die Verwendung mit Amazon Pinpoint
<a name="tutorials-using-postman-iam-user"></a>

Wenn Sie Postman verwenden, um die Amazon-Pinpoint-API zu testen, besteht der erste Schritt darin, einen Benutzer zu erstellen. In diesem Abschnitt erstellen Sie eine Richtlinie, die es Benutzern erlaubt, mit allen Amazon-Pinpoint-Ressourcen zu interagieren. Anschließend erstellen Sie einen Benutzer und fügen die Richtlinie direkt an den Benutzer an.

## Eine IAM-Richtlinie erstellen
<a name="tutorials-using-postman-iam-user-create-policy"></a>

Erfahren Sie mehr dazu, wie Sie eine IAM-Richtlinie erstellen. Benutzer und Rollen, die diese Richtlinie verwenden, können mit allen Ressourcen in der Amazon-Pinpoint-API interagieren. Sie bietet auch Zugriff auf Ressourcen, die mit der Amazon-Pinpoint-E-Mail-API sowie der Amazon-Pinpoint-SMS- und Sprachnachrichten-API verknüpft sind.

**So erstellen Sie die Richtlinie**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)

1. Wählen Sie im Navigationsbereich **Richtlinien** und dann **Richtlinie erstellen**.

1. Wählen Sie im **Policy-Editor** **JSON** aus. Löschen Sie alle JSON-Dateien, die im **Richtlinieneditor** aktuell sind, sodass sie leer sind. Kopieren Sie den folgenden JSON-Code und fügen Sie ihn in den **Policy-Editor** ein. Ersetzen Sie dann im **Policy-Editor** alle Instanzen von *123456789012* durch Ihre AWS-Konto ID.

   Ihre AWS-Konto ID finden Sie in der oberen rechten Ecke der Konsole, oder Sie können die CLI verwenden, siehe [Ihre AWS Konto-ID finden](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId).
**Anmerkung**  
Zum Schutz der Daten in Ihrem Amazon-Pinpoint-Konto umfasst diese Richtlinie nur Berechtigungen, die Ihnen erlauben, Ressourcen zu lesen, zu erstellen und zu ändern. Sie beinhaltet nicht die Berechtigung, Ressourcen zu löschen. Sie können diese Richtlinie mithilfe des visuellen Editors in der IAM-Konsole ändern. Weitere Informationen finden Sie unter [Verwalten der IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) im IAM-Benutzerhandbuch. Sie können diese Richtlinie auch mithilfe des [CreatePolicyVersion](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreatePolicyVersion.html)Vorgangs in der IAM-API aktualisieren.  
Diese Richtlinie umfasst auch Berechtigungen, die Ihnen erlauben, mit den Services `ses` und `sms-voice` zu interagieren, zusätzlich zum Service `mobiletargeting`. Die Berechtigungen `ses` und `sms-voice` ermöglichen Ihnen die Interaktion mit der Amazon-Pinpoint-E-Mail-API bzw. der Amazon-Pinpoint-SMS- und Sprachnachrichten-API. Die `mobiletargeting`-Berechtigungen ermöglichen Ihnen die Interaktion mit der Amazon-Pinpoint-API.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Sid": "VisualEditor0",
               "Effect": "Allow",
               "Action": [
                   "mobiletargeting:Update*",
                   "mobiletargeting:Get*",
                   "mobiletargeting:Send*",
                   "mobiletargeting:Put*",
                   "mobiletargeting:Create*"
               ],
               "Resource": [
                   "arn:aws:mobiletargeting:*:123456789012:apps/*",
                   "arn:aws:mobiletargeting:*:123456789012:apps/*/campaigns/*",
                   "arn:aws:mobiletargeting:*:123456789012:apps/*/segments/*"
               ]
           },
           {
               "Sid": "VisualEditor1",
               "Effect": "Allow",
               "Action": [
                   "mobiletargeting:TagResource",
                   "mobiletargeting:PhoneNumberValidate",
                   "mobiletargeting:ListTagsForResource",
                   "mobiletargeting:CreateApp"
               ],
               "Resource": "arn:aws:mobiletargeting:*:123456789012:*"
           },
           {
               "Sid": "VisualEditor2",
               "Effect": "Allow",
               "Action": [
                   "ses:TagResource",
                   "ses:Send*",
                   "ses:Create*",
                   "ses:Get*",
                   "ses:List*",
                   "ses:Put*",
                   "ses:Update*",
                   "sms-voice:SendVoiceMessage",
                   "sms-voice:List*",
                   "sms-voice:Create*",
                   "sms-voice:Get*",
                   "sms-voice:Update*"
               ],
               "Resource": "*"
           }
       ]
   }
   ```

------

   Wählen Sie **Weiter** aus.

1. Geben Sie **unter Richtlinienname** einen Namen für die Richtlinie ein, z. B. **PostmanAccessPolicy** Wählen Sie **Richtlinie erstellen** aus.

1. (Optional) Sie können der Richtlinie Tags hinzufügen, indem Sie **Tag hinzufügen** auswählen.

1. Wählen Sie **Weiter: Prüfen** aus.

## Erstellen eines IAM-Benutzers
<a name="tutorials-using-postman-iam-user-create-user"></a>

**Warnung**  
IAM-Benutzer verfügen über langfristige Anmeldeinformationen, was ein Sicherheitsrisiko darstellt. Um dieses Risiko zu minimieren, empfehlen wir, diesen Benutzern nur die Berechtigungen zu gewähren, die sie für die Ausführung der Aufgabe benötigen, und diese Benutzer zu entfernen, wenn sie nicht mehr benötigt werden.

Nachdem Sie die Richtlinie erstellt haben, können Sie einen Benutzer erstellen und die Richtlinie an diesen anhängen. Wenn Sie den Benutzer erstellen, stellt Ihnen IAM einen Satz von Anmeldeinformationen bereit, mit dem Sie Postman erlauben können, Amazon-Pinpoint-API-Operationen auszuführen.

**So erstellen Sie den Benutzer**

1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole.

1. Wählen Sie auf der IAM-Konsole im Navigationsbereich **Benutzer** und dann **Benutzer erstellen** aus.

1. Geben Sie unter **Benutzerdetails** für **Benutzername** einen eindeutigen Namen für den Benutzer ein, z. B. **PostmanUser**. Klicken Sie anschließend auf **Weiter**.

1. Wählen Sie unter **Berechtigungen festlegen** für **Berechtigungsoptionen** die Option **Direktes Anfügen von Richtlinien** aus. 

1. Wählen Sie unter **Berechtigungsrichtlinien** die Richtlinie (**PostmanAccessPolicy**) aus, die Sie unter [IAM-Richtlinie erstellen](#tutorials-using-postman-iam-user-create-policy) erstellt haben. Klicken Sie anschließend auf **Weiter**.

1. Auf der Seite **Prüfen und erstellen** können Sie optional Tags hinzufügen, um Benutzer leichter zu identifizieren. Weitere Informationen zur Verwendung von Tags finden Sie unter [Markieren von IAM-Ressourcen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) im *IAM-Benutzerhandbuch*. 

1. Wenn Sie bereit sind, den Benutzer zu erstellen, wählen Sie **Create user (Benutzer erstellen)** aus.

## Zugriffsschlüssel erstellen
<a name="tutorials-using-postman-iam-user-create-key"></a>

**Warnung**  
Dieses Szenario erfordert IAM-Benutzer mit programmatischem Zugriff und langfristigen Anmeldeinformationen, was ein Sicherheitsrisiko darstellt. Um dieses Risiko zu minimieren, empfehlen wir, diesen Benutzern nur die Berechtigungen zu gewähren, die sie für die Ausführung der Aufgabe benötigen, und diese Benutzer zu entfernen, wenn sie nicht mehr benötigt werden. Die Zugriffsschlüssel können bei Bedarf aktualisiert werden. Weitere Informationen finden Sie unter [Zugriffsschlüssel aktualisieren](https://docs.aws.amazon.com/IAM/latest/UserGuide/id-credentials-access-keys-update.html) im *IAM-Benutzerhandbuch*.

 IAM stellt einen Satz von Anmeldeinformationen bereit, mit dem Sie Postman erlauben können, Amazon-Pinpoint-API-Operationen auszuführen.

**So erstellen Sie den Benutzer**

1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole.

1. Wählen Sie im Navigationsbereich der IAM-Konsole **Benutzer** aus. Wählen Sie den Benutzer (**PostmanUser**) aus, der unter [Einen IAM-Benutzer erstellen](#tutorials-using-postman-iam-user-create-user) erstellt wurde, und wählen Sie dann die Registerkarte **Sicherheitsanmeldeinformationen** aus.

1. Wählen Sie im Abschnitt **Zugriffsschlüssel** die Option **Zugriffsschlüssel erstellen** aus.

1. Wählen Sie auf der Seite **Zugriff auf die wichtigsten bewährten Methoden und Alternativen** die Option **Anwendung wird außerhalb AWS ausgeführt** aus. 

   Klicken Sie anschließend auf **Weiter**.

1. (Optional) Sie können der Richtlinie ein Beschreibungs-Tag hinzufügen.

1. Wählen Sie **Zugriffsschlüssel erstellen** aus.

1. Kopieren Sie auf der Seite **Zugriffsschlüssel abrufen** die Anmeldeinformationen, die in den Spalten **Zugriffsschlüssel** und **Geheimer Zugriffsschlüssel** angezeigt werden.
**Anmerkung**  
Sie müssen sowohl die Zugriffsschlüssel-ID als auch den geheimen Zugriffsschlüssel in einem späteren Schritt in diesem Tutorial angeben. Dies ist das einzige Mal, dass Sie den geheimen Zugriffsschlüssel anzeigen können. Wir empfehlen Ihnen, dass Sie ihn kopieren und an einem sicheren Ort speichern.

1. Nachdem Sie beide Schlüssel gespeichert haben, wählen Sie **Fertig** aus.

**Nächster Schritt**: [Einrichten von Postman](tutorials-using-postman-configuration.md)

# Postman für die Verwendung mit Amazon Pinpoint einrichten
<a name="tutorials-using-postman-configuration"></a>

Nachdem Sie jetzt einen Benutzer erstellt haben, das auf die Amazon-Pinpoint-API zugreifen kann, können Sie Postman einrichten. In diesem Abschnitt erstellen Sie eine oder mehrere Umgebungen in Postman. Als nächstes importieren Sie eine Sammlung, die für jeden der Vorgänge in der Amazon-Pinpoint-API eine Vorlage für Anfragen enthält.

## Erstellen Sie einen Postman-Arbeitsbereich
<a name="tutorials-using-postman-configuration-create-workspace"></a>

In Postman ist ein *Workspace* ein organisatorischer Container für Projekte und Umgebungen. In diesem Abschnitt erstellen Sie mindestens einen Workspace zur Verwendung mit Amazon Pinpoint.

**Einen Workspace erstellen**

Wählen Sie in Postman die weiteren Aktionen **Datei** und dann **Neu** aus.

1. Wählen Sie im Fenster **Neu erstellen** die Option **Workspace** aus.

1. Geben Sie einen Namen und eine Zusammenfassung ein und setzen Sie die Sichtbarkeit auf „Persönlich“. Wählen Sie dann **Workspace erstellen** aus.

## Erstellen Sie Postman-Umgebungen
<a name="tutorials-using-postman-configuration-create-environments"></a>

In Postman ist eine *Umgebung* ein Satz von Variablen, die als Schlüssel-Wert-Paare gespeichert werden. Sie können Umgebungen nutzen, um die Konfiguration der Anfragen, die Sie über Postman stellen, zu ändern, ohne die API-Anfragen selbst ändern zu müssen.

In diesem Abschnitt erstellen Sie mindestens eine Umgebung, die Sie mit Amazon Pinpoint verwenden können. Jede Umgebung, die Sie erstellen, enthält einen Satz von Variablen, die spezifisch für Ihr Konto in einer einzigen AWS-Region sind. Wenn Sie die Verfahren in diesem Abschnitt verwenden, um mehr als eine Umgebung zu erstellen, können Sie zwischen den Regionen wechseln, indem Sie eine andere Umgebung aus dem Menü **Umgebung** in Postman auswählen.

**So erstellen Sie eine Umgebung**

1. Wählen Sie in Postman die weiteren Aktionsmenüs **Datei** und dann **Neu** aus.

1. Wählen Sie im Fenster **Create New (Neu erstellen)** die Option **Environment (Umgebung)** aus.

1. Geben Sie im Fenster **MANAGE ENVIRONMENTS (Umgebungen verwalten)** unter **Environment Name (Name der Umgebung)** **Amazon Pinpoint - *Region Name*** ein. *Region Name*Ersetzen Sie durch einen der folgenden Werte:
   + USA Ost (Nord-Virginia)
   + USA West (Oregon)
   + Asien-Pazifik (Mumbai)
   + Asien-Pazifik (Sydney)
   + Europe (Frankfurt)
   + Europa (Irland)
**Anmerkung**  
Sie müssen mindestens eine Umgebung für ein einzelnes Projekt erstellen AWS-Region, und diese AWS-Region muss ein Projekt enthalten. Wenn Sie kein Projekt in einem der zuvor aufgelisteten Projekte erstellt haben AWS-Regionen, finden Sie weitere Informationen unter [Erstellen eines Amazon Pinpoint Pinpoint-Projekts mit E-Mail-Support](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) im *Amazon Pinpoint Pinpoint-Benutzerhandbuch*.

1. Erstellen Sie sechs neue Variablen: `endpoint`, `region`, `serviceName`, `accountId`, `accessKey` und `secretAccessKey`. Verwenden Sie die folgende Tabelle, um zu bestimmen, welcher Wert in die Spalten **Anfangswert** und **Aktueller Wert** für jede Variable eingegeben werden soll.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/tutorials-using-postman-configuration.html)

   Nachdem Sie diese Variablen erstellt haben, ähnelt das Fenster **MANAGE ENVIRONMENTS (Umgebungen verwalten)** dem Beispiel in der folgenden Abbildung.  
![\[\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/Postman_Tutorial_2.1_4.png)

   Wählen Sie **Save (Speichern)** aus, wenn Sie fertig sind.
**Wichtig**  
Die Zugriffsschlüssel in der vorhergehenden Abbildung sind fiktiv. Geben Sie Ihre IAM-Zugriffsschlüssel nicht an andere weiter.  
Postman enthält Features, mit denen Sie Umgebungen gemeinsam nutzen und exportieren können. Wenn Sie diese Features verwenden, achten Sie darauf, dass Sie Ihre Zugriffsschlüssel-ID und Ihren geheimen Zugriffsschlüssel nicht an Personen weitergeben, die keinen Zugriff auf diese Zugangsdaten haben dürfen.  
Weitere Informationen finden Sie unter [Bewährte Methoden für IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) im *IAM-Benutzerhandbuch*.

1. (Optional) Wiederholen Sie die Schritte 1–4 für jede weitere Umgebung, die Sie erstellen möchten.
**Tipp**  
In Postman können Sie so viele Umgebungen erstellen, wie Sie benötigen. Sie können Umgebungen auf folgende Weisen verwenden:  
Erstellen Sie eine separate Umgebung für jede Region, in der Sie die Amazon-Pinpoint-API testen müssen.
Erstellen Sie Umgebungen, die mit verschiedenen AWS-Konten verknüpft sind.
Erstellen Sie Umgebungen, die Anmeldeinformationen verwenden, die mit anderen Benutzern verknüpft sind.

1. Wenn Sie mit der Erstellung von Umgebungen fertig sind, fahren Sie mit dem nächsten Abschnitt fort.

## Erstellen Sie eine Amazon Pinpoint-Sammlung in Postman
<a name="tutorials-using-postman-configuration-create-pinpoint-collection"></a>

In Postman ist eine *Sammlung* eine Gruppe von API-Anforderungen. Anfragen in einer Sammlung werden in der Regel durch einen gemeinsamen Zweck zusammengefasst. In diesem Abschnitt erstellen Sie eine neue Sammlung, die für jeden Vorgang in der Amazon-Pinpoint-API eine Vorlage für Anfragen enthält.

**So erstellen Sie die Amazon Pinpoint-Sammlung**

1. Wählen Sie in Postman die weiteren Aktionsmenüs **Datei** und dann **Importieren** aus.

1. Wählen Sie im Fenster **Import** die Option **Aus Link importieren** und geben Sie dann die folgende URL ein: [https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon](https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon%20Pinpoint.postman_collection.json) %20pinpoint.postman\$1collection.json. 

   Wählen Sie **Importieren** aus. Postman importiert die Amazon-Pinpoint-Sammlung, die 120 Beispielanfragen enthält.

## Testen Ihrer Postman-Konfiguration
<a name="tutorials-using-postman-configuration-test-operation"></a>

Nachdem Sie die Amazon-Pinpoint-Sammlung importiert haben, sollten Sie einen schnellen Test durchführen, um sicherzustellen, dass alle Komponenten richtig konfiguriert sind. Sie können Ihre Konfiguration testen, indem Sie eine `GetApps`-Anfrage senden. Diese Anfrage gibt eine Liste aller Projekte zurück, die in Ihrem Amazon-Pinpoint-Konto in der aktuellen AWS-Region-Region existieren. Diese Anfrage erfordert keine zusätzliche Konfiguration, daher ist es eine gute Möglichkeit, Ihre Konfiguration zu testen.

**So testen Sie die Konfiguration der Amazon-Pinpoint-Sammlung**

1. Wählen Sie im linken Navigationsbereich **Sammlungen** aus, erweitern Sie die **Amazon-Pinpoint**-Sammlung und erweitern Sie den **Apps**-Ordner.

1. **GetApps**Wählen Sie in der Liste der Anfragen.

1. Verwenden Sie die **Umgebungsauswahl**, um die Umgebung auszuwählen, die Sie in [Create Postman-Umgebungen](#tutorials-using-postman-configuration-create-environments) erstellt haben.

1. Wählen Sie **Send (Senden)** aus. Wenn die Anfrage erfolgreich gesendet wurde, zeigt der Antwortbereich den Status `200 OK` an. Sie sehen eine Antwort, die dem Beispiel in der folgenden Abbildung ähnelt.  
![\[\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/Postman_Tutorial_2.3_3.png)
**Anmerkung**  
Wenn Sie keine Projekte in der erstellt haben, AWS-Region kehrt Amazon Pinpoint zurück`{ "Item": [] }`.

   Diese Antwort zeigt eine Liste aller Amazon-Pinpoint-Projekte, die in Ihrem Konto in der Region existieren, die Sie in Schritt 3 ausgewählt haben.

### Fehlerbehebung
<a name="tutorials-using-postman-configuration-test-operation-troubleshooting"></a>

Wenn Sie Ihre Anfrage absenden, wird möglicherweise ein Fehler angezeigt. In der folgenden Liste finden Sie einige Fehler, die häufig auftreten können, und Hinweise auf Schritte, die Sie zur Behebung dieser Fehler ergreifen können.


| Fehlermeldung | Problem | Auflösung | 
| --- | --- | --- | 
|  Could not get any response (Konnte keine Antwort erhalten) Beim Herstellen einer Verbindung zu https://%7B%7Bendpoint%7D%7 D/v1/apps ist ein Fehler aufgetreten.  |  Es gibt keinen aktuellen Wert für die Variable `{{endpoint}}`, die gesetzt wird, wenn Sie eine Umgebung auswählen.  | Verwenden Sie das Umgebungsauswahlfeld zur Auswahl einer Umgebung. | 
|  Das Sicherheits-Token der Anfrage ist ungültig.  |  Postman konnte den aktuellen Wert Ihrer Zugriffsschlüssel-ID oder Ihres geheimen Zugriffsschlüssels nicht finden.  |  Wählen Sie das Zahnradsymbol neben dem Umgebungsauswahlfeld aus und wählen Sie dann die aktuelle Umgebung aus. Stellen Sie sicher, dass die Werte `accessKey` und `secretAccessKey` sowohl in den Spalten **ANFANGSWERT** als auch **AKTUELLER WERT** angezeigt werden und dass Sie die Anmeldeinformationen korrekt eingegeben haben.  | 
|  „Message“: „Der Benutzer: arn:aws:iam: :123456789012:user/ PinpointPostmanUser ist nicht berechtigt, Folgendes auszuführen: mobiletargeting: on resource: arn:aws:mobiletargeting:us-west- 2:123456789012: \$1“ GetApps   |  Die IAM-Richtlinie, die Ihrem Benutzer zugeordnet ist, enthält nicht die entsprechenden Berechtigungen.  |  [[Vergewissern Sie sich, dass Ihr Benutzer über die unter Erstellen einer IAM-Richtlinie beschriebenen Berechtigungen verfügt und dass Sie die richtigen Anmeldeinformationen angegeben haben, als Sie die Umgebung im Arbeitsbereich Postman erstellen erstellt haben.](#tutorials-using-postman-configuration-create-environments)](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy)  | 

**Nächster Schritt**: [Senden von zusätzlichen Anforderungen](tutorials-using-postman-sample-requests.md)

# Anfragen an die Amazon Pinpoint API senden
<a name="tutorials-using-postman-sample-requests"></a>

Wenn Sie die Konfiguration und den Test von Postman abgeschlossen haben, können Sie zusätzliche Anfragen an die Amazon-Pinpoint-API senden. Dieser Abschnitt enthält Informationen, die Sie kennen müssen, bevor Sie mit dem Senden von Anfragen beginnen. Es enthält auch zwei Beispielanfragen, in denen beschrieben wird, wie die Amazon-Pinpoint-Sammlung verwendet wird.

**Wichtig**  
Wenn Sie die in diesem Abschnitt beschriebenen Schritte ausführen, senden Sie Anfragen an die Amazon-Pinpoint-API. Diese Anfragen können neue Ressourcen in Ihrem Amazon-Pinpoint-Konto erstellen, bestehende Ressourcen ändern, Nachrichten senden, die Konfiguration Ihrer Amazon-Pinpoint-Projekte ändern und andere Amazon-Pinpoint-Features nutzen. Seien Sie vorsichtig, wenn Sie diese Anfragen ausführen.

## Beispiele aus der Amazon Pinpoint Postman-Kollektion
<a name="tutorials-using-postman-sample-requests-about"></a>

Sie müssen die meisten Operationen in der Amazon-Pinpoint-Postman-Sammlung konfigurieren, bevor Sie sie verwenden können. Für `GET`- und `DELETE`-Operationen müssen Sie in der Regel nur die Variablen ändern, die auf der Registerkarte **Pre-Request Script (Skript vor Anfrage)** eingestellt sind.

**Anmerkung**  
Wenn Sie die IAM-Richtlinie verwenden, die unter [Eine IAM-Richtlinie erstellen](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy) aufgeführt ist, können Sie keine der in dieser Sammlung enthaltenen `DELETE` Anfragen ausführen.

Beispielsweise erfordert die Operation `GetCampaign` die Angabe einer `projectId` und einer `campaignId`. Auf der Registerkarte **Pre-Request Script (Skript vor Anfrage)** sind beide Variablen vorhanden und mit Beispielwerten ausgefüllt. Löschen Sie die Beispielwerte und ersetzen Sie sie durch die Werte für Ihr Amazon-Pinpoint-Projekt und Ihre Kampagne.

Von diesen Variablen wird die `projectId`-Variable am häufigsten verwendet. Der Wert für diese Variable ist ein eindeutiger Bezeichner für das Projekt, für das Ihre Anforderung gilt. Eine Liste mit Bezeichnern für Ihre Projekte finden Sie in der Antwort auf die `GetApps`-Anforderung, die Sie im vorherigen Schritt dieser Anleitung gesendet haben. In dieser Antwort enthält das `Id`-Feld die eindeutige Kennung für ein Projekt. Weitere Informationen zur `GetApps`-Operation und zur Bedeutung der einzelnen Felder in der Antwort finden Sie unter [Apps](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps.html) in der *Amazon-Pinpoint-API-Referenz*.

**Anmerkung**  
In Amazon Pinpoint ist ein „Projekt“ dasselbe wie eine „App“ oder „Anwendung“.

Für `POST`- und `PUT`-Operationen müssen Sie auch den Anfragetext so anpassen, dass er die Werte enthält, die Sie an die API senden möchten. Wenn Sie beispielsweise eine `CreateApp`-Anforderung senden (bei der es sich um eine `POST`-Anforderung handelt), müssen Sie einen Namen für das Projekt angeben, das Sie erstellen. Sie können die Anfrage auf der Registerkarte **Body (Text)** ändern. Ersetzen Sie in diesem Beispiel den Wert neben `"Name"` durch den Namen des Projekts. Wenn Sie dem Projekt Tags hinzufügen möchten, können Sie diese im `tags`-Objekt angeben. Oder, wenn Sie keine Tags hinzufügen möchten, können Sie das gesamte `tags`-Objekt löschen.

**Anmerkung**  
Für die Operation `UntagResource` müssen Sie außerdem URL-Parameter angeben. Sie können diese Parameter auf der Registerkarte **Params (Parameter)** angeben. Ersetzen Sie die Werte in der Spalte **VALUE (Wert)** durch die Tags, die Sie für die angegebene Ressource löschen möchten.

## Beispielanfrage: Erstellen Sie ein Projekt mithilfe des Vorgangs `CreateApp`
<a name="tutorials-using-postman-sample-requests-createapp"></a>

Bevor Sie Segmente und Kampagnen in Amazon Pinpoint erstellen, müssen Sie zunächst ein Projekt erstellen. In Amazon Pinpoint besteht ein *Projekt* aus Segmenten, Kampagnen, Konfigurationen und Daten, die durch einen gemeinsamen Zweck miteinander verbunden sind. Beispielsweise könnten Sie in einem Projekt alle Inhalte vereinen, die sich auf eine bestimmte App oder eine bestimmte Marke oder Marketinginitiative beziehen. Wenn Sie Kundeninformationen zu Amazon Pinpoint hinzufügen, werden diese Informationen einem Projekt zugeordnet.

**Um ein Projekt durch Senden einer CreateApp API-Anfrage zu erstellen**

1. Wählen Sie im Menü **Umgebungen** die aus AWS-Region , in der Sie das Projekt erstellen möchten.  
![\[\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/Postman_Tutorial_Environments.png)

    In diesem Beispiel wurde Postman so konfiguriert, dass das Menü **Environments (Umgebungen)** die folgenden vier Optionen anzeigt:
   + USA Ost (Nord-Virginia)
   + USA West (Oregon)
   + Europe (Frankfurt)
   + Europa (Irland)

1. Wählen Sie im Ordner **Apps** den **CreateApp**Vorgang > aus.  
![\[\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/Postman_Tutorial_3.2_2.png)

   Der **Apps**-Ordner in der Amazon-Pinpoint-Postman-Sammlung ist erweitert und enthält die folgenden Anfragen:
   + `GetApp`
   + `GetApps`
   + `CreateApp`
   + `DeleteApp`

1. Ersetzen Sie auf der Registerkarte **Body (Text)**, neben `"Name"`, den Platzhalterwert (`"string"`) durch einen Namen für die Kampagne, z. B. **"MySampleProject"**.

1. Löschen Sie das Komma, das nach dem Kampagnennamen steht, und löschen Sie dann das gesamte `tags`-Objekt in den Zeilen 3 bis 5. Wenn Sie fertig sind, sollte Ihre Anfrage dem Beispiel ähneln, das im folgenden Code-Snippet gezeigt wird.

   ```
   {
       "Name": "MySampleProject"
   }
   ```

   Postman ist so konfiguriert, dass die Anfrage als unformatierte JSON-Nutzlast gesendet wird.

1. Wählen Sie **Send (Senden)** aus. Wenn die Kampagne erfolgreich erstellt wurde, zeigt der Antwortbereich den Status `201 Created` an.

   ```
   {
       "Name": "MySampleProject"
       "Id": "12345678901234567890123456789012",
       "Arn": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/12345678901234567890123456789012",
       "tags": {}
   }
   ```

## Beispiel: Senden Sie eine E-Mail mithilfe des Vorgangs `SendMessages`
<a name="tutorials-using-postman-sample-requests-sendmessages"></a>

Es ist sehr verbreitet, die Amazon-Pinpoint–`SendMessages`API zu verwenden, um transaktionale Nachrichten zu senden. Ein Vorteil des Sendens von Nachrichten über die `SendMessages`-API (im Gegensatz zum Erstellen von Kampagnen) besteht darin, dass Sie Nachrichten an eine beliebige Adresse senden können (z. B. E-Mail-Adresse, Telefonnummer oder Geräte-Token). Die Adresse, an die Sie Nachrichten senden, muss in Ihrem Amazon-Pinpoint -Konto nicht bereits vorhanden sein. Vergleichen wir dies mit dem Versenden von Nachrichten durch das Erstellen von Kampagnen. Bevor Sie eine Kampagne in Amazon Pinpoint versenden, müssen Sie Ihrem Amazon-Pinpoint-Konto Endpunkte hinzufügen, Segmente erstellen, die Kampagne erstellen und die Kampagne durchführen.

Das Beispiel in diesem Abschnitt zeigt, wie Sie eine transaktionale E-Mail-Nachricht direkt an eine bestimmte E-Mail-Adresse senden können. Sie können diese Anfrage ändern, um Nachrichten über andere Kanäle wie SMS, Mobile Push oder Voice zu senden.

**Um eine E-Mail-Nachricht zu senden, indem Sie eine SendMessages Anfrage einreichen**

1. Stellen Sie sicher, dass der E-Mail-Kanal für das Projekt aktiviert ist und dass die E-Mail-Adresse oder Domain, die Sie zum Senden und Empfangen der Nachricht verwenden möchten, konfiguriert ist. Weitere Informationen finden Sie unter [Aktivieren und Deaktivieren des E-Mail-Kanals](pinpoint/latest/userguide/channels-email-setup.html) und [Verifizieren von E-Mail-Identitäten](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-manage-verify.html) im *Amazon-Pinpoint-Benutzerhandbuch*.
**Anmerkung**  
Um das Verfahren in diesem Abschnitt abzuschließen, müssen Sie eine E-Mail-Adresse verifizieren.

1. Wählen Sie im Menü **Umgebungen** die Umgebung aus AWS-Region , von der aus Sie die Nachricht senden möchten.

   In diesem Beispiel wurde Postman so konfiguriert, dass das Menü **Environments (Umgebungen)** die folgenden vier Optionen anzeigt:
   + USA Ost (Nord-Virginia)
   + USA West (Oregon)
   + Europe (Frankfurt)
   + Europa (Irland)

1. Wählen Sie im Ordner **Nachrichten** den **SendMessages**Vorgang aus.  
![\[\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/Postman_Tutorial_3.3_3.png)

1. Ersetzen Sie auf der Registerkarte **Pre-Request Script (Skript vor Anfrage)** den Wert der Variablen `projectId` durch die ID eines Projekts, das bereits in der Region existiert, die Sie in Schritt 2 dieses Abschnitts ausgewählt haben.

1. Löschen Sie auf der Registerkarte **Body (Text)** die Beispielanfrage, die im Anfrage-Editor angezeigt wird. Fügen Sie folgenden Code ein:

   ```
   {
       "MessageConfiguration":{
           "EmailMessage":{
               "FromAddress":"sender@example.com",
               "SimpleEmail":{
                   "Subject":{
                       "Data":"Sample Amazon Pinpoint message"
                   },
                   "HtmlPart":{
                       "Data":"<h1>Test message</h1><p>This is a sample message sent from <a href=\"https://aws.amazon.com/pinpoint\">Amazon Pinpoint</a> using the SendMessages API.</p>"
                   },
                   "TextPart":{
                       "Data":"This is a sample message sent from Amazon Pinpoint using the SendMessages API."
                   }
               }
           }
       },
       "Addresses":{
           "recipient@example.com": {
               "ChannelType": "EMAIL"
           }
       }
   }
   ```

1. Ersetzen Sie den Code im vorherigen Code *sender@example.com* durch Ihre verifizierte E-Mail-Adresse. *recipient@example.com*Ersetzen Sie es durch die verifizierte E-Mail-Adresse, an die Sie die Nachricht senden möchten.
**Anmerkung**  
Wenn sich Ihr Konto noch in der E-Mail-Sandbox-Umgebung von Amazon Pinpoint befindet, können Sie E-Mails nur an Adressen oder Domänen senden, die in Ihrem Amazon-Pinpoint-Konto verifiziert sind. Weitere Informationen zum Entfernen Ihres Kontos aus der Sandbox-Umgebung finden Sie unter [Anfordern von Produktionszugriff für E-Mail](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-production-access.html) im *Amazon-Pinpoint-Benutzerhandbuch*.

1. Wählen Sie **Send (Senden)** aus. Wenn die Nachricht erfolgreich gesendet wurde, zeigt der Antwortbereich den Status `200 OK` an.

   ```
   {
       "ApplicationId": "12345678901234567890123456789012",
       "RequestId": "<sampleValue>",
       "Result": {
           "recipient@example.com": {
               "DeliveryStatus": "SUCCESSFUL",
               "StatusCode": 200,
               "StatusMessage": "<sampleValue>",
               "MessageId": "<sampleValue>"
           }
       }
   }
   ```

# Richten Sie ein SMS-Registrierungssystem in Amazon Pinpoint ein
<a name="tutorials-two-way-sms"></a>

SMS-Nachrichten (Textnachrichten) sind eine hervorragende Möglichkeit, zeitkritische Nachrichten mit Amazon Pinpoint an Ihre Kunden zu senden. Viele Menschen haben ihre Telefone immer in der Nähe, und SMS-Nachrichten ziehen die Aufmerksamkeit der Menschen in der Regel mehr auf sich als Push-Benachrichtigungen, E-Mails oder Telefonanrufe.

Eine gängige Methode zur Erfassung der Mobiltelefonnummern von Kunden ist die Verwendung eines webbasierten Formulars. Nachdem Sie die Telefonnummer des Kunden überprüft und sein Abonnement bestätigt haben, können Sie damit beginnen, SMS-Nachrichten zu Werbe-, Transaktions- und Informationszwecken an diesen Kunden zu senden.

Dieses Tutorial zeigt Ihnen, wie Sie ein Webformular einrichten, um die Kontaktinformationen der Kunden zu erfassen. Das Webformular sendet diese Informationen an Amazon Pinpoint. Als Nächstes überprüft Amazon Pinpoint, ob die Telefonnummer gültig ist, und erfasst andere Metadaten, die sich auf die Telefonnummer beziehen. Danach sendet Amazon Pinpoint dem Kunden eine Nachricht, in der er aufgefordert wird, sein Abonnement zu bestätigen. Nachdem der Kunde sein Abonnement bestätigt hat, wählt Amazon Pinpoint ihn für den Empfang Ihrer Nachrichten aus.

Das folgende Architekturdiagramm zeigt den Datenfluss in dieser Lösung.

![\[\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_Architecture.png)


## Informationen zu Double-Opt-in
<a name="tutorials-two-way-sms-double-opt-in"></a>

Dieses Tutorial zeigt Ihnen, wie Sie ein Double-Opt-In-System in Amazon Pinpoint einrichten, das bidirektionale SMS-Nachrichten verwendet.

In einem SMS-Double-Opt-In-System stellt Ihnen ein Kunde seine Telefonnummer zur Verfügung, indem er sie in einem Webformular oder in Ihrer App übermittelt. Wenn Sie die Anfrage des Kunden erhalten, erstellen Sie einen neuen Endpunkt in Amazon Pinpoint. Der neue Endpunkt sollte von Ihrer Kommunikation ausgeschlossen werden. Als nächstes senden Sie eine Nachricht an diese Telefonnummer. In Ihrer Nachricht bitten Sie den Empfänger, sein Abonnement zu bestätigen, indem er mit einem bestimmten Wort oder Satz (z. B. „Ja“ oder „Bestätigen“) antwortet. Wenn der Kunde auf die Nachricht mit dem von Ihnen angegebenen Wort oder der von Ihnen angegebenen Phrase antwortet, ändern Sie den Status des Endpunkts in „Opted-in“. Andernfalls, wenn der Kunde nicht antwortet oder mit einem anderen Wort oder einer anderen Phrase antwortet, können Sie für den Endpunkt den Status „Opted-out“ bestehen lassen.

## Informationen zu dieser Lösung
<a name="tutorials-two-way-sms-about"></a>

Dieser Abschnitt enthält Informationen über die Lösung, die Sie in diesem Tutorial erstellen.

**Zielgruppe**  
Dieses Tutorial richtet sich an Entwickler und Systemimplementierer. Sie müssen nicht mit Amazon Pinpoint vertraut sein, um die Schritte in diesem Tutorial ausführen zu können. Sie sollten jedoch mit der Verwaltung von IAM-Richtlinien, der Erstellung von Lambda-Funktionen in Node.js und der Bereitstellung von Webinhalten vertraut sein.

**Verwendete Funktionen**  
Dieses Tutorial enthält Anwendungsbeispiele für die folgenden Amazon-Pinpoint-Funktionen:
+ Senden von transaktionalen SMS-Nachrichten
+ Abrufen von Informationen über Telefonnummern durch die Verwendung der Telefonnummernüberprüfung
+ Empfangen von eingehenden SMS-Nachrichten mithilfe von Zwei-Wege-SMS-Messaging
+ Erstellen von dynamischen Segmenten
+ Erstellen von Kampagnen
+ Interaktion mit der Amazon Pinpoint API mithilfe von AWS Lambda

**Benötigte Zeit**  
Bis zum Abschluss dieses Tutorials dauert es etwa eine Stunde. Nachdem Sie diese Lösung implementiert haben, können Sie weitere Schritte unternehmen, um die Lösung an Ihren individuellen Anwendungsfall anzupassen.

**Regionale Einschränkungen**  
In diesem Tutorial müssen Sie mithilfe der Amazon-Pinpoint-Konsole eine Langwahlnummer leasen. Sie können die Amazon-Pinpoint-Konsole verwenden, um dedizierte Langwahlnummern zu leasen, die in mehreren Ländern registriert sind. Allerdings können nur Langwahlnummern verwendet werden, die in Kanada registriert sind, um SMS-Nachrichten zu senden. (Sie können Langwahlnummern, die in anderen Ländern und Regionen registriert sind, zum Senden von Sprachnachrichten verwenden.)

Wir haben die Codebeispiele in diesem Tutorial unter Berücksichtigung dieser Einschränkung entwickelt. Die Code-Beispiele gehen beispielsweise davon aus, dass die Telefonnummer des Empfängers immer 10 Ziffern und den Ländercode 1 hat. Wenn Sie diese Lösung in anderen Ländern oder Regionen als den USA oder Kanada implementieren, müssen Sie die Codebeispiele entsprechend anpassen.

**Kosten der Ressourcennutzung**  
Für die Erstellung eines AWS Kontos fallen keine Gebühren an. Durch die Implementierung dieser Lösung können Ihnen jedoch folgende Kosten entstehen:
+ **Leasingkosten für Langwahlnummern**: Um dieses Tutorial abzuschließen, müssen Sie eine Langwahlnummer leasen. Langwahlnummern, die in Kanada registriert sind, kosten 1,00 USD pro Monat.
+ **Nutzung der Telefonnummernüberprüfung**: Die Lösung in diesem Tutorial verwendet das Feature der Telefonnummernüberprüfung von Amazon Pinpoint, um zu überprüfen, ob jede Nummer, die Sie erhalten, gültig und korrekt formatiert ist, und um zusätzliche Informationen über die Telefonnummer zu erhalten. Sie zahlen 0,006 USD für jede Anfrage zur Überprüfung der Telefonnummer.
+ **Kosten für den Versand von Nachrichten**: Die Lösung in diesem Tutorial sendet ausgehende SMS-Nachrichten Sie zahlen für jede Nachricht, die Sie über Amazon Pinpoint senden. Der Preis, den Sie für jede Nachricht zahlen, hängt vom Land oder der Region des Empfängers ab. Wenn Sie Nachrichten an Empfänger in den USA (außer US-Territorien) senden, zahlen Sie 0,00645 USD pro Nachricht. Wenn Sie Nachrichten an Empfänger in Kanada senden, zahlen Sie 0,00109–0,02 USD, je nach Netzbetreiber und Standort des Empfängers.
+ **Kosten für den Empfang von Nachrichten**: Diese Lösung empfängt und verarbeitet auch eingehende SMS-Nachrichten. Sie bezahlen für jede eingehende Nachricht, die an Telefonnummern gesendet wird, die mit Ihrem Amazon-Pinpoint-Konto verknüpft sind. Der Preis, den Sie zahlen, hängt davon ab, wo die empfangende Telefonnummer registriert ist. Wenn die empfangende Telefonnummer in den USA registriert ist (ausgenommen US-Territorien), zahlen Sie 0,0075 USD pro eingehende Nachricht. Wenn Ihre Nummer in Kanada registriert ist, zahlen Sie 0,00155 USD pro eingehende Nachricht.
+ **Lambda-Nutzung**: Diese Lösung verwendet zwei Lambda-Funktionen, die mit der Amazon-Pinpoint-API interagieren. Wenn Sie eine Lambda-Funktion aufrufen, werden Ihnen die Kosten nach der Anzahl der Anforderungen für Ihre Funktionen, nach der Zeit, die Ihr Code benötigt, um ausgeführt zu werden, und nach der Menge an Speicher, die Ihre Funktionen verwenden, berechnet. Die Funktionen in diesem Tutorial verbrauchen sehr wenig Speicher und laufen typischerweise 1–3 Sekunden lang. Ihre Nutzung dieser Lösung fällt möglicherweise teilweise oder vollständig unter das kostenlose Lambda-Nutzungskontingent. Weitere Informationen finden Sie unter [Lambda – Preise](https://aws.amazon.com/lambda/pricing/).
+ **API-Gateway-Nutzung**: Das Webformular in dieser Lösung ruft eine API auf, die von API Gateway verwaltet wird Für jede Million Aufrufe an API Gateway zahlen Sie 3,50 bis 3,70 USD, je nachdem, in welcher AWS Region Sie Amazon Pinpoint verwenden. Weitere Informationen finden Sie unter [API-Gateway-Preise](https://aws.amazon.com/api-gateway/pricing/).
+ **Webhostingkosten**: Diese Lösung umfasst ein webbasiertes Formular, das Sie auf Ihrer Website hosten müssen. Die Höhe der Kosten für das Hosten dieser Inhalte hängt von Ihrem Webhosting-Anbieter ab.

**Anmerkung**  
Alle in dieser Liste aufgeführten Preise sind in US-Dollar (USD) angegeben.

**Nächster Schritt**: [Voraussetzungen](tutorials-two-way-sms-prereqs.md)

# Voraussetzungen für die Einrichtung von SMS in Amazon Pinpoint
<a name="tutorials-two-way-sms-prereqs"></a>

Bevor Sie mit diesem Tutorial beginnen, müssen Sie die folgenden Voraussetzungen erfüllen:
+ Sie müssen ein AWS Konto haben. Um ein AWS Konto zu erstellen, gehen Sie zu [https://console.aws.amazon.com/](https://console.aws.amazon.com/)und wählen Sie **Neues AWS Konto erstellen**.
+ Das Konto, mit dem Sie sich anmelden, AWS-Managementkonsole muss in der Lage sein, die folgenden Aufgaben auszuführen:
  + Neue IAM-Richtlinien und -Rollen erstellen
  + Neue Amazon-Pinpoint-Projekte erstellen
  + Neue Lambda-Funktionen erstellen
  + Neues APIs in API Gateway erstellen
+ Sie benötigen eine Methode zum Hosten und Veröffentlichen von Webseiten. Sie können zwar AWS Dienste zum Hosten Ihrer Webseiten verwenden, müssen dies aber nicht. 
**Tipp**  
Weitere Informationen zum Hosten von Webseiten mithilfe von AWS Diensten finden Sie unter [Hosten einer statischen](https://aws.amazon.com/getting-started/hands-on/host-static-website/) Webseite.

**Weiter**: [Einrichten von Amazon Pinpoint](tutorials-two-way-sms-part-1.md)

# SMS in Amazon Pinpoint einrichten
<a name="tutorials-two-way-sms-part-1"></a>

Bevor Sie SMS-Nachrichten einrichten können, benötigen Sie ein Amazon Pinpoint Pinpoint-Projekt. In diesem Abschnitt führen Sie folgenden Aufgaben aus:
+ Erstellen Sie ein Amazon-Pinpoint-Projekt
+ Aktivieren Sie den SMS-Kanal und leasen Sie eine Telefonnummer
+ Konfigurieren Sie Zwei-Wege-SMS-Messaging

Bevor Sie beginnen, überprüfen Sie die [Voraussetzungen](tutorials-two-way-sms-prereqs.md).

## Erstellen Sie ein Amazon-Pinpoint-Projekt
<a name="tutorials-two-way-sms-part-1-create-project"></a>

Um zu beginnen, müssen Sie ein Amazon-Pinpoint-Projekt erstellen. In Amazon Pinpoint besteht ein *Projekt* aus Segmenten, Kampagnen, Konfigurationen und Daten, die durch einen gemeinsamen Zweck miteinander verbunden sind. Beispielsweise könnten Sie in einem Projekt alle Inhalte vereinen, die sich auf eine bestimmte App oder eine bestimmte Marke oder Marketinginitiative beziehen. Wenn Sie Kundeninformationen zu Amazon Pinpoint hinzufügen, werden diese Informationen einem Projekt zugeordnet.

Die Schritte zum Erstellen eines neuen Projekts unterscheiden sich je nachdem, ob Sie zuvor ein Projekt in Amazon Pinpoint erstellt haben.

### Erstellen eines Projekts (neue Amazon-Pinpoint-Benutzer)
<a name="tutorials-two-way-sms-part-1-create-project-opt-1"></a>

Diese Schritte beschreiben den Prozess der Erstellung eines neuen Amazon Pinpoint Pinpoint-Projekts, falls Sie in der aktuellen AWS Region noch nie ein Projekt erstellt haben.

**So erstellen Sie ein Projekt**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon Pinpoint Pinpoint-Konsole unter [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/).

1. Verwenden Sie die Regionsauswahl, um die AWS Region auszuwählen, die Sie verwenden möchten, wie in der folgenden Abbildung gezeigt. Wenn Sie sich nicht sicher sind, wählen Sie die Region aus, die Ihnen am nächsten liegt.  
![\[In der Dropdownliste „Region“ wird „USA Ost“ (Nord-Virginia) ausgewählt.\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/Region_Selector.png)

1. Geben Sie unter **Get started (Erste Schritte)** unter **Name** einen Namen für die Kampagne ein (z. B. **SMSRegistration**) und wählen Sie dann **Create project (Projekt erstellen)** aus.

1. Wählen Sie auf der Seite **Configure features (Funktionen konfigurieren)** die Option **Skip this step (Diesen Schritt überspringen)** aus.

1. Klicken Sie im Navigationsbereich auf **All projects (Alle Projekte)**.

1. Kopieren Sie auf der Seite **All projects (Alle Projekte)** neben dem Projekt, das Sie gerade erstellt haben, den Wert, der in der Spalte **Project ID (Projekt-ID)** angezeigt wird.
**Tipp**  
Sie müssen diese ID an verschiedenen Stellen in diesem Tutorial verwenden. Bewahren Sie die Projekt-ID an einem geeigneten Ort auf, sodass Sie sie später kopieren können.

### Erstellen eines Projekts (bestehende Amazon-Pinpoint-Benutzer)
<a name="tutorials-two-way-sms-part-1-create-project-opt-2"></a>

Diese Schritte beschreiben den Prozess der Erstellung eines neuen Amazon Pinpoint Pinpoint-Projekts, falls Sie bereits Projekte in der aktuellen AWS Region erstellt haben.

**So erstellen Sie ein Projekt**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon Pinpoint Pinpoint-Konsole unter [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/).

1. Verwenden Sie die Regionsauswahl, um die AWS Region auszuwählen, die Sie verwenden möchten, wie in der folgenden Abbildung gezeigt. Wenn Sie sich nicht sicher sind, wählen Sie die Region aus, die Ihnen am nächsten liegt.  
![\[Das Drop-down-Menü für die Region zeigt, dass USA Ost (Nord-Virginia) ausgewählt ist.\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/Region_Selector.png)

1. Klicken Sie auf der Seite **Alle Projekte** auf **Projekt erstellen**.

1. Geben Sie im Fenster **Create a project (Erstellen eines Projekts)** unter **Project name (Projektname)** einen Namen für das Projekt ein (z. B. **SMSRegistration**). Wählen Sie **Erstellen** aus.

1. Wählen Sie auf der Seite **Configure features (Funktionen konfigurieren)** die Option **Skip this step (Diesen Schritt überspringen)** aus.

1. Klicken Sie im Navigationsbereich auf **All projects (Alle Projekte)**.

1. Kopieren Sie auf der Seite **All projects (Alle Projekte)** neben dem Projekt, das Sie gerade erstellt haben, den Wert, der in der Spalte **Project ID (Projekt-ID)** angezeigt wird.
**Tipp**  
Sie müssen diese ID an verschiedenen Stellen in diesem Tutorial verwenden. Bewahren Sie die Projekt-ID an einem geeigneten Ort auf, sodass Sie sie später kopieren können.

## Besorgen Sie sich eine dedizierte Telefonnummer
<a name="tutorials-two-way-sms-part-1-set-up-channel"></a>

**Anmerkung**  
Amazon Pinpoint hat die Dokumentation seines Benutzerhandbuchs aktualisiert. Aktuelle Informationen zur Erstellung, Konfiguration und Verwaltung Ihrer SMS- und Sprachressourcen finden Sie im neuen [SMS-Benutzerhandbuch für AWS Endbenutzer-Nachrichten](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html). 

Nachdem Sie ein Projekt erstellt haben, können Sie damit beginnen, Funktionen in diesem Projekt zu konfigurieren. In diesem Abschnitt aktivieren Sie den SMS-Kanal und rufen eine dedizierte Telefonnummer ab, die Sie beim Senden von SMS-Nachrichten verwenden können.

**Anmerkung**  
In diesem Abschnitt wird davon ausgegangen, dass Sie nach der Registrierung der Marke und Kampagne eine 10DLC-Telefonnummer in den USA, eine gebührenfreie Nummer in den USA oder eine kanadische Langwahlnummer leasen. Wenn Sie die in diesem Abschnitt beschriebenen Verfahren befolgen, aber ein anderes Land als die Vereinigten Staaten oder Kanada auswählen, können Sie diese Nummer nicht verwenden, um SMS-Nachrichten zu versenden. Weitere Informationen zum Leasing von SMS-fähigen Langcodes in anderen Ländern als den Vereinigte Staaten oder Kanada finden Sie unter [Unterstützte Länder und Regionen (SMS-Kanal) im SMS-Benutzerhandbuch](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-sms-by-country.html) *für AWS Endbenutzernachrichten*.

Gehen Sie wie folgt vor, um den SMS-Kanal über die Amazon-Pinpoint-Konsole zu aktivieren:

**SMS-Kanal aktivieren**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon Pinpoint Pinpoint-Konsole unter [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/).

1. Klicken Sie im Navigationsbereich unter **Settings (Einstellungen)** auf **SMS and voice (SMS und Stimme)**.

1. Klicken Sie neben **SMS settings (SMS-Einstellungen)** auf **Edit (Bearbeiten)**.

1. Wählen Sie unter **General settings (Allgemeine Einstellungen)** die Option **Enable the SMS channel for this project (Den SMS-Kanal für dieses Projekt aktivieren)** und anschließend **Save changes (Änderungen speichern)** aus.

Gehen Sie wie folgt vor, um über die AWS End User Messaging SMS-Konsole eine Telefonnummer anzufordern:

**Anfordern einer Telefonnummer (Konsole)**

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/).
**Anmerkung**  
Stellen Sie sicher, dass Sie eine Telefonnummer genauso anfordern AWS-Region , in der Sie Ihr Amazon Pinpoint Pinpoint-Projekt erstellt haben.

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

1. Wählen Sie auf der Seite **Land auswählen** für das **Land des Nachrichtenziels** entweder die USA oder Kanada aus. Wählen Sie **Weiter** aus.

1. Geben Sie im Abschnitt **Anwendungsfall für Messaging** Folgendes ein:
   + Wählen Sie unter **Rufnummernfunktionen** die Option **SMS**
**Wichtig**  
Die Funktionen für SMS und Sprache können nach dem Kauf der Telefonnummer nicht mehr geändert werden.
   + Wählen Sie für **Bidirektionales Messaging** **Ja**.

1. Wählen Sie **Weiter** aus.

1. Wählen Sie unter **Absendertyp auswählen** entweder **Long Code** oder **10DLC** aus.

   Wenn Sie 10DLC auswählen und bereits eine registrierte Kampagne haben, können Sie die Kampagne unter **Mit registrierter Kampagne verbinden** auswählen.

1. Wählen Sie **Weiter** aus.

1. Unter **Überprüfung und Anfrage** können Sie Ihre Anfrage überprüfen und bearbeiten, bevor Sie sie absenden. Wählen Sie **Anfrage** aus.

1. Abhängig von der Art der von Ihnen angeforderten Telefonnummer wird möglicherweise das Fenster **Registrierung erforderlich** angezeigt. Ihre Telefonnummer ist mit dieser Registrierung verbunden und kann erst dann Nachrichten senden, wenn Ihre Registrierung genehmigt wurde. Weitere Informationen zu den Registrierungsanforderungen finden Sie unter [Registrierungen](https://docs.aws.amazon.com/sms-voice/latest/userguide/registrations.html).

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

   1. Wählen Sie **Registrierung beginnen**, um die Registrierung der Telefonnummer abzuschließen, oder **Später registrieren**.
**Wichtig**  
Ihre Telefonnummer 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 [Registrierungen](https://docs.aws.amazon.com/sms-voice/latest/userguide/registrations.html).

## Aktivieren bidirektionaler SMS-Nachrichten
<a name="tutorials-two-way-sms-part-1-enable-two-way"></a>

Jetzt, da Sie eine eigene Telefonnummer haben, können Sie Zwei-Wege-SMS einrichten. Die Aktivierung von Zwei-Wege-SMS ermöglicht es Ihren Kunden, auf die SMS-Nachrichten zu antworten, die Sie ihnen senden. In dieser Lösung verwenden Sie Zwei-Wege-SMS, um Ihren Kunden eine Möglichkeit zu geben, zu bestätigen, dass sie Ihr SMS-Programm abonnieren möchten.

Gehen Sie wie folgt vor, um bidirektionale SMS über die SMS-Konsole für AWS Endbenutzernachrichten zu aktivieren:

**Aktivieren bidirektionaler SMS-Nachrichten**

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 **Konfigurationen** die Option **Telefonnummern**.

1. Wählen Sie auf der Seite **Telefonnummern verwalten** eine Telefonnummer.

1. Wählen Sie auf der Registerkarte **Bidirektionale SMS** die Schaltfläche **Einstellungen bearbeiten**.

1. Wählen Sie auf der Seite **Einstellungen bearbeiten** die Option **Bidirektionale Nachricht aktivieren** aus.

1. Wählen Sie für **Zielart** **Amazon SNS** aus.
   + **Neues Amazon SNS SNS-Thema** — AWS End User Messaging SMS erstellt ein Thema in Ihrem Konto. Das Thema wird automatisch mit allen erforderlichen Berechtigungen erstellt. Weitere Informationen zu Amazon-SNS-Themen finden Sie unter [Konfigurieren von Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-configuring.html) im *Amazon-SNS-Entwicklerhandbuch*. 
   + Geben Sie unter **Ziel für eingehende Nachrichten** einen Themennamen ein, z. B. **SMSRegistrationFormTopic**.

1. Wählen Sie für **Bidirektionale Kanalrolle** die Option **SNS-Themenrichtlinien verwenden** aus.

1. Wählen Sie **Änderungen speichern ** aus.

Verwenden Sie die SMS-Konsole für AWS Endbenutzernachrichten, um Ihrer Telefonnummer Stichwörter hinzuzufügen, die Ihnen Kunden zur Bestätigung ihrer Abonnements senden (z. B. **Yes** oder**Confirm**).

**Hinzufügen eines Schlüsselworts**

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 **Konfigurationen** die Option **Telefonnummer**.

1. Wählen Sie auf der Seite **Telefonnummern** die Telefonnummer aus, der ein Stichwort hinzugefügt werden soll.

1. Wählen Sie auf der Registerkarte **Stichwörter** die Schaltfläche **Stichwort hinzufügen**.

1. Fügen Sie im Bereich **Benutzerdefiniertes Stichwort** Folgendes hinzu:
   + **Stichwort** – Das neue Stichwort, das hinzugefügt werden soll (z. B. **Yes** oder **Confirm**).
   + **Antwortnachricht** – Die Nachricht, die an den Empfänger zurückgesendet werden soll.
   + **Stichwortaktion** – Die Aktion, die ausgeführt werden soll, wenn das Stichwort empfangen wird. Wählen Sie **Automatische Antwort**.

1. Wählen Sie **Stichwort hinzufügen**.

**Weiter**: [Erstellen von IAM-Richtlinien und -Rollen](tutorials-two-way-sms-part-2.md)

# Erstellen Sie IAM-Richtlinien und -Rollen für die Verwendung mit SMS in Amazon Pinpoint
<a name="tutorials-two-way-sms-part-2"></a>

Der nächste Schritt bei der Implementierung der SMS-Registrierungslösung in Amazon Pinpoint besteht darin, eine Richtlinie und eine Rolle in AWS Identity and Access Management (IAM) zu konfigurieren. Für diese Lösung müssen Sie eine Richtlinie erstellen, die den Zugriff auf bestimmte Ressourcen ermöglicht, die sich auf Amazon Pinpoint beziehen. Anschließend erstellen Sie eine Rolle und fügen die Richtlinie daran an. Später in diesem Tutorial erstellen Sie eine AWS Lambda Funktion, die diese Rolle verwendet, um bestimmte Operationen in der Amazon Pinpoint Pinpoint-API aufzurufen.

## Eine IAM-Richtlinie erstellen
<a name="tutorials-two-way-sms-part-2-create-policy"></a>

In diesem Abschnitt wird beschrieben, wie Sie eine IAM-Richtlinie erstellen. Benutzer und Rollen, die diese Richtlinie verwenden, können Folgendes tun:
+ Die Funktion zur Telefonnummernüberprüfung verwenden
+ Amazon-Pinpoint-Endpunkte anzeigen, erstellen und aktualisieren
+ Nachrichten an Endpunkte von Amazon Pinpoint senden

In diesem Tutorial möchten Sie Lambda die Möglichkeit geben, diese Aufgaben auszuführen. Allerdings verwendet diese Richtlinie, um die Sicherheit zu erhöhen, das Prinzipal des Erteilens von *geringsten Rechten*. Mit anderen Worten, es werden nur die Berechtigungen erteilt, die zum Abschließen dieser Lösung erforderlich sind, und nicht mehr. Diese Richtlinie ist wie folgt eingeschränkt:
+ Sie können sie nur verwenden, um die Telefonnummernüberprüfungs-API in einer bestimmten Region aufzurufen.
+ Sie können sie nur verwenden, um Endpunkte anzuzeigen, zu erstellen oder zu aktualisieren, die mit einem bestimmten Amazon-Pinpoint-Projekt verknüpft sind.
+ Sie können sie nur verwenden, um Nachrichten an Endpunkte zu senden, die mit einem bestimmten Amazon-Pinpoint-Projekt verknüpft sind.

**So erstellen Sie die Richtlinie**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)

1. Wählen Sie im Navigationsbereich **Richtlinien** und dann **Richtlinie erstellen**.

1. Fügen Sie auf der Registerkarte **JSON** den folgenden Code ein.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "logs:CreateLogStream",
                   "logs:PutLogEvents",
                   "logs:CreateLogGroup"
               ],
               "Resource": "arn:aws:logs:*:*:*"
           },
           {
               "Effect": "Allow",
               "Action": "mobiletargeting:SendMessages",
               "Resource": "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/*"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "mobiletargeting:GetEndpoint",
                   "mobiletargeting:UpdateEndpoint",
                   "mobiletargeting:PutEvents"
               ],
               "Resource": "arn:aws:mobiletargeting:us-east-1:111122223333:apps/projectId/endpoints/*"
           },
           {
               "Effect": "Allow",
               "Action": "mobiletargeting:PhoneNumberValidate",
               "Resource": "arn:aws:mobiletargeting:us-east-1:111122223333:phone/number/validate"
           }
       ]
   }
   ```

------

   Gehen Sie im vorhergehenden Beispiel wie folgt vor:
   + *region*Ersetzen Sie es durch die AWS Region, in der Sie Amazon Pinpoint verwenden, z. B. `us-east-1` oder`eu-central-1`.
**Tipp**  
Eine vollständige Liste der AWS Regionen, in denen Amazon Pinpoint verfügbar ist, finden Sie unter [AWS Regionen und Endpunkte](https://docs.aws.amazon.com/general/latest/gr/rande.html#pinpoint_region) in der. *Allgemeine AWS-Referenz*
   + *accountId*Ersetzen Sie es durch die eindeutige ID für Ihr AWS Konto.
   + *projectId*Ersetzen Sie es durch die eindeutige ID des Projekts, das Sie in [Amazon Pinpoint Pinpoint-Projekt erstellen](tutorials-two-way-sms-part-1.md#tutorials-two-way-sms-part-1-create-project) dieses Tutorials erstellt haben.
**Anmerkung**  
Die `logs` Aktionen ermöglichen es Lambda, seine Ausgabe in Logs zu CloudWatch protokollieren.

1. Wählen Sie **Weiter** aus.

1. Geben Sie **unter Richtlinienname** einen Namen für die Richtlinie ein, z. B. **RegistrationFormPolicy** Wählen Sie **Richtlinie erstellen** aus.

## Erstellen einer IAM-Rolle
<a name="tutorials-two-way-sms-part-2-create-role"></a>

**So erstellen Sie die Rolle**

1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole.

1. Klicken Sie im Navigationsbereich der IAM-Konsole auf **Rollen** und wählen Sie dann **Rolle erstellen** aus.

1. Wählen Sie unter **Vertrauenswürdiger Entitätstyp** die Option **AWS Service** und dann für **Service oder Benutzerfall** **Lambda** aus der Drop-down-Liste aus.

1. Wählen Sie **Weiter** aus.

1. Wählen Sie unter **Berechtigungsrichtlinien** die Richtlinie aus, die Sie im vorherigen Abschnitt erstellt haben, oder suchen Sie danach, und klicken Sie dann auf **Weiter**.

1. Geben Sie unter **Rollendetails** **für Rollenname** einen Namen für die Rolle ein, z. **SMSRegistrationForm** B. Wählen Sie **Rolle erstellen** aus.

**Weiter**: [Erstellen von Lambda-Funktionen](tutorials-two-way-sms-part-3.md)

# Lambda-Funktionen zur Verwendung mit Amazon Pinpoint SMS-Messaging erstellen
<a name="tutorials-two-way-sms-part-3"></a>

In diesem Abschnitt erfahren Sie, wie Sie zwei Lambda-Funktionen für die Verwendung mit Amazon Pinpoint SMS-Messaging erstellen und konfigurieren. Später richten Sie API Gateway und Amazon Pinpoint so ein, dass sie diese Funktionen aufrufen, wenn bestimmte Ereignisse eintreten. Beide Funktionen erstellen und aktualisieren Endpunkte im von Ihnen angegebenen Amazon-Pinpoint-Projekt. Die erste Funktion verwendet auch die Funktion zur Telefonnummernüberprüfung.

## Erstellen der Funktion, die Kundendaten überprüft und Endpunkte erstellt
<a name="tutorials-two-way-sms-part-3-create-register-function"></a>

Die erste Funktion verwendet Eingaben aus Ihrem Registrierungsformular, die sie von Amazon API Gateway erhält. Sie verwendet diese Informationen, um mithilfe der Funktion zur [Überprüfung der Telefonnummer von Amazon Pinpoint Informationen über die Telefonnummer](https://docs.aws.amazon.com/pinpoint/latest/developerguide/validate-phone-numbers.html) des Kunden zu erhalten. Die Funktion verwendet dann die validierten Daten, um einen neuen Endpunkt in dem von Ihnen angegebenen Amazon-Pinpoint-Projekt zu erstellen. Standardmäßig wird der Endpunkt, den die Funktion erstellt, von zukünftigen Nachrichten von Ihnen ausgeschlossen, aber dieser Status kann durch die zweite Funktion geändert werden. Schließlich sendet diese Funktion dem Kunden eine Nachricht, in der er aufgefordert wird, zu überprüfen, ob er SMS-Nachrichten von Ihnen erhalten möchte.

**So erstellen Sie die Lambda-Funktion:**

1. Öffnen Sie die AWS Lambda Konsole unter. [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/)

1. Wählen Sie **Funktion erstellen**.

1. Wählen **Sie unter Funktion erstellen** die Option **Blueprint verwenden** aus.

1. Geben Sie im Suchfeld **hello** ein und drücken Sie dann die Eingabetaste. Wählen Sie in der Ergebnisliste die Node.js-Funktion `hello-world` aus, wie im folgenden Bild gezeigt.   
![\[Auf der Seite „Funktion erstellen“ wird die Option Blueprint verwenden angezeigt.\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_LAM_Step1.5.png)

1. Führen Sie unter **Basic information** (Grundlegende Informationen) die folgenden Schritte aus:
   + Geben Sie für **Name** einen Namen für die Funktion ein, z. B. **RegistrationForm**.
   + Wählen Sie für **Role (Rolle)** die Option **Choose an existing role (Eine vorhandene Rolle wählen)** aus.
   + Wählen Sie **unter Vorhandene Rolle** die **SMSRegistrationFormularrolle aus**, die Sie unter [IAM-Rolle erstellen](tutorials-two-way-sms-part-2.md#tutorials-two-way-sms-part-2-create-role) erstellt haben.

   Wenn Sie fertig sind, klicken Sie auf **Create function (Funktion erstellen)**.

1. Löschen Sie **unter Codequelle** die Beispielfunktion im Code-Editor und fügen Sie dann den folgenden Code ein:

   ```
   import { PinpointClient, PhoneNumberValidateCommand, UpdateEndpointCommand, SendMessagesCommand } from "@aws-sdk/client-pinpoint"; // ES Modules import
   const pinClient = new PinpointClient({region: process.env.region});  
   
   // Make sure the SMS channel is enabled for the projectId that you specify.
   // See: https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms-setup.html
   var projectId = process.env.projectId;
   
   // You need a dedicated long code in order to use two-way SMS. 
   // See: https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-voice-manage.html#channels-voice-manage-request-phone-numbers
   var originationNumber = process.env.originationNumber;
   
   // This message is spread across multiple lines for improved readability.
   var message = "ExampleCorp: Reply YES to confirm your subscription. 2 msgs per "
               + "month. No purchase req'd. Msg&data rates may apply. Terms: "
               + "example.com/terms-sms";
               
   var messageType = "TRANSACTIONAL";
   
   export const handler = async (event, context) => {
     console.log('Received event:', event);
     await validateNumber(event);
   };
   
   async function validateNumber (event) {
     var destinationNumber = event.destinationNumber;
     if (destinationNumber.length == 10) {
       destinationNumber = "+1" + destinationNumber;
     }
     var params = {
       NumberValidateRequest: {
         IsoCountryCode: 'US',
         PhoneNumber: destinationNumber
       }
     };
     try{
       const PhoneNumberValidateresponse = await pinClient.send( new  PhoneNumberValidateCommand(params));
       console.log(PhoneNumberValidateresponse);
        if (PhoneNumberValidateresponse['NumberValidateResponse']['PhoneTypeCode'] == 0) {
           await createEndpoint(PhoneNumberValidateresponse, event.firstName, event.lastName, event.source);
           
         } else {
           console.log("Received a phone number that isn't capable of receiving "
                      +"SMS messages. No endpoint created.");
         }
     }catch(err){
       console.log(err);
     }
   }
   
   async function createEndpoint(data, firstName, lastName, source) {
     var destinationNumber = data['NumberValidateResponse']['CleansedPhoneNumberE164'];
     var endpointId = data['NumberValidateResponse']['CleansedPhoneNumberE164'].substring(1);
     
     var params = {
       ApplicationId: projectId,
       // The Endpoint ID is equal to the cleansed phone number minus the leading
       // plus sign. This makes it easier to easily update the endpoint later.
       EndpointId: endpointId,
       EndpointRequest: {
         ChannelType: 'SMS',
         Address: destinationNumber,
         // OptOut is set to ALL (that is, endpoint is opted out of all messages)
         // because the recipient hasn't confirmed their subscription at this
         // point. When they confirm, a different Lambda function changes this 
         // value to NONE (not opted out).
         OptOut: 'ALL',
         Location: {
           PostalCode:data['NumberValidateResponse']['ZipCode'],
           City:data['NumberValidateResponse']['City'],
           Country:data['NumberValidateResponse']['CountryCodeIso2'],
         },
         Demographic: {
           Timezone:data['NumberValidateResponse']['Timezone']
         },
         Attributes: {
           Source: [
             source
           ]
         },
         User: {
           UserAttributes: {
             FirstName: [
               firstName
             ],
             LastName: [
               lastName
             ]
           }
         }
       }
     };
     try{
       const UpdateEndpointresponse = await pinClient.send(new UpdateEndpointCommand(params));
       console.log(UpdateEndpointresponse);
       await sendConfirmation(destinationNumber);
     }catch(err){
       console.log(err);
     }  
   }
   
   async function sendConfirmation(destinationNumber) {
     var params = {
       ApplicationId: projectId,
       MessageRequest: {
         Addresses: {
           [destinationNumber]: {
             ChannelType: 'SMS'
           }
         },
         MessageConfiguration: {
           SMSMessage: {
             Body: message,
             MessageType: messageType,
             OriginationNumber: originationNumber
           }
         }
       }
     };
     try{
       const SendMessagesCommandresponse = await pinClient.send(new SendMessagesCommand(params));
       console.log("Message sent! " 
             + SendMessagesCommandresponse['MessageResponse']['Result'][destinationNumber]['StatusMessage']);
     }catch(err){
       console.log(err);
     }
   }
   ```

1. Wählen Sie auf der Registerkarte **Konfiguration** für **Umgebungsvariablen** die Option **Bearbeiten** und dann **Umgebungsvariable hinzufügen** aus. Gehen Sie wie folgt vor:
   + Erstellen Sie in der ersten Zeile eine Variable mit dem Schlüssel **originationNumber**. Stellen Sie anschließend den Wert auf die Telefonnummer der dedizierten Langwahlnummer ein, die Sie in [Schritt 1.2](tutorials-two-way-sms-part-1.md#tutorials-two-way-sms-part-1-set-up-channel) erhalten haben.
**Anmerkung**  
Achten Sie darauf, dass Sie das Pluszeichen (\$1) und die Landesvorwahl für die Telefonnummer angeben. Fügen Sie keine weiteren Sonderzeichen wie Bindestriche (-), Punkte (.) oder Klammern hinzu.
   + Erstellen Sie in der zweiten Zeile eine Variable mit dem Schlüssel **projectId**. Als nächstes setzen Sie den Wert auf die eindeutige ID des Projekts, das Sie in [Schritt 1.1](tutorials-two-way-sms-part-1.md#tutorials-two-way-sms-part-1-create-project) erstellt haben.
   + Erstellen Sie in der dritten Zeile eine Variable mit einem Schlüssel von **region**. Stellen Sie als Nächstes den Wert auf die Region ein, in der Sie Amazon Pinpoint verwenden, z. B. **us-east-1** oder **us-west-2**.

   Wenn Sie fertig sind, sollte der Abschnitt **Environment Variables (Umgebungsvariablen)** dem in der folgenden Abbildung gezeigten Beispiel entsprechen.  
![\[Die Umgebungsvariablen für OriginationNumber, projectId und Region.\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_LAM_Step1.7.png)

1. Wählen Sie oben auf der Seite **Save** aus.

### Testen der Funktion
<a name="tutorials-two-way-sms-part-3-create-register-function-test"></a>

Nachdem Sie die Funktion erstellt haben, sollten Sie sie testen, um sich zu vergewissern, dass sie richtig konfiguriert ist. Stellen Sie außerdem sicher, dass die von Ihnen erstellte IAM-Rolle über die entsprechenden Berechtigungen verfügt.

**So testen Sie die -Funktion**

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

1. Wählen Sie **Neues Ereignis erstellen** und gehen Sie wie folgt vor:
   + Geben Sie für **Event name (Ereignisname)** einen Namen für das Testereignis ein, z. B. **MyPhoneNumber**.
   + Löschen Sie den Beispielcode im Code-Editor. Fügen Sie folgenden Code ein:

     ```
     {
       "destinationNumber": "+12065550142",
       "firstName": "Carlos",
       "lastName": "Salazar",
       "source": "Registration form test"
     }
     ```
   + Ersetzen Sie im vorhergehenden Codebeispiel die Werte der Attribute `destinationNumber`, `firstName` und `lastName` durch die Werte, die Sie zum Testen verwenden möchten, wie beispielsweise Ihre persönlichen Kontaktdaten. Wenn Sie diese Funktion testen, sendet sie eine SMS an die Telefonnummer, die Sie im Attribut `destinationNumber` angeben. Stellen Sie sicher, dass die von Ihnen angegebene Telefonnummer in der Lage ist, SMS-Nachrichten zu empfangen.
   + Wählen Sie **Erstellen** aus.

1. Wählen Sie **Test** aus.

1. Wählen Sie unter **Execution result: succeeded (Ausführungsergebnis: erfolgreich)** die Option **Details** aus. Überprüfen Sie im Abschnitt **Log output (Protokollausgabe)** die Ausgabe der Funktion. Stellen Sie sicher, dass die Funktion fehlerfrei ausgeführt wurde.

   Überprüfen Sie das Gerät, das der von Ihnen angegebenen `destinationNumber` zugeordnet ist, um sicherzustellen, dass es die Testnachricht empfangen hat.

1. Öffnen Sie die Amazon Pinpoint Pinpoint-Konsole unter [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/).

1. Wählen Sie auf der Seite **Alle Projekte** das Projekt aus, das Sie unter [Amazon Pinpoint Pinpoint-Projekt erstellen](tutorials-two-way-sms-part-1.md#tutorials-two-way-sms-part-1-create-project) erstellt haben.

1. Wählen Sie im Navigationsbereich die Option **Segments (Segmente)** aus. Wählen Sie auf der Seite **Segments (Segmente)** die Option **Create a segment (Ein Segment erstellen)** aus.

1. Wählen Sie in **Segment group 1 (Segmentgruppe 1)** unter **Add filters to refine your segment (Filter zur Optimierung des Segments hinzufügen** die Option **Filter by user (Nach Benutzer filtern)** aus.

1. **Wählen Sie unter Benutzerattribut** auswählen die Option **FirstName**. Wählen Sie dann unter **Choose values (Werte auswählen)** den Vornamen aus, den Sie im Testereignis angegeben haben.

   Im Abschnitt **Segment estimate (Segmentschätzung)** sollte angezeigt werden, dass es keine qualifizierten Endpunkte und insgesamt einen Endpunkt gibt, wie in der folgenden Abbildung gezeigt. Dieses Ergebnis wird erwartet. Wenn die Funktion einen neuen Endpunkt erstellt, ist der Endpunkt deaktiviert. Segmente in Amazon Pinpoint schließen automatisch deaktivierte Endpunkte aus.  
![\[Die Segmentgruppe, die keine Endpunkte anzeigt.\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_LAM_Step8.9.png)

## Erstellen der Funktion, die Kunden für Ihre Kommunikation aktiviert
<a name="tutorials-two-way-sms-part-3-create-optin-function"></a>

Die zweite Funktion wird nur ausgeführt, wenn ein Kunde auf die Nachricht antwortet, die von der ersten Funktion gesendet wurde. Wenn die Antwort des Kunden das Schlüsselwort enthält, das Sie unter [Bidirektionale SMS aktivieren](tutorials-two-way-sms-part-1.md#tutorials-two-way-sms-part-1-set-up-channel) angegeben haben, aktualisiert die Funktion seinen Endpunktdatensatz, um ihn für future Mitteilungen anzumelden. Amazon Pinpoint antwortet auch automatisch mit der Nachricht, die Sie unter [Bidirektionale SMS aktivieren](tutorials-two-way-sms-part-1.md#tutorials-two-way-sms-part-1-set-up-channel) angegeben haben.

Wenn der Kunde nicht antwortet oder seine Antwort das angegebene Schlüsselwort nicht enthält, dann passiert nichts. Der Endpunkt des Kunden bleibt in Amazon Pinpoint, aber Segmente können ihn nicht anvisieren.

**So erstellen Sie die Lambda-Funktion:**

1. Öffnen Sie die AWS Lambda Konsole unter. [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/)

1. Wählen Sie **Funktion erstellen**.

1. Wählen Sie unter **Create function (Funktion erstellen)** die Option **Blueprints** aus.

1. Geben Sie im Suchfeld **hello** ein und drücken Sie dann die Eingabetaste. Wählen Sie in der Ergebnisliste die Node.js-Funktion `hello-world` aus, wie im folgenden Bild gezeigt. Wählen Sie **Konfigurieren** aus.

1. Führen Sie unter **Basic information** (Grundlegende Informationen) die folgenden Schritte aus:
   + Geben Sie für **Name** einen Namen für die Funktion ein, z. B. **RegistrationForm\$1OptIn**.
   + Wählen Sie für **Role (Rolle)** die Option **Choose an existing role (Eine vorhandene Rolle wählen)** aus.
   + Wählen Sie unter **Existierende Rolle** die SMSRegistration Formularrolle aus, die Sie unter [IAM-Rolle erstellen](tutorials-two-way-sms-part-2.md#tutorials-two-way-sms-part-2-create-role) erstellt haben.

   Wenn Sie fertig sind, klicken Sie auf **Create function (Funktion erstellen)**.

1. Löschen Sie die Beispielfunktion im Code-Editor und fügen Sie dann den folgenden Code ein:

   ```
   import { PinpointClient, UpdateEndpointCommand } from "@aws-sdk/client-pinpoint"; // ES Modules import
   
   // Create a new Pinpoint client instance with the region specified in the environment variables
   const pinClient = new PinpointClient({ region: process.env.region });
   
   // Get the Pinpoint project ID and the confirm keyword from environment variables
   const projectId = process.env.projectId;
   const confirmKeyword = process.env.confirmKeyword.toLowerCase();
   
   // This is the main handler function that is invoked when the Lambda function is triggered
   export const handler = async (event, context) => {
       console.log('Received event:', event);
   
       try {
           // Extract the timestamp, message, and origination number from the SNS event
           const timestamp = event.Records[0].Sns.Timestamp;
           const message = JSON.parse(event.Records[0].Sns.Message);
           const originationNumber = message.originationNumber;
           const response = message.messageBody.toLowerCase();
   
           // Check if the response message contains the confirm keyword
           if (response.includes(confirmKeyword)) {
               // If the confirm keyword is found, update the endpoint's opt-in status
               await updateEndpointOptIn(originationNumber, timestamp);
           }
       }catch (error) {
           console.error('An error occurred:', error);
           throw error; // Rethrow the error to handle it upstream
       }
   };
   
   // This function updates the opt-in status of a Pinpoint endpoint
   async function updateEndpointOptIn(originationNumber, timestamp) {
       // Extract the endpoint ID from the origination number
       const endpointId = originationNumber.substring(1);
   
        // Prepare the parameters for the UpdateEndpointCommand
       const params = {
           ApplicationId: projectId,
           EndpointId: endpointId,
           EndpointRequest: {
               Address: originationNumber,
               ChannelType: 'SMS',
               OptOut: 'NONE',
               Attributes: {
                   OptInTimestamp: [timestamp]
               },
           }
       };
   
       try {
           // Send the UpdateEndpointCommand to update the endpoint's opt-in status
           const updateEndpointResponse = await pinClient.send(new UpdateEndpointCommand(params));
           console.log(updateEndpointResponse);
           console.log(`Successfully changed the opt status of endpoint ID ${endpointId}`);
       } catch (error) {
           console.error('An error occurred while updating endpoint:', error);
           throw error; // Rethrow the error to handle it upstream
       }
   }
   ```

1. Gehen Sie unter **Environment variables (Umgebungsvariablen)** wie folgt vor:
   + Erstellen Sie in der ersten Zeile eine Variable mit dem Schlüssel **projectId**. Als Nächstes setzen Sie den Wert auf die eindeutige ID des Projekts, das Sie unter [Amazon Pinpoint Pinpoint-Projekt erstellen](tutorials-two-way-sms-part-1.md#tutorials-two-way-sms-part-1-create-project) erstellt haben.
   + Erstellen Sie in der zweiten Zeile eine Variable mit dem Schlüssel **region**. Stellen Sie als Nächstes den Wert auf die Region ein, in der Sie Amazon Pinpoint verwenden, z. B. **us-east-1** oder **us-west-2**.
   + Erstellen Sie in der dritten Zeile eine Variable mit einem Schlüssel von **confirmKeyword**. Stellen Sie als Nächstes den Wert auf das Bestätigungsschlüsselwort ein, das Sie unter [Bidirektionale SMS aktivieren](tutorials-two-way-sms-part-1.md#tutorials-two-way-sms-part-1-set-up-channel) erstellt haben.
**Anmerkung**  
Das Schlüsselwort wird nicht nach Groß- und Kleinschreibung unterschieden. Diese Funktion wandelt die eingehende Nachricht in Kleinbuchstaben um.

   Wenn Sie fertig sind, sollte der Abschnitt **Environment Variables (Umgebungsvariablen)** dem in der folgenden Abbildung gezeigten Beispiel entsprechen.  
![\[Die Umgebungsvariablen für projectId, Region und ConfirmKeyword.\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_LAM_Step2.7.png)

1. Wählen Sie oben auf der Seite **Save** aus.

### Testen der Funktion
<a name="tutorials-two-way-sms-part-3-create-optin-function-test"></a>

Nachdem Sie die Funktion erstellt haben, sollten Sie sie testen, um sich zu vergewissern, dass sie richtig konfiguriert ist. Stellen Sie außerdem sicher, dass die von Ihnen erstellte IAM-Rolle über die entsprechenden Berechtigungen verfügt.

**So testen Sie die -Funktion**

1. Wählen Sie **Test** aus.

1. Führen Sie im Fenster **Configure test event (Testereignis konfigurieren)** die folgenden Schritte aus:

   1. Wählen Sie **Create new test event** aus.

   1. Geben Sie für **Event name (Ereignisname)** einen Namen für das Testereignis ein, z. B. **MyResponse**.

   1. Löschen Sie den Beispielcode im Code-Editor. Fügen Sie folgenden Code ein:

      ```
      {
        "Records":[
          {
            "Sns":{
              "Message":"{\"originationNumber\":\"+12065550142\",\"messageBody\":\"Yes\"}",
              "Timestamp":"2019-02-20T17:47:44.147Z"
            }
          }
        ]
      }
      ```

      Ersetzen Sie im vorigen Codebeispiel die Werte des Attributs `originationNumber` durch die Telefonnummer, die Sie verwendet haben, als Sie die vorherige Lambda-Funktion getestet haben. [Ersetzen Sie den Wert von `messageBody` durch das bidirektionale SMS-Schlüsselwort, das Sie unter Bidirektionale SMS aktivieren angegeben haben.](tutorials-two-way-sms-part-1.md#tutorials-two-way-sms-part-1-enable-two-way) Optional können Sie den Wert von `Timestamp` durch das aktuelle Datum und die aktuelle Uhrzeit ersetzen.

   1. Wählen Sie **Erstellen** aus.

1. Wählen Sie erneut **Test (Testen)** aus.

1. Wählen Sie unter **Execution result: succeeded (Ausführungsergebnis: erfolgreich)** die Option **Details** aus. Überprüfen Sie im Abschnitt **Log output (Protokollausgabe)** die Ausgabe der Funktion. Stellen Sie sicher, dass die Funktion fehlerfrei ausgeführt wurde.

1. Öffnen Sie die Amazon Pinpoint Pinpoint-Konsole unter [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/).

1. Wählen Sie auf der Seite **Alle Projekte** das Projekt aus, das Sie unter [Amazon Pinpoint Pinpoint-Projekt erstellen](tutorials-two-way-sms-part-1.md#tutorials-two-way-sms-part-1-create-project) erstellt haben.

1. Wählen Sie im Navigationsbereich die Option **Segments (Segmente)** aus. Wählen Sie auf der Seite **Segments (Segmente)** die Option **Create a segment (Ein Segment erstellen)** aus.

1. Wählen Sie in **Segment group 1 (Segmentgruppe 1)** unter **Add filters to refine your segment (Filter zur Optimierung des Segments hinzufügen** die Option **Filter by user (Nach Benutzer filtern)** aus.

1. **Wählen Sie unter Benutzerattribut** auswählen die Option **FirstName**. Wählen Sie dann unter **Choose values (Werte auswählen)** den Vornamen aus, den Sie im Testereignis angegeben haben.

   Im Abschnitt **Segment estimate (Segmentschätzung)** sollte angezeigt werden, dass es einen qualifizierten Endpunkt und insgesamt einen Endpunkt gibt.

**Weiter**: [Einrichten von Amazon API Gateway](tutorials-two-way-sms-part-4.md)

# Amazon API Gateway für SMS-Nachrichten in Amazon Pinpoint einrichten
<a name="tutorials-two-way-sms-part-4"></a>

In diesem Abschnitt erstellen Sie eine neue API, indem Sie Amazon API Gateway als Teil der SMS-Registrierung für Amazon Pinpoint verwenden. Das Registrierungsformular, das Sie in dieser Lösung bereitstellen, ruft diese API auf. API Gateway leitet dann die Informationen, die auf dem Registrierungsformular erfasst wurden, an die Lambda-Funktion weiter, die Sie unter Lambda-Funktionen [erstellen](tutorials-two-way-sms-part-3.md) erstellt haben.

## Erstellen der -API
<a name="tutorials-two-way-sms-part-4-create-api"></a>

Zunächst müssen Sie eine neue API in API Gateway erstellen. Das folgende Verfahren zeigt, wie Sie eine neue REST-API erstellen.

**So erstellen Sie eine neue API**

1. Öffnen Sie die API Gateway Gateway-Konsole unter [https://console.aws.amazon.com/apigateway/](https://console.aws.amazon.com/apigateway/). 

1. Wählen Sie **Create API** (API erstellen) aus. Treffen Sie die folgende Auswahl:
   + Wählen Sie unter **Choose the protocol (Das Protokoll auswählen)** die Option **REST** aus.
   + Wählen Sie unter **Create new API (Neue API erstellen)** die Option **New API (Neue API)** aus.
   + Geben Sie unter **Settings (Einstellungen)** für **Name** einen Namen ein, z. B. **RegistrationForm**. Geben Sie optional im Feld **Description (Beschreibung)** einen Text zum Verwendungszweck der API ein. Wählen Sie für **Endpoint Type (Endpunkttyp)** die Option **Regional** aus. Wählen Sie dann die Option **Create API (API erstellen)** aus.

   Ein Beispiel für diese Einstellungen sehen Sie in der folgenden Abbildung.  
![\[Protokoll ist auf REST eingestellt, Neue API erstellen ist auf Neue API eingestellt, API-Name ist auf RegistrationForm eingestellt und Endpunkttyp ist auf Regional eingestellt.\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step2.png)

## Erstellen einer Ressource
<a name="tutorials-two-way-sms-part-4-create-resource"></a>

Nachdem Sie eine API erstellt haben, können Sie damit beginnen, Ressourcen hinzuzufügen. Fügen Sie danach eine POST-Methode zur Ressource hinzu und weisen API Gateway an, die Daten, die Sie über diese Methode empfangen, an Ihre Lambda-Funktion zu übergeben.

1. Wählen Sie im Menü **Actions (Aktionen)** die Option **Create Ressource (Ressource erstellen)** aus. Geben Sie im Bereich **New Child Resource (Neue untergeordnete Ressource)** unter **Resource Name (Name der Ressource)** **register** ein, wie in der folgenden Abbildung dargestellt. Wählen Sie **Create Resource** (Ressource erstellen) aus.  
![\[Der neue untergeordnete Ressourcenbereich, für den der Ressourcenname auf „Registrierung“ gesetzt ist.\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step3.png)

1. Wählen Sie im Menü **Actions (Aktionen)** die Option **Create Method (Methode erstellen)** aus. Wählen Sie im angezeigten Menü die Option **POST** aus, wie in der folgenden Abbildung dargestellt. Wählen Sie dann die Schaltfläche mit dem **Häkchen**.  
![\[Der Bereich „Methode erstellen“ mit ausgewähltem Häkchen.\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step4.png)

1. Wählen Sie im Bereich **/register – POST – Setup** folgende Optionen aus:
   + Für **Integration type (Integrationstyp)** wählen Sie **Lambda Function (Lambda-Funktion)**.
   + Wählen Sie die Option **Lambda-Proxy-Integration verwenden** aus.
   + Wählen Sie für die **Lambda-Region** die Region aus, in der Sie die Lambda-Funktion erstellt haben.
   + Wählen Sie für **Lambda-Funktion** die RegisterEndpoint Funktion aus, die Sie unter [Lambda-Funktionen erstellen](tutorials-two-way-sms-part-3.md) erstellt haben.

   Ein Beispiel für diese Einstellungen sehen Sie in der folgenden Abbildung.  
![\[Der Bereich /register — POST — Setup mit ausgewählter Lambda-Funktion.\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step5.png)

   Wählen Sie **Speichern**. Klicken Sie im Fenster, das angezeigt wird, auf **OK**, um API Gateway die Berechtigung zu erteilen, Ihre Lambda-Funktion auszuführen.

## Bereitstellen der API
<a name="tutorials-two-way-sms-part-4-deploy-api"></a>

Die API ist jetzt einsatzbereit. An diesem Punkt müssen Sie sie bereitstellen, um einen öffentlich zugänglichen Endpunkt zu erstellen.

1. Wählen Sie im Menü **Actions (Aktionen)** die Option **Deploy API (API bereitstellen)** aus. Wählen Sie im Fenster **Deploy API (API bereitstellen)** folgende Optionen aus:
   + Wählen Sie für **Deployment stage (Bereitstellungsstufe)** **[New Stage] ([Neue Stufe])** aus.
   + Geben Sie für **Stage name (Stufenname)** **v1** ein.
   + Wählen Sie **Deploy (Bereitstellen)** aus.

   Ein Beispiel für diese Auswahl ist in der folgenden Abbildung dargestellt.  
![\[Das Deploy-API-Fenster, bei dem der Stage-Name auf v1 gesetzt ist\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step6.png)

1. Wählen Sie im Bereich **v1 Stage Editor** die Ressource **/register** aus und anschließend die Methode **POST**. Kopieren Sie die Adresse, die neben **Invoke URL (URL aufrufen)** angezeigt wird, wie in der folgenden Abbildung dargestellt.  
![\[Der v1-Bereich des Stage Editors mit der Aufruf-URL, die kopiert werden soll\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step7.png)

1. Wählen Sie im Navigationsbereich **Resources** aus. Klicken Sie in der Liste der Ressourcen auf die Ressource **/register**. Wählen Sie schließlich im Menü **Actions (Aktionen)** die Option **Enable CORS (CORS aktivieren)** aus, wie in der folgenden Abbildung dargestellt.  
![\[Im Dropdownmenü für Aktionen wird angezeigt, dass „CORS aktivieren“ ausgewählt ist\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step8.png)

1. Wählen Sie im Bereich **Enable CORS (CORS aktivieren)** die Option **Enable CORS and replace existing CORS headers (CORS aktivieren und bestehende CORS-Header ersetzen)** aus.

**Nächster Schritt**: [Erstellen und Bereitstellen des Webformulars](tutorials-two-way-sms-part-5.md)

# Erstellen und Bereitstellen des Webformulars zur Verwendung von SMS-Nachrichten für Amazon Pinpoint
<a name="tutorials-two-way-sms-part-5"></a>

Alle Komponenten, die AWS Dienste für SMS-Nachrichten mit Amazon Pinpoint verwenden, sind jetzt vorhanden. Der letzte Schritt besteht in der Erstellung und Bereitstellung des Webformulars, das die Kundendaten erfasst.

## Erstellen Sie den JavaScript Formular-Handler
<a name="tutorials-two-way-sms-part-5-create-form-handler"></a>

In diesem Abschnitt erstellen Sie eine JavaScript Funktion, die den Inhalt des Webformulars analysiert, das Sie im nächsten Abschnitt erstellen. Nach dem Parsen des Inhalts sendet diese Funktion die Daten an die API, die Sie unter [Amazon API Gateway einrichten](tutorials-two-way-sms-part-4.md) erstellt haben.

**So erstellen Sie den Form Handler**

1. Erstellen Sie in einem Texteditor eine neue Datei.

1. Fügen Sie folgenden Code in den Editor ein:

   ```
   $(document).ready(function() {
   
     // Handle form submission.
     $("#submit").click(function(e) {
   
       var firstName = $("#firstName").val(),
           lastName = $("#lastName").val(),
           source = window.location.pathname,
           optTimestamp = undefined,
           utcSeconds = Date.now() / 1000,
           timestamp = new Date(0),
           phone = $("#areaCode").val()
                 + $("#phone1").val()
                 + $("#phone2").val();
   
       e.preventDefault();
   
       if (firstName == "") {
         $('#form-response').html('<div class="mt-3 alert alert-info" role="alert">Please enter your first name.</div>');
       } else if (lastName == "") {
         $('#form-response').html('<div class="mt-3 alert alert-info" role="alert">Please enter your last name.</div>');
       } else if (phone.match(/[^0-9]/gi)) {
         $('#form-response').html('<div class="mt-3 alert alert-info" role="alert">Your phone number contains invalid characters. Please check the phone number that you supplied.</div>');
       } else if (phone.length < 10) {
         $('#form-response').html('<div class="mt-3 alert alert-info" role="alert">Please enter your phone number.</div>');
       } else if (phone.length > 10) {
         $('#form-response').html('<div class="mt-3 alert alert-info" role="alert">Your phone number contains too many digits. Please check the phone number that you supplied.</div>');
       } else {
         $('#submit').prop('disabled', true);
         $('#submit').html('<span class="spinner-border spinner-border-sm" role="status" aria-hidden="true"></span>  Saving your preferences</button>');
   
         timestamp.setUTCSeconds(utcSeconds);
   
         var data = JSON.stringify({
           'destinationNumber': phone,
           'firstName': firstName,
           'lastName': lastName,
           'source': source,
           'optTimestamp': timestamp.toString()
         });
   
         $.ajax({
           type: 'POST',
           url: 'https://example.execute-api.us-east-1.amazonaws.com/v1/register',
           contentType: 'application/json',
           data: data,
           success: function(res) {
             $('#form-response').html('<div class="mt-3 alert alert-success" role="alert"><p>Congratulations! You&apos;ve successfully registered for SMS Alerts from ExampleCorp.</p><p>We just sent you a message. Follow the instructions in the message to confirm your subscription. We won&apos;t send any additional messages until we receive your confirmation.</p><p>If you decide you don&apos;t want to receive any additional messages from us, just reply to one of our messages with the keyword STOP.</p></div>');
             $('#submit').prop('hidden', true);
             $('#unsubAll').prop('hidden', true);
             $('#submit').text('Preferences saved!');
           },
           error: function(jqxhr, status, exception) {
             $('#form-response').html('<div class="mt-3 alert alert-danger" role="alert">An error occurred. Please try again later.</div>');
             $('#submit').text('Save preferences');
             $('#submit').prop('disabled', false);
           }
         });
       }
     });
   });
   ```

1. Ersetzen Sie dies im vorherigen Beispiel durch die *https://example.execute-api.us-east-1.amazonaws.com/v1/register* Aufruf-URL, die Sie in [Deploy the](tutorials-two-way-sms-part-4.md#tutorials-two-way-sms-part-4-deploy-api) API abgerufen haben.

1. Speichern Sie die Datei.

## Erstellen Sie die Formulardatei
<a name="tutorials-two-way-sms-part-5-create-form"></a>

In diesem Abschnitt erstellen Sie eine HTML-Datei, die das Formular enthält, das Kunden zur Registrierung für Ihr SMS-Programm verwenden. Diese Datei verwendet den JavaScript Formular-Handler, den Sie im vorherigen Abschnitt erstellt haben, um die Formulardaten an Ihre Lambda-Funktion zu übertragen.

**Wichtig**  
Wenn ein Benutzer dieses Formular übermittelt, löst es eine Lambda-Funktion aus, die mehrere Amazon-Pinpoint-API-Operationen aufruft. Böswillige Benutzer könnten einen Angriff auf Ihr Formular starten, der dazu führen kann, dass sehr viele Anfragen gestellt werden. Wenn Sie diese Lösung für einen Anwendungsfall in einer Produktionsumgebung verwenden möchten, sollten Sie sie mithilfe eines Systems wie z. B. [Google reCAPTCHA](https://www.google.com/recaptcha/about/) schützen.

**So erstellen Sie das Formular**

1. Erstellen Sie in einem Texteditor eine neue Datei.

1. Fügen Sie folgenden Code in den Editor ein:

   ```
   <!doctype html>
   <html lang="en">
   
   <head>
     <!-- Meta tags required by Bootstrap -->
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
   
     <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/css/bootstrap.min.css" integrity="sha384-ggOyR0iXCbMQv3Xipma34MD+dH/1fQ784/j6cY/iJTQUOhcWr7x9JvoRxT2MZw1T" crossorigin="anonymous">
     <script src="https://code.jquery.com/jquery-3.3.1.slim.min.js" integrity="sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo" crossorigin="anonymous"></script>
     <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.7/umd/popper.min.js" integrity="sha384-UO2eT0CpHqdSJQ6hJty5KVphtPhzWj9WO1clHTMGa3JDZwrnQq4sF86dIHNDz0W1" crossorigin="anonymous"></script>
     <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.3.1/js/bootstrap.min.js" integrity="sha384-JjSmVgyd0p3pXB1rRibZUAYoIIy6OrQ6VrjIEaFf/nJGzIxFDsf4x0xIM+B07jRM" crossorigin="anonymous"></script>
     <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
   
     <script type="text/javascript" src="SMSFormHandler.js"></script>
     <title>SMS Registration Form</title>
   </head>
   
   <body>
     <div class="container">
       <div class="row justify-content-center mt-3">
         <div class="col-md-6">
           <h1>Register for SMS Alerts</h1>
           <p>Enter your phone number below to sign up for PromotionName messages from ExampleCorp.</p>
           <p>We don't share your contact information with anyone else. For more information, see our <a href="http://example.com/privacy">Privacy Policy</a>.</p>
           <p>ExampleCorp alerts are only available to recipients in the United States.</p>
         </div>
       </div>
       <div class="row justify-content-center">
         <div class="col-md-6">
           <form>
             <div class="form-group">
               <label for="firstName" class="font-weight-bold">First name</label>
               <input type="text" class="form-control" id="firstName" placeholder="Your first name" required>
             </div>
             <div class="form-group">
               <label for="lastName" class="font-weight-bold">Last name</label>
               <input type="text" class="form-control" id="lastName" placeholder="Your last name" required>
             </div>
             <label for="areaCode" class="font-weight-bold">Phone number</label>
             <div class="input-group">
               <span class="h3">(&nbsp;</span>
               <input type="tel" class="form-control" id="areaCode" placeholder="Area code" required>
               <span class="h3">&nbsp;)&nbsp;</span>
               <input type="tel" class="form-control" id="phone1" placeholder="555" required>
               <span class="h3">&nbsp;-&nbsp;</span>
               <input type="tel" class="form-control" id="phone2" placeholder="0199" required>
             </div>
             <div id="form-response"></div>
             <button id="submit" type="submit" class="btn btn-primary btn-block mt-3">Submit</button>
           </form>
         </div>
       </div>
       <div class="row mt-3">
         <div class="col-md-12 text-center">
           <small class="text-muted">Copyright © 2019, ExampleCorp or its affiliates.</small>
         </div>
       </div>
     </div>
   </body>
   
   </html>
   ```

1. Ersetzen Sie im vorherigen Beispiel *SMSFormHandler.js* durch den vollständigen Pfad zur JavaScript Formular-Handler-Datei, die Sie im vorherigen Abschnitt erstellt haben.

1. Speichern Sie die Datei.

## Laden Sie die Formulardateien hoch
<a name="tutorials-two-way-sms-part-5-upload-form"></a>

Nachdem Sie das HTML-Formular und den JavaScript Formular-Handler erstellt haben, besteht der letzte Schritt darin, diese Dateien im Internet zu veröffentlichen. Dieser Abschnitt geht davon aus, dass Sie einen bestehenden Webhosting-Anbieter haben. Wenn Sie noch keinen Hosting-Anbieter haben, können Sie mithilfe von Amazon Route 53, Amazon Simple Storage Service (Amazon S3) und Amazon eine Website starten CloudFront. Weitere Informationen finden Sie unter [Hosten einer statischen Website](https://aws.amazon.com/getting-started/hands-on/host-static-website/).

Wenn Sie einen anderen Webhosting-Anbieter verwenden, lesen Sie die Dokumentation des Anbieters, um weitere Informationen zur Veröffentlichung von Webseiten zu erhalten.

## Testen des Formulars
<a name="tutorials-two-way-sms-part-5-test-form"></a>

Nachdem Sie das Formular veröffentlicht haben, sollten Sie einige Testereignisse übermitteln, um sicherzustellen, dass es wie erwartet funktioniert.

**So testen Sie das Registrierungsformular**

1. Navigieren Sie in einem Webbrowser zu dem Ort, an dem Sie das Anmeldeformular hochgeladen haben. Wenn Sie das Codebeispiel aus [Create the JavaScript form handler](#tutorials-two-way-sms-part-5-create-form) verwendet haben, sehen Sie ein Formular, das dem Beispiel in der folgenden Abbildung ähnelt.  
![\[Das in Schritt 5.1 erstellte Kundenanfrageformular.\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_Form_Step5.3.1.png)

1. Geben Sie Ihre Kontaktinformationen in die Felder **First name (Vorname)**, **Last name (Nachname)** und **Phone number (Telefonnummer)** ein.
**Anmerkung**  
Wenn Sie das Formular absenden, versucht Amazon Pinpoint, eine Nachricht an die von Ihnen angegebene Telefonnummer zu senden. Aufgrund dieser Funktionalität sollten Sie eine echte Telefonnummer verwenden, um die Lösung von Anfang bis Ende testen zu können.  
Wenn Sie die Lambda-Funktion unter [Lambda-Funktionen erstellen](tutorials-two-way-sms-part-3.md) getestet haben, enthält Ihr Amazon Pinpoint Pinpoint-Projekt bereits mindestens einen Endpunkt. Wenn Sie dieses Formular testen, sollten Sie entweder eine andere Telefonnummer auf dem Formular angeben oder den vorhandenen Endpunkt mithilfe der [DeleteEndpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-endpoints-endpoint-id.html#DeleteEndpoint)API-Operation löschen.

1. Überprüfen Sie das Gerät, das der von Ihnen angegebenen Telefonnummer zugeordnet ist, um sicherzustellen, dass es die Nachricht empfangen hat.

1. Öffnen Sie die Amazon Pinpoint Pinpoint-Konsole unter [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/).

1. Wählen Sie auf der Seite **Alle Projekte** das Projekt aus, das Sie unter [Amazon Pinpoint Pinpoint-Projekt erstellen](tutorials-two-way-sms-part-1.md#tutorials-two-way-sms-part-1-create-project) erstellt haben.

1. Wählen Sie im Navigationsbereich die Option **Segments (Segmente)** aus. Wählen Sie auf der Seite **Segments (Segmente)** die Option **Create a segment (Ein Segment erstellen)** aus.

1. Wählen Sie in **Segment group 1 (Segmentgruppe 1)** unter **Add filters to refine your segment (Filter zur Optimierung des Segments hinzufügen** die Option **Filter by user (Nach Benutzer filtern)** aus.

1. **Wählen Sie unter Benutzerattribut** auswählen die Option **FirstName**. Wählen Sie dann für **Choose values (Werte auswählen)** den ersten Namen aus, den Sie angegeben haben, als Sie das Formular übermittelt haben.

   Im Abschnitt **Segment estimate (Segmentschätzung)** sollte angezeigt werden, dass es keine qualifizierten Endpunkte und insgesamt einen Endpunkt (unter „Total endpoints (Endpunkte gesamt)“) gibt, wie in der folgenden Abbildung gezeigt. Dieses Ergebnis wird erwartet. Wenn die Lambda-Funktion einen neuen Endpunkt erstellt, wird der Endpunkt standardmäßig deaktiviert.  
![\[Ein Segment mit null ausgewählten Endpunkten.\]](http://docs.aws.amazon.com/de_de/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_LAM_Step8.9.png)

1. Beantworten Sie die Nachricht auf dem Gerät, das die Nachricht erhalten hat, mit dem bidirektionalen SMS-Schlüsselwort, das Sie unter [Bidirektional-SMS aktivieren](tutorials-two-way-sms-part-1.md#tutorials-two-way-sms-part-1-enable-two-way) angegeben haben. Amazon Pinpoint sendet sofort eine Antwortnachricht.

1. Wiederholen Sie in der Amazon-Pinpoint-Konsole die Schritte 4 bis 8. Dieses Mal sehen Sie, wenn Sie das Segment erstellen, einen qualifizierten Endpunkt und einen Endpunkt insgesamt. Dieses Ergebnis wird erwartet, da der Endpunkt jetzt qualifiziert ist.

# Nächste Schritte
<a name="tutorials-two-way-sms-next-steps"></a>

In dem abgeschlossenen Tutorial haben Sie Folgendes getan:
+ Ein Amazon-Pinpoint-Projekt erstellt, den SMS-Kanal konfiguriert und eine dedizierte Langwahlnummer abgerufen.
+ Eine IAM-Richtlinie erstellt, die das Prinzip der geringsten Berechtigung verwendet, um Zugriffsrechte zu erteilen, und diese Richtlinie mit einer Rolle verknüpft.
+ Es wurden zwei Lambda-Funktionen erstellt, die die SendMessages Operationen PhoneNumberValidate UpdateEndpoint, und in der Amazon Pinpoint Pinpoint-API verwenden.
+ Hat eine REST-API mit API Gateway erstellt.
+ Ein webbasiertes Formular erstellt und bereitgestellt, das Kontaktinformationen von Kunden erfasst.
+ Die Lösung getestet, um sicherzustellen, dass sie funktioniert.

In diesem Abschnitt werden einige Möglichkeiten erläutert, wie Sie die Kundendaten nutzen können, die Sie mit dieser Lösung erfassen. Er enthält auch einige Vorschläge, wie Sie diese Lösung für Ihren individuellen Anwendungsfall anpassen können.

## Erstellen von Kundensegmenten
<a name="tutorials-two-way-sms-next-steps-create-segments"></a>

Alle Kundendaten, die Sie über dieses Formular erfassen, werden als Endpunkte gespeichert. Diese Lösung erstellt Endpunkte, die mehrere Attribute enthalten, die Sie für die Segmentierung verwenden können.

Diese Lösung erfasst beispielsweise ein Endpunktattribut namens `Source`. Dieses Attribut enthält den vollständigen Pfad zu dem Ort, an dem das Formular gehostet wurde. Wenn Sie ein Segment erstellen, können Sie das Segment nach Endpunkt filtern und dann den Filter weiter verfeinern, indem Sie ein `Source`-Attribut auswählen.

Das Erstellen von Segmenten basierend auf dem Attribut `Source` kann auf mehrere Weisen nützlich sein. Erstens können Sie damit schnell ein Segment von Kunden erstellen, die sich angemeldet haben, um von Ihnen SMS-Nachrichten zu erhalten. Darüber hinaus schließt das Segmentierungstool in Amazon Pinpoint automatisch Endpunkte aus, die nicht akzeptiert haben, Nachrichten zu erhalten.

Das Attribut `Source` ist auch nützlich, wenn Sie sich entscheiden, das Registrierungsformular an mehreren verschiedenen Orten zu hosten. Beispielsweise könnte sich Ihr Marketingmaterial auf ein Formular beziehen, das an einem Ort gehostet ist, während Kunden, die beim Surfen auf Ihrer Website auf das Formular stoßen, eine Version sehen können, die woanders gehostet ist. Wenn Sie dies tun, unterscheidet sich das Quellattribut für Kunden, die das Formular ausfüllen, nachdem sie Ihre Marketingmaterialien gesehen haben, von Kunden, die das Formular ausfüllen, nachdem sie es auf Ihrer Website gefunden haben. Sie können diesen Unterschied nutzen, um verschiedene Segmente zu erstellen und dann maßgeschneiderte Mitteilungen an jede dieser Zielgruppen zu senden.

## Senden personalisierter Kampagnennachrichten
<a name="tutorials-two-way-sms-next-steps-send-campaigns"></a>

Nachdem Sie Segmente angelegt haben, können Sie Kampagnen an diese Segmente senden. Wenn Sie Kampagnennachrichten erstellen, können Sie diese personalisieren, indem Sie angeben, welche Endpunktattribute Sie in die Nachricht aufnehmen möchten. Zum Beispiel verlangt das in dieser Lösung verwendete Webformular, dass der Kunde seinen Vor- und Nachnamen eingibt. Diese Werte werden in dem Benutzerdatensatz gespeichert, der dem Endpunkt zugeordnet ist.

Wenn Sie beispielsweise die API-Operation `GetEndpoint` verwenden, um Informationen über einen Endpunkt abzurufen, der mit dieser Lösung erstellt wurde, sehen Sie einen Abschnitt, der dem folgenden Beispiel ähnelt:

```
  ...
  "User": {
    "UserAttributes": {
      "FirstName": [
        "Carlos"
      ],
      "LastName": [
        "Salazar"
      ]
    }
  }
  ...
```

Wenn Sie die Werte dieser Attribute in Ihre Kampagnennachricht aufnehmen möchten, können Sie mit der Punktnotation auf das Attribut verweisen. Schließen Sie dann die gesamte Referenz in doppelte geschweifte Klammern ein. Um beispielsweise den Vornamen jedes Empfängers in eine Kampagnennachricht aufzunehmen, fügen Sie die folgende Zeichenfolge in die Nachricht ein: `{{User.UserAttributes.FirstName}}` Wenn Amazon Pinpoint die Nachricht sendet, ersetzt es die Zeichenkette durch den Wert des `FirstName`-Attributs.

## Verwenden des Formulars zum Sammeln zusätzlicher Informationen
<a name="tutorials-two-way-sms-next-steps-collect-additional"></a>

Sie können diese Lösung ändern, um zusätzliche Informationen auf dem Anmeldeformular zu sammeln. Sie könnten den Kunden beispielsweise bitten, seine Adresse anzugeben, und dann die Felder `Location.City`, `Location.Country`, `Location.Region` und `Location.PostalCode` in der Ressource `Endpoint` mit den Adressdaten ausfüllen. Das Sammeln von Adressinformationen auf dem Registrierungsformular kann dazu führen, dass der Endpunkt genauere Informationen enthält. Um diese Änderung vorzunehmen, müssen Sie dem Webformular die entsprechenden Felder hinzufügen. Sie müssen auch den JavaScript Code für das Formular ändern, um die neuen Werte zu übergeben. Schließlich müssen Sie die Lambda-Funktion, die den Endpunkt erzeugt, ändern, um die neuen eingehenden Informationen zu verarbeiten.

Sie können das Formular auch so ändern, dass es Kontaktinformationen in anderen Kanälen sammelt. Beispielsweise können Sie mit dem Formular neben der Telefonnummer auch die E-Mail-Adresse des Kunden erfassen. Um diese Änderung vorzunehmen, müssen Sie den HTML-Code und JavaScript das Webformular ändern. Sie müssen auch die Lambda-Funktion, die den Endpunkt erstellt, so ändern, dass sie zwei getrennte Endpunkte erzeugt (einen für den E-Mail-Endpunkt und einen für den SMS-Endpunkt). Sie sollten außerdem die Lambda-Funktion so ändern, dass sie einen eindeutigen Wert für das Attribut `User.UserId` erzeugt und diesen Wert dann beiden Endpunkten zuordnet.

## Aufzeichnen zusätzlicher Attribute für Prüfungszwecke
<a name="tutorials-two-way-sms-next-steps-auditing"></a>

Diese Lösung zeichnet zwei wertvolle Attribute auf, wenn sie Endpunkte erstellt und aktualisiert. Erstens, wenn die erste Lambda-Funktion anfänglich den Endpunkt erzeugt, zeichnet sie die URL des Formulars selbst im Attribut `Attributes.Source` auf. Wenn der Kunde auf die Nachricht antwortet, erzeugt die zweite Lambda-Funktion ein Attribut `Attributes.OptInTimestamp`. Dieses Attribut enthält das genaue Datum und die genaue Uhrzeit, wann der Kunde seine Zustimmung gegeben hat, Nachrichten von Ihnen zu empfangen.

Beide Felder können nützlich sein, wenn Sie jemals von einem Mobilfunkbetreiber oder einer Regulierungsbehörde aufgefordert werden, die Zustimmung eines Kunden nachzuweisen. Sie können diese Informationen jederzeit mithilfe der [GetEndpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-endpoints-endpoint-id.html#GetEndpoint)API-Operation abrufen.

Sie können die Lambda-Funktionen auch ändern, um zusätzliche Daten zu erfassen, die für Prüfungszwecke nützlich sein können, wie z. B. die IP-Adresse, von der aus die Registrierungsanfrage gesendet wurde.