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.
# Mobiles Textnachrichten mit Amazon SNS
**Wichtig**
Der Amazon SNS SMS Developer Guide wurde aktualisiert. Amazon SNS hat sich [AWS End User Messaging SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html)für die Zustellung von SMS-Nachrichten integriert. Dieses Handbuch enthält die neuesten Informationen zur Erstellung, Konfiguration und Verwaltung Ihrer Amazon SNS SNS-SMS-Nachrichten.
Amazon SNS Mobile Text Messaging (SMS) wurde entwickelt, um die Nachrichtenzustellung an verschiedene Plattformen zu erleichtern, z. B. Web-, Mobil- und Geschäftsanwendungen, die SMS unterstützen. Benutzer können Nachrichten an eine oder mehrere Telefonnummern senden, indem sie ihnen ein Thema abonnieren, was den Verteilungsprozess vereinfacht.
Amazon SNS SNS-Nachrichten werden von zugestellt AWS End User Messaging SMS, wodurch eine zuverlässige Nachrichtenübertragung gewährleistet ist. In Amazon SNS APIs können Sie verschiedene Eigenschaften wie Nachrichtentypen (Werbe- oder Transaktionsnachrichten), [monatliche Ausgabenlimits](sms_preferences.md#sms_preferences_console), [Abmeldelisten](sms_manage.md#sms_manage_optout) und die Optimierung der [Nachrichtenzustellung](sms_preferences.md#sms_preferences_console) festlegen.
AWS End User Messaging SMS wickelt die Übertragung von Nachrichten an die Zieltelefonnummer über das globale SMS-Versorgungsnetz ab. Es verwaltet das Routing, den Lieferstatus und die erforderliche Einhaltung der regionalen Vorschriften. Informationen zum Zugriff auf zusätzliche SMS-Funktionen wie detaillierte Berechtigungen, Telefonpools, Konfigurationssätze, SMS-Simulator und Länderregeln finden Sie im [AWS End User Messaging SMS Benutzerhandbuch](https://docs.aws.amazon.com/sms-voice/latest/userguide/configurations.html).
![\[Eine Veranschaulichung, wie Amazon SNS integriert werden kann AWS End User Messaging SMS , um mobile Textnachrichten zuverlässig zu übermitteln. Nachrichten können direkt an einzelne Empfänger gesendet oder über Amazon SNS SNS-Themen an Gruppen verteilt werden. AWS End User Messaging SMS kümmert sich um die Weiterleitung, Zustellung und Einhaltung von Vorschriften für Nachrichten im gesamten globalen Netzwerk und gewährleistet so Skalierbarkeit und Zuverlässigkeit. Dieses Setup ermöglicht auch die Konfiguration von Nachrichteneinstellungen, die Verwaltung von Ausgabenlimits und die Nachverfolgung des Zustellungsstatus, um die AWS SMS Nachrichtenübermittlung zu optimieren.\]](http://docs.aws.amazon.com/de_de/sns/latest/dg/images/sns-sms-end-user-messaging.png)
Die folgenden Hauptfunktionen helfen Ihnen beim Senden von Amazon SNS SNS-SMS-Nachrichten, die skalierbar und leicht erweiterbar sind:
**[Passen Sie die Nachrichteneinstellungen an](sms_preferences.md)**
Passen Sie SMS-Lieferungen an Ihre Bedürfnisse an, AWS-Konto indem Sie SMS-Einstellungen einrichten, die auf Ihrem Budget und Anwendungsfall basieren. Sie können beispielsweise wählen, ob Ihre Nachrichten der Kosteneffizienz oder der zuverlässigen Zustellung Priorität einräumen.
**[Legen Sie Ausgabenquoten fest](channels-sms-awssupport-spend-threshold.md)**
Passen Sie Ihre SMS-Lieferungen an, indem Sie Ausgabenkontingente oder für einzelne Nachrichtenzustellungen und monatliche Ausgabenkontingente für Sie angeben AWS-Konto. Sofern dies nach lokalen Gesetzen und Vorschriften (z. B. in den USA und Kanada) erforderlich ist, können sich SMS-Empfänger [abmelden](sms_manage.md#sms_manage_optout), was bedeutet, dass sie sich dafür entscheiden, keine SMS-Nachrichten mehr von Ihnen zu erhalten AWS-Konto. Nachdem sich ein Empfänger vom Empfang von Nachrichten abgemeldet hat, können Sie die Telefonnummer mit Einschränkungen erneut angeben, sodass Sie mit dem Senden von Nachrichten fortfahren können.
**[Senden Sie SMS-Nachrichten weltweit](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-sms-by-country.html)**
Amazon SNS unterstützt SMS-Nachrichten in mehreren Regionen, sodass Sie Nachrichten in über 240 Länder und Regionen senden können.
## Wie stellt Amazon SNS meine SMS-Nachrichten zu?
Wenn Sie Amazon SNS bitten, in Ihrem Namen SMS zu senden, werden die Nachrichten über AWS End User Messaging SMS. Die Integration zwischen Amazon SNS und AWS End User Messaging SMS bietet die folgenden Vorteile:
**[IAM-Richtlinien](sns-mobile-phone-number-getting-started.md#sns-mobile-phone-number-prerequisites)**
Sie können IAM- und Ressourcenrichtlinien nutzen, um den Zugriff auf Ihre SMS-Ressourcen zu kontrollieren und auf andere AWS Dienste und Regionen zu verteilen.
**[AWS End User Messaging SMS -Konfigurationen](https://docs.aws.amazon.com/sms-voice/latest/userguide/configurations.html)**
Alle Konfigurationen im Zusammenhang mit der Origination ID (Erstellung, Aktualisierung der Konfiguration, Bereitstellung neuer Originationen IDs, Änderung von Registrierungsvorlagen) verwenden. AWS End User Messaging SMS
**[AWS End User Messaging SMS Abrechnung](https://aws.amazon.com/sns/sms-pricing/)**
Die gesamte SMS-Abrechnung ist jedoch abgeschlossen AWS End User Messaging SMS. Sie können Ihre AWS Ausgaben für Ihre SMS-Workloads konsolidieren und gleichzeitig Ihre SMS-Ressourcen an einem zentralen Ort beschaffen und verwalten.
# Erste Schritte mit Amazon SNS SMS
**Wichtig**
Der Amazon SNS SMS Developer Guide wurde aktualisiert. Amazon SNS hat sich [AWS End User Messaging SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html)für die Zustellung von SMS-Nachrichten integriert. Dieses Handbuch enthält die neuesten Informationen zur Erstellung, Konfiguration und Verwaltung Ihrer Amazon SNS SNS-SMS-Nachrichten.
Dieses Thema führt Sie durch die Verwaltung Ihrer SMS-Sandbox und die Konfiguration von IAM und ressourcenbasierten Richtlinien, um Amazon SNS die erforderlichen Berechtigungen für den Zugriff und die Nutzung von zu gewähren. AWS End User Messaging SMS APIs
## Voraussetzungen
Amazon SNS empfiehlt, Ihre IAM-Richtlinie um die folgenden Maßnahmen zu aktualisieren, um eine umfassende Kontrolle und Transparenz Ihrer Amazon SNS SNS-Ressourcen zu gewährleisten:
+ [`AmazonSNSFullAccess`](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonSNSFullAccess)
+ [`AmazonSNSReadOnly`](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonSNSReadOnlyAccess)
# Verwenden der Amazon SNS SMS-Sandbox
Neu erstellte Amazon SNS SNS-SMS-Konten werden automatisch in die SMS-Sandbox aufgenommen, um die Sicherheit von AWS Kunden und Empfängern zu gewährleisten, indem das Risiko von Betrug und Missbrauch minimiert wird. Diese Umgebung dient als sicherer Bereich für Test- und Entwicklungszwecke. Während Sie in der SMS-Sandbox arbeiten, haben Sie Zugriff auf alle Amazon SNS SNS-Funktionen, unterliegen jedoch bestimmten Einschränkungen:
+ Sie können SMS-Nachrichten nur an verifizierte Zieltelefonnummern senden.
+ Sie können über bis zu 10 verifizierte Zielrufnummern verfügen.
+ Sie können Ziel-Telefonnummern erst löschen, wenn seit der Überprüfung oder dem letzten Überprüfungsversuch mindestens 24 Stunden vergangen sind.
Sobald Ihr Konto die Sandbox verlassen hat, werden diese Einschränkungen aufgehoben, und Sie können SMS-Nachrichten an jeden Empfänger senden.
## Erste Schritte
Neue Amazon SNS SNS-SMS-Konten werden in einer SMS-Sandbox platziert. Gehen Sie wie folgt vor, um Telefonnummern in Ihrer Sandbox zu erstellen und zu verwalten, Ausgangsnummern und Absender zu erstellen und Ihr Unternehmen zu IDs registrieren.
1. Fügen Sie der SMS-Sandbox eine **Zieltelefonnummer** hinzu. Einzelheiten zum Hinzufügen, Verwalten und Verschieben von Telefonnummern aus der Amazon SNS SMS-Sandbox finden Sie unter. [Hinzufügen und Überprüfen von Telefonnummern in der Amazon SNS SMS-Sandbox](sns-sms-sandbox-verifying-phone-numbers.md)
1. Erstellen Sie eine **Absenderidentität**, die Ihre Empfänger auf ihren Geräten sehen, wenn Sie ihnen eine SMS-Nachricht senden. Weitere Informationen zu Herkunftsidentitäten, einschließlich der verschiedenen Typen, die Sie verwenden können, finden Sie in der Dokumentation. [Herkunftsidentitäten für Amazon SNS SNS-SMS-Nachrichten](channels-sms-originating-identities.md)
1. **Registrieren Sie** Ihr Unternehmen. In einigen Ländern müssen Sie die Identität Ihres Unternehmens registrieren, um Telefonnummern oder Absender kaufen IDs und die Nachrichten überprüfen zu können, die Sie an Empfänger in ihrem Land senden. Informationen darüber, in welchen Ländern eine Registrierung erforderlich ist, finden Sie AWS End User Messaging SMS im *AWS End User Messaging SMS Benutzerhandbuch* unter [Unterstützte Länder und Regionen für SMS-Nachrichten](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-sms-by-country.html).
1. **Senden** Sie Ihre Nachrichten an ein Thema oder ein Mobiltelefon. Weitere Informationen finden Sie unter [Senden von SMS-Nachrichten mit Amazon SNS](sms_sending-overview.md).
# Hinzufügen und Überprüfen von Telefonnummern in der Amazon SNS SMS-Sandbox
Bevor Sie mit dem Senden von SMS-Nachrichten von Ihrem Computer aus beginnen können, AWS-Konto während Sie sich in der [SMS-Sandbox](sns-sms-sandbox.md) befinden, müssen Sie die folgenden Einrichtungsschritte ausführen. Dadurch wird sichergestellt, dass Ihr Konto für SMS-Nachrichten bereit ist und dass Ihre Zieltelefonnummern ordnungsgemäß verifiziert sind.
1. Erstellen Sie eine **[Quell-ID.](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-number-types.html)** Ähnlich wie bei Konten außerhalb der SMS-Sandbox ist eine Ursprungs-ID erforderlich, bevor Sie SMS-Nachrichten an Empfänger in einigen Ländern oder Regionen senden können.
1. Fügen Sie die **Zieltelefonnummern**, an die Sie Nachrichten senden möchten, innerhalb der SMS-Sandbox hinzu.
1. Überprüfen Sie die **Telefonnummern**, um sicherzustellen, dass die Zieltelefonnummern für die Verwendung in Ihren SMS-Nachrichten gültig sind.
**Fügen Sie Ziel-Telefonnummern hinzu und überprüfen Sie sie**
1. Melden Sie sich bei der [Amazon-SNS-Konsole](https://console.aws.amazon.com/sns/home) an.
1. Wählen Sie im Konsolenmenü eine [Region aus, die SMS-Nachrichten unterstützt](https://docs.aws.amazon.com/general/latest/gr/end-user-messaging.html).
1. Wählen Sie im Navigationsbereich **Text-Messaging (SMS)** aus.
1. Wählen Sie im Abschnitt **Sandbox-Zielrufnummern** die Option **Telefonnummer hinzufügen** aus.
1. Geben Sie unter **Zieldetails** die folgenden Informationen ein und wählen Sie dann **Telefonnummer hinzufügen** aus:
+ **Landesvorwahl** und **Telefonnummer** des Ziels.
+ Die **Sprache**, in der die Bestätigungsnachricht gesendet werden soll.
1. Nach dem Hinzufügen der Telefonnummer sendet Amazon SNS ein OTP an die angegebene Zieltelefonnummer. Dieses OTP ist für die Überprüfung erforderlich.
1. Sie erhalten das OTP als Standard-SMS-Nachricht an die von Ihnen angegebene **Zieltelefonnummer.**
+ Wenn Sie das Einmalpasswort nicht innerhalb von 15 Minuten erhalten, wählen Sie in der Amazon **SNS SNS-Konsole die Option Bestätigungscode erneut senden** aus.
+ Sie können das OTP innerhalb von 24 Stunden bis zu fünf Mal erneut senden.
1. Sobald Sie das OTP erhalten haben, geben Sie es in das Feld **Bestätigungscode** ein und wählen Sie Telefonnummer **verifizieren** aus.
1. Überprüfen Sie den **Bestätigungsstatus**.
+ Nach erfolgreicher Überprüfung der Telefonnummer werden die Telefonnummer und ihr Bestätigungsstatus im Abschnitt **Sandbox-Zieltelefonnummern** angezeigt.
+ Wenn der Status **Ausstehend** lautet, war die Überprüfung nicht erfolgreich. Dies kann beispielsweise der Fall sein, wenn Sie die Landesvorwahl nicht korrekt eingegeben haben.
+ Sie können ausstehende oder verifizierte Telefonnummern erst löschen, wenn seit dem letzten Bestätigungsversuch mindestens 24 Stunden vergangen sind.
1. Wenn Sie dieselbe Zieltelefonnummer in anderen Regionen verwenden möchten, **wiederholen Sie** die vorherigen Schritte für jede Region, in der Sie sie verwenden möchten.
## Behebung von Problemen beim Nichtempfang eines OTP-Textes
Beheben Sie häufig auftretende Probleme, die verhindern können, dass eine Telefonnummer OTP-Texte empfängt.
+ **Amazon SNS SMS-Ausgabenlimit:** Wenn Sie das Ausgabenlimit für den Versand von SMS-Nachrichten AWS-Konto überschritten haben, werden weitere Nachrichten, einschließlich OTP-Texte, möglicherweise erst zugestellt, wenn das Limit erhöht oder das Abrechnungsproblem gelöst ist.
+ **Telefonnummer, die nicht für SMS-Benachrichtigungen aktiviert wurde:** In einigen Ländern oder Regionen müssen sich Empfänger dafür entscheiden, SMS-Nachrichten über Kurzcodes zu erhalten, die üblicherweise für OTP-Texte verwendet werden. Wenn die Telefonnummer des Empfängers nicht aktiviert ist, erhält er den OTP-Text nicht.
+ **Einschränkungen oder Filterung durch Mobilfunkanbieter:** Einige Mobilfunkanbieter verfügen möglicherweise über Einschränkungen oder Filtermechanismen, die die Zustellung bestimmter Arten von SMS-Nachrichten, einschließlich OTP-Texten, verhindern. Dies könnte auf Sicherheitsrichtlinien oder Anti-Spam-Maßnahmen des Mobilfunkanbieters zurückzuführen sein.
+ **Ungültige oder falsche Telefonnummer:** Wenn die vom Empfänger angegebene Telefonnummer falsch oder ungültig ist, wird der OTP-Text nicht zugestellt.
+ **Netzwerkprobleme:** Vorübergehende Netzwerkprobleme oder Ausfälle können die Zustellung von SMS-Nachrichten, einschließlich OTP-Texten, an das Telefon des Empfängers verhindern.
+ **Verspätete Zustellung:** In einigen Fällen kann es bei SMS-Nachrichten aufgrund von Netzwerküberlastungen oder anderen Faktoren zu Verzögerungen bei der Zustellung kommen. Der OTP-Text kann irgendwann zugestellt werden, er kann sich jedoch über den erwarteten Zeitrahmen hinaus verzögern.
+ **Sperrung oder Kündigung Ihres Kontos:** Wenn es Probleme mit Ihrem Konto gibt AWS-Konto, wie z. B. Nichtzahlung oder Verstoß gegen die AWS Nutzungsbedingungen, können die Nachrichtenfunktionen von Amazon SNS, einschließlich OTP-Texten, gesperrt oder beendet werden.
# Löschen von Telefonnummern aus der Amazon SNS SMS-Sandbox
Sie können sowohl ausstehende als auch verifizierte Zielrufnummern aus der [SMS-Sandbox](sns-sms-sandbox.md) löschen.
**Wichtig**
Sie können eine Telefonnummer nur 24 Stunden nach der [Bestätigung der Telefonnummer](sns-sms-sandbox-verifying-phone-numbers.md) oder 24 Stunden nach Ihrem letzten Bestätigungsversuch löschen.
**So löschen Sie Zieltelefonnummern aus der SMS-Sandbox**
1. Melden Sie sich bei der [Amazon-SNS-Konsole](https://console.aws.amazon.com/sns/home) an.
1. Wählen Sie im Konsolenmenü eine [Region aus, die SMS-Nachrichten unterstützt](https://docs.aws.amazon.com/general/latest/gr/end-user-messaging.html) und in der Sie eine Zieltelefonnummer hinzugefügt haben.
1. Wählen Sie im Navigationsbereich **Textnachrichten (SMS)** aus.
1. Navigieren Sie auf der Seite **Mobile Textnachrichten (SMS)** zum Abschnitt **Sandbox-Zieltelefonnummern**.
1. Wählen Sie die spezifische Telefonnummer aus, die Sie löschen möchten, und wählen Sie dann **Telefonnummer löschen** aus.
1. Geben Sie **delete me** ein, und wählen Sie dann **Delete (Löschen)**, um zu bestätigen, dass Sie die Telefonnummer löschen möchten.
Stellen Sie sicher, dass mindestens 24 Stunden vergangen sind, seit Sie die Zieltelefonnummer verifiziert oder versucht haben, sie zu verifizieren, bevor Sie mit dem Löschen fortfahren.
1. Wiederholen Sie diese Schritte in jeder Region, in der Sie die Zieltelefonnummer hinzugefügt haben und nicht mehr verwenden möchten.
# Verlassen der Amazon SNS SMS-Sandbox
Um Sie AWS-Konto aus der [SMS-Sandbox](sns-sms-sandbox.md) zu entfernen, müssen Sie zunächst Zielrufnummern hinzufügen, verifizieren und testen. Erstellen Sie anschließend einen Fall mit AWS Support.
**Um zu beantragen, dass Ihr AWS Konto aus der SMS-Sandbox entfernt wird**
1. **Überprüfen Sie die Telefonnummern**
1. Öffnen Sie AWS-Konto die [Amazon SNS-Konsole, während Sie sich in der SMS-Sandbox befinden](https://console.aws.amazon.com/sns/home).
1. Wählen Sie im Navigationsbereich unter Mobil die Option **Textnachrichten (SMS)** aus.
1. Fügen Sie im Abschnitt Sandbox-Zielrufnummern eine oder mehrere Zielrufnummern [hinzu und überprüfen Sie](sns-sms-sandbox-verifying-phone-numbers.md) sie. Diese Überprüfung stellt sicher, dass Sie erfolgreich Nachrichten senden und empfangen können.
1. **Testen Sie das Veröffentlichen von SMS**
1. Vergewissern Sie sich, dass Sie Nachrichten an mindestens eine verifizierte Telefonnummer senden und empfangen können. Ausführlichere Anweisungen zum Veröffentlichen von SMS-Nachrichten finden Sie unter[Veröffentlichen von SMS-Nachrichten auf einem Mobiltelefon mithilfe von Amazon SNS](sms_sending-overview.md#sms_publish-to-phone).
1. **Initiieren Sie die Sandbox-Bearbeitung**
1. Wählen Sie auf der Seite Amazon SNS-Konsole **Text-Messaging (SMS)** unter **Kontoinformationen** **SMS-Sandbox verlassen**. Diese Aktion leitet Sie zum [Amazon Support Center weiter und erstellt automatisch einen Support-Fall](https://support.console.aws.amazon.com/support/home?#/case/create?issueType=service-limit-increase), bei dem die Option zur **Erhöhung des Servicekontingents** ausgewählt ist.
1. **Füllen Sie das Formular aus**
1. Gehen Sie im Support-Formular unter **Erhöhung der Servicequote** wie folgt vor:
1. Wählen Sie „**SNS-Textnachrichten**“ als Dienst aus.
1. Geben Sie die **URL der Website** oder den **Namen der App** an, von der aus Sie SMS-Nachrichten senden möchten.
1. Geben Sie die Art der Nachrichten an, die Sie senden möchten: **Einmalpasswort**, **Werbe** - oder **Transaktionsnachricht**.
1. Wählen Sie aus, **AWS-Region**von wo aus Sie SMS-Nachrichten senden möchten.
1. Listen Sie die **Länder** oder **Regionen** auf, in denen Sie SMS-Nachrichten senden möchten.
1. Beschreiben Sie, wie sich Ihre **Kunden für den Empfang von Nachrichten anmelden**.
1. Fügen Sie alle **Nachrichtenvorlagen hinzu**, die Sie verwenden möchten.
1. **Geben Sie Kontingent und Region an**
1. Gehen Sie unter **Requests (Anfragen)** wie folgt vor:
1. Wählen Sie **AWS-Region**, wohin Sie Ihre verschieben möchten AWS-Konto.
1. Wählen Sie **Allgemeine Grenzwerte** für den **Ressourcentyp**.
1. Wählen Sie für **Quota** die Option **Exit SMS Sandbox** aus.
1. (Optional) Um zusätzliche Erhöhungen oder andere Anpassungen anzufordern, wählen Sie „Weitere **Anfrage hinzufügen**“ und geben Sie die erforderlichen Details an.
1. Geben Sie **unter Neuer Kontingentwert** das **Limit** in USD ein, das Sie beantragen.
1. **Zusätzliche Details**
1. Geben Sie in der **Fallbeschreibung** alle zusätzlichen Details an, die für Ihre Anfrage relevant sind.
1. Wählen **Sie unter Kontaktoptionen** Ihre **bevorzugte Kontaktsprache** aus.
1. **Reichen Sie die Anfrage ein**
1. Wählen Sie **Senden**, um Ihre Anfrage an zu senden Support.
Das Support Team gibt innerhalb von 24 Stunden eine erste Antwort auf Ihre Anfrage.
Da wir verhindern möchten, dass unerwünschte oder schädliche Inhalte in unseren Systemen eingehen, müssen wir jede Anfrage sorgfältig prüfen. Nach einer Prüfung kommen wir Ihrer Anfrage innerhalb dieses 24-Stunden-Zeitraums nach. Für den Fall, dass wir weitere Informationen von Ihnen benötigen, kann die Bearbeitung Ihrer Anfrage länger dauern.
Wenn Ihr Anwendungsfall gegen unsere Richtlinien verstößt, können wir Ihrer Anfrage möglicherweise nicht nachkommen.
# Herkunftsidentitäten für Amazon SNS SNS-SMS-Nachrichten
**Wichtig**
Der Amazon SNS SMS Developer Guide wurde aktualisiert. Amazon SNS hat sich [AWS End User Messaging SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html)für die Zustellung von SMS-Nachrichten integriert. Dieses Handbuch enthält die neuesten Informationen zur Erstellung, Konfiguration und Verwaltung Ihrer Amazon SNS SNS-SMS-Nachrichten.
Herkunftsidentitäten für SMS-Nachrichten sind Identifikatoren, die zur Darstellung des Absenders einer SMS-Nachricht verwendet werden. Sie können sich gegenüber Ihren Empfängern anhand der folgenden Arten von Absenderidentitäten identifizieren:
**Ursprungsnummern**
Eine numerische Zeichenfolge, die die Telefonnummer eines SMS-Absenders identifiziert. Es gibt verschiedene Arten von Ausgangsnummern, darunter Langcodes (Standardtelefonnummern, die normalerweise 10 oder mehr Ziffern haben), 10-stellige Langcodes (10DLC), gebührenfreie Nummern (TFN) und Kurzcodes (Telefonnummern, die zwischen vier und sieben Ziffern enthalten).
In Ländern, in denen lokale Gesetze die Verwendung von Absendernummern IDs anstelle von Ursprungsnummern vorschreiben, ist die Support für Ursprungsnummern nicht verfügbar. Wenn Sie eine SMS-Nachricht mit einer Ursprungsnummer senden, zeigt das Gerät des Empfängers die Ursprungsnummer als Telefonnummer des Senders an. Sie können verschiedene Ursprungsnummern nach Anwendungsfall angeben.
Weitere Informationen finden Sie im *AWS End User Messaging SMS Benutzerhandbuch* unter [Telefonnummern](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers.html).
Um eine Liste aller vorhandenen Ursprungsnummern in Ihrem AWS Konto anzuzeigen, wählen Sie im Navigationsbereich der [Amazon SNS SNS-Konsole](https://console.aws.amazon.com/sns/home) **Originationsnummern** aus.
**Absender IDs**
Ein alphabetischer Name, der den Absender einer SMS-Nachricht identifiziert. Wenn Sie eine SMS-Nachricht mit einer Absender-ID senden und sich der Empfänger in einem Bereich befindet, in dem die Absender-ID-Authentifizierung unterstützt wird, wird Ihre Absender-ID auf dem Gerät des Empfängers anstelle Ihrer Telefonnummer angezeigt. Eine Sender-ID stellt SMS-Empfängern mehr Informationen über den Sender zur Verfügung als eine Telefonnummer, Langwahl- oder Kurzwahlnummer.
Absender IDs werden in mehreren Ländern und Regionen auf der ganzen Welt unterstützt. In einigen Regionen müssen Sie als Unternehmen, das SMS-Nachrichten an einzelne Kunden sendet, eine Absender-ID verwenden, die vorab bei einer Regulierungsbehörde oder einem Branchengremium registriert wurde. Eine vollständige Liste der Länder und Regionen, die Sender unterstützen oder erfordern IDs, finden Sie AWS End User Messaging SMS im *AWS End User Messaging SMS Benutzerhandbuch* unter [Unterstützte Länder und Regionen für SMS-Nachrichten mit](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-sms-by-country.html).
Für die Verwendung von Sender fallen keine zusätzlichen Gebühren an IDs. Die Unterstützung und die Anforderungen für die Absender-ID-Authentifizierung sind jedoch von Land zu Land unterschiedlich. Mehrere wichtige Märkte (darunter Kanada, China und die Vereinigte Staaten) unterstützen die Verwendung von Sender nicht IDs. In einigen Regionen müssen Sie als Unternehmen, das SMS-Nachrichten an einzelne Kunden sendet, eine Sender-ID verwenden, die vorab bei einer Regulierungsbehörde oder einem Branchengremium registriert wurde.
Weitere Informationen finden Sie IDs im *AWS End User Messaging SMS Benutzerhandbuch* unter [Sender](https://docs.aws.amazon.com/sms-voice/latest/userguide/sender-id.html).
# Konfiguration von SMS-Nachrichten in Amazon SNS
**Wichtig**
Der Amazon SNS SMS Developer Guide wurde aktualisiert. Amazon SNS hat sich [AWS End User Messaging SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html)für die Zustellung von SMS-Nachrichten integriert. Dieses Handbuch enthält die neuesten Informationen zur Erstellung, Konfiguration und Verwaltung Ihrer Amazon SNS SNS-SMS-Nachrichten.
Sie können die Konfigurationen in Amazon SNS SMS verwenden, um SMS-Einstellungen an Ihre Anforderungen anzupassen, wie z. B. die Anpassung von Ausgabenkontingenten und die Einrichtung der Versandstatusprotokollierung. In diesem Thema erfahren Sie auch, wie Sie mithilfe der Amazon SNS SNS-Konsole und des AWS SDK SMS-Nachrichten zu Themen veröffentlichen, Kontingente effizient verwalten und detaillierte Statistiken zu SMS-Aktivitäten abrufen können.
# Senden von SMS-Nachrichten mit Amazon SNS
In diesem Abschnitt wird beschrieben, wie SMS-Nachrichten mithilfe von Amazon SNS gesendet werden, einschließlich der Veröffentlichung zu einem Thema, des Abonnierens von Telefonnummern für Themen, dem Festlegen von Attributen für Nachrichten und dem direkten Veröffentlichen auf Mobiltelefonen.
## Veröffentlichen von SMS-Nachrichten zu einem Amazon SNS SNS-Thema
Sie können eine einzelne SMS-Nachricht gleichzeitig an viele Telefonnummern veröffentlichen, indem Sie das Amazon SNS-Thema für diese Telefonnummern abonnieren. Ein SNS-Thema ist ein Kommunikationskanal, dem Sie Abonnenten hinzufügen können. Anschließend können Sie an all diese Abonnenten Nachrichten veröffentlichen. Ein Abonnent erhält alle Nachrichten, die zu dem Thema veröffentlicht wurden, bis Sie das Abonnement kündigen oder bis der Abonnent den Empfang von SMS-Nachrichten von Ihrem AWS Konto ablehnt.
### Senden einer Nachricht zu einem Thema mithilfe der Konsole AWS
**Erstellen Sie ein Thema wie folgt**
Führen Sie die folgenden Schritte aus, wenn Sie noch kein Thema besitzen, an das Sie SMS-Nachrichten senden möchten.
1. Melden Sie sich bei der [Amazon SNS-Konsole](https://console.aws.amazon.com/sns/home) an.
1. Wählen Sie im Konsolenmenü eine [Region aus, die SMS-Nachrichten unterstützt](https://docs.aws.amazon.com/general/latest/gr/end-user-messaging.html).
1. Wählen Sie im Navigationsbereich **Themen** aus.
1. Klicken Sie auf der Seite **Themen** auf **Thema erstellen**.
1. Gehen Sie auf der Seite **Thema erstellen** unter **Details** wie folgt vor:
1. Wählen Sie unter **Type (Typ)** die Option **Standard** aus.
1. Geben Sie für **Name** einen Themennamen ein.
1. (Optional) Geben Sie unter **Display name (Anzeigename)** einen benutzerdefinierten Präfix für Ihre SMS-Nachrichten ein. Wenn Sie eine Nachricht an ein Thema senden, stellt Amazon SNS den Anzeigenamen voran, gefolgt von einer spitzen Klammer rechts (>) und einer Leerstelle. Anzeigenamen beachteten die Groß- und Kleinschreibung nicht und Amazon SNS konvertiert Anzeigenamen zu Großbuchstaben. Beispiel: Wenn der Anzeigename eines Themas `MyTopic` ist und die Nachricht lautet `Hello World!`, wird die Nachricht folgendermaßen angezeigt:
```
MYTOPIC> Hello World!
```
1. Wählen Sie **Thema erstellen** aus. Der Name des Themas und der Amazon-Ressourcenname (ARN) werden auf der Registerkarte **Themen** angezeigt.
**So erstellen Sie ein SMS-Abonnement:**
Anhand von Abonnements können Sie eine SMS-Nachricht an mehrere Empfänger senden, indem Sie die Nachricht nur einmal zu dem Thema veröffentlichen.
**Anmerkung**
Wenn Sie Amazon SNS zum Senden von SMS-Nachrichten verwenden, befindet sich Ihr AWS Konto in der *SMS-Sandbox*. Die SMS-Sandbox bietet Ihnen eine sichere Umgebung, in der Sie Amazon SNS Funktionen ausprobieren können, ohne Ihren Ruf als SMS-Sender zu gefährden. Während sich Ihr Konto in der SMS-Sandbox befindet, können Sie alle Funktionen von Amazon SNS verwenden. Sie können jedoch SMS-Nachrichten nur an verifizierte Zieltelefonnummern senden. Weitere Informationen finden Sie unter [Verwenden der Amazon SNS SMS-Sandbox](sns-sms-sandbox.md).
1. Melden Sie sich bei der [Amazon SNS-Konsole](https://console.aws.amazon.com/sns/home) an.
1. Wählen Sie im Navigationsbereich **Subscriptions** aus.
1. Wählen Sie auf der Seite **Subscriptions** (Abonnements) die Option **Create subscription (Abonnement erstellen)**aus.
1. Gehen Sie auf der Seite **Abonnement erstellen** unter **Details** wie folgt vor:
1. Für **Thema-ARN** geben Sie ein oder wählen Sie den Amazon-Ressourcennamen (ARN) des Themas, an das Sie SMS-Nachrichten senden möchten.
1. Wählen Sie für **Protokoll** **SMS** aus.
1. Geben Sie für **Endpunkt** die Telefonnummer ein, die mit Ihrem Thema abonniert werden soll.
1. Wählen Sie **Create subscription** (Abonnement erstellen) aus. Die Abonnementinformationen erscheint auf der Seite **Abonnements**.
Wiederholen Sie diese Schritte, um weitere Telefonnummern hinzuzufügen. Sie können auch andere Abonnementtypen, wie E-Mail, hinzufügen.
**So senden Sie eine Nachricht**
Wenn Sie eine Nachricht veröffentlichen, versucht Amazon SNS diese Nachricht an alle Telefonnummern zu schicken, die das Thema abonniert haben.
1. Wählen Sie in der [Amazon SNS-Konsole](https://console.aws.amazon.com/sns/home) auf der Seite **Themen** den Namen des Themas, an das Sie SMS-Nachrichten senden möchten.
1. Wählen Sie auf der Seite mit den Details des Themas **Publish message (Nachricht veröffentlichen)** aus.
1. Geben Sie auf der Seite **Nachricht für Thema veröffentlichen** unter **Nachrichtendetails** wie folgt vor:
1. Lassen Sie unter **Subject (Betreff)** das Feld leer, es sei denn, Ihr Thema enthält E-Mail-Abonnements und Sie möchten sowohl an E-Mail- und SMS-Abonnements Nachrichten veröffentlichen. Amazon SNS verwendet den **Betreff**, den Sie eingeben, als E-Mail-Betreffzeile.
1. (Optional) Geben Sie für **Time to Live (TTL)** eine Anzahl an Sekunden an, in denen Amazon SNS Ihre SMS-Nachricht an Abonnenten des Mobilanwendungs-Endpunkts senden muss.
1. Gehen Sie unter **Nachrichtentext** wie folgt vor:
1. Wählen Sie für **Nachrichtenstruktur** **Identische Nutzlast für alle Bereitstellungsprotokolle**, um die gleiche Nachricht an alle Protokolltypen zu schicken, die Ihr Thema abonniert haben. Oder wählen Sie **Benutzerdefinierte Nutzlast für die einzelnen Bereitstellungsprotokolle**, um die Nachricht für Abonnenten verschiedener Protokolltypen anzupassen. Sie können beispielsweise eine Standardnachricht für Telefonnummernabonnenten und eine benutzerdefinierte Nachricht für E-Mail-Abonnenten eingeben.
1. Geben Sie für **Nachrichtentext zum Senden an den Endpunkt** Ihre Nachricht oder Ihre benutzerdefinierten Nachrichten je Zustellungsprotokoll ein.
Wenn Ihr Thema über einen Anzeigenamen verfügt, fügt Amazon SNS diesen der Nachricht hinzu, wodurch sich die Nachrichtenlänge verlängert. Die Länge des Anzeigenamens setzt sich aus der Anzahl der Zeichen des Namens sowie zwei Zeichen für die spitze Klammer (>) und von Amazon SNS hinzugefügte Leerzeichen zusammen.
Weitere Informationen über das Größenkontingent für SMS-Nachrichten finden Sie unter [Veröffentlichen von SMS-Nachrichten auf einem Mobiltelefon mithilfe von Amazon SNS](#sms_publish-to-phone).
1. (Optional) Fügen Sie für **Nachrichtenattribute Nachrichtenmetadaten** wie Zeitstempel, Signaturen und hinzu. IDs
1. Wählen Sie **Publish message (Nachricht veröffentlichen)** aus. Amazon SNS sendet die SMS-Nachricht und zeigt eine Erfolgsmeldung an.
### Senden einer Nachricht an ein Thema mit dem AWS SDKs
Um ein AWS SDK zu verwenden, müssen Sie es mit Ihren Anmeldeinformationen konfigurieren. Weitere Informationen finden Sie unter [Die Dateien für die gemeinsame Konfiguration und die Anmeldeinformationen](https://docs.aws.amazon.com/sdkref/latest/guide/creds-config-files.html) im *AWS SDKs Referenzhandbuch zu Tools*.
Wie das aussehen kann, sehen Sie am nachfolgenden Beispielcode:
+ Erstellen Sie ein Amazon-SNS-Thema.
+ Verknüpfen Sie Telefonnummern mit dem Thema.
+ Veröffentlichen Sie SMS-Nachrichten im Thema, damit alle abonnierten Telefonnummern die Nachricht gleichzeitig empfangen.
------
#### [ Java ]
**SDK für Java 2.x**
Weitere Informationen finden Sie unter GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/sns#code-examples) einrichten und ausführen.
Erstellen Sie ein Thema und geben Sie seinen ARN zurück.
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sns.SnsClient;
import software.amazon.awssdk.services.sns.model.CreateTopicRequest;
import software.amazon.awssdk.services.sns.model.CreateTopicResponse;
import software.amazon.awssdk.services.sns.model.SnsException;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class CreateTopic {
public static void main(String[] args) {
final String usage = """
Usage:
Where:
topicName - The name of the topic to create (for example, mytopic).
""";
if (args.length != 1) {
System.out.println(usage);
System.exit(1);
}
String topicName = args[0];
System.out.println("Creating a topic with name: " + topicName);
SnsClient snsClient = SnsClient.builder()
.region(Region.US_EAST_1)
.build();
String arnVal = createSNSTopic(snsClient, topicName);
System.out.println("The topic ARN is" + arnVal);
snsClient.close();
}
public static String createSNSTopic(SnsClient snsClient, String topicName) {
CreateTopicResponse result;
try {
CreateTopicRequest request = CreateTopicRequest.builder()
.name(topicName)
.build();
result = snsClient.createTopic(request);
return result.topicArn();
} catch (SnsException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return "";
}
}
```
Abonnieren eines Endpunkts für ein Thema.
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sns.SnsClient;
import software.amazon.awssdk.services.sns.model.SnsException;
import software.amazon.awssdk.services.sns.model.SubscribeRequest;
import software.amazon.awssdk.services.sns.model.SubscribeResponse;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class SubscribeTextSMS {
public static void main(String[] args) {
final String usage = """
Usage:
Where:
topicArn - The ARN of the topic to subscribe.
phoneNumber - A mobile phone number that receives notifications (for example, +1XXX5550100).
""";
if (args.length < 2) {
System.out.println(usage);
System.exit(1);
}
String topicArn = args[0];
String phoneNumber = args[1];
SnsClient snsClient = SnsClient.builder()
.region(Region.US_EAST_1)
.build();
subTextSNS(snsClient, topicArn, phoneNumber);
snsClient.close();
}
public static void subTextSNS(SnsClient snsClient, String topicArn, String phoneNumber) {
try {
SubscribeRequest request = SubscribeRequest.builder()
.protocol("sms")
.endpoint(phoneNumber)
.returnSubscriptionArn(true)
.topicArn(topicArn)
.build();
SubscribeResponse result = snsClient.subscribe(request);
System.out.println("Subscription ARN: " + result.subscriptionArn() + "\n\n Status is "
+ result.sdkHttpResponse().statusCode());
} catch (SnsException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
Legen Sie Attribute für die Nachricht fest, z. B. die ID des Senders, den Höchstpreis und seinen Typ. Nachrichtenattribute sind optional.
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sns.SnsClient;
import software.amazon.awssdk.services.sns.model.SetSmsAttributesRequest;
import software.amazon.awssdk.services.sns.model.SetSmsAttributesResponse;
import software.amazon.awssdk.services.sns.model.SnsException;
import java.util.HashMap;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class SetSMSAttributes {
public static void main(String[] args) {
HashMap attributes = new HashMap<>(1);
attributes.put("DefaultSMSType", "Transactional");
attributes.put("UsageReportS3Bucket", "janbucket");
SnsClient snsClient = SnsClient.builder()
.region(Region.US_EAST_1)
.build();
setSNSAttributes(snsClient, attributes);
snsClient.close();
}
public static void setSNSAttributes(SnsClient snsClient, HashMap attributes) {
try {
SetSmsAttributesRequest request = SetSmsAttributesRequest.builder()
.attributes(attributes)
.build();
SetSmsAttributesResponse result = snsClient.setSMSAttributes(request);
System.out.println("Set default Attributes to " + attributes + ". Status was "
+ result.sdkHttpResponse().statusCode());
} catch (SnsException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
Veröffentlichen einer Nachricht für ein Thema. Die Nachricht wird an jeden Teilnehmer gesendet.
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sns.SnsClient;
import software.amazon.awssdk.services.sns.model.PublishRequest;
import software.amazon.awssdk.services.sns.model.PublishResponse;
import software.amazon.awssdk.services.sns.model.SnsException;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class PublishTextSMS {
public static void main(String[] args) {
final String usage = """
Usage:
Where:
message - The message text to send.
phoneNumber - The mobile phone number to which a message is sent (for example, +1XXX5550100).\s
""";
if (args.length != 2) {
System.out.println(usage);
System.exit(1);
}
String message = args[0];
String phoneNumber = args[1];
SnsClient snsClient = SnsClient.builder()
.region(Region.US_EAST_1)
.build();
pubTextSMS(snsClient, message, phoneNumber);
snsClient.close();
}
public static void pubTextSMS(SnsClient snsClient, String message, String phoneNumber) {
try {
PublishRequest request = PublishRequest.builder()
.message(message)
.phoneNumber(phoneNumber)
.build();
PublishResponse result = snsClient.publish(request);
System.out
.println(result.messageId() + " Message sent. Status was " + result.sdkHttpResponse().statusCode());
} catch (SnsException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
------
## Veröffentlichen von SMS-Nachrichten auf einem Mobiltelefon mithilfe von Amazon SNS
Sie können Amazon SNS verwenden, um SMS-Nachrichten direkt an ein Mobiltelefon zu senden, ohne die Telefonnummer für ein Amazon SNS-Thema zu abonnieren.
**Anmerkung**
Das Abonnieren von Telefonnummern zu einem Thema kann nach wie vor nützlich sein, wenn Sie jede Nachricht in mehreren Telefonnummern zugleich senden möchten. Weitere Anleitungen zum Veröffentlichen einer SMS-Nachricht in einem Thema finden Sie unter [Veröffentlichen von SMS-Nachrichten zu einem Amazon SNS SNS-Thema](#sms_publish-to-topic).
Wenn Sie eine Nachricht senden, können Sie überprüfen, ob der Versand in Bezug auf Kosten und Verlässlichkeit optimiert ist. Sie können auch eine [Sender-ID oder Ursprungsnummer](channels-sms-originating-identities.md) angeben. Wenn Sie die Nachricht programmgesteuert über die Amazon SNS SNS-API oder die senden AWS SDKs, können Sie einen Höchstpreis für die Nachrichtenzustellung angeben.
Eine SMS-Nachricht kann maximal 140 Byte groß sein, wobei das Zeichenkontingent vom Codierungsschema abhängig ist. Die Anzahl der Zeichen einer SMS-Nachricht ist entsprechend wie folgt begrenzt:
+ 160 GSM-Zeichen
+ 140 ASCII-Zeichen
+ 70 UCS-2-Zeichen
Wenn Sie eine Nachricht veröffentlichen, die das Größenkontingent überschreitet, sendet Amazon SNS mehrere Teilnachrichten, die jeweils dem Größenkontingent entsprechen. Nachrichten werden niemals inmitten eines Wortes geteilt, sondern immer zwischen zwei Wörtern. Für die gesamte veröffentlichte und in mehreren Teilen versendete SMS-Nachricht gilt ein Größenkontingent von 1600 Byte.
Wenn Sie eine SMS-Nachricht senden, geben Sie die Telefonnummer im E.164-Format an – eine Standardnummernstruktur für die Telefonnummerierung, die für die internationale Telekommunikation verwendet wird. Telefonnummern in diesem Format bestehen aus maximal 15 Zeichen sowie einem vorangestellten Plus-Zeichen (\$1) und der Ländervorwahl. Beispielsweise wird eine US-Telefonnummer im E.164-Format als \$11 angezeigt. XXX5550100
### Senden einer Nachricht (Konsole)
1. Melden Sie sich bei der [Amazon-SNS-Konsole](https://console.aws.amazon.com/sns/home) an.
1. Wählen Sie im Konsolenmenü eine [Region aus, die SMS-Nachrichten unterstützt](https://docs.aws.amazon.com/general/latest/gr/end-user-messaging.html).
1. Wählen Sie im Navigationsbereich **Text-Messaging (SMS)** aus.
1. Wählen Sie auf der Seite **Text-Messaging (SMS)** **Textnachricht veröffentlichen**.
1. Wählen Sie auf der Seite **Textnachricht veröffentlichen** für **Nachrichtentyp** eines der Folgenden:
+ **Werbenachrichten** – Unkritische Nachrichten, wie beispielsweise Marketing-Nachrichten.
+ **Transaktionsnachrichten**: Sensible Nachrichten, die Kundentransaktionen unterstützen, wie beispielsweise One-Time-Passcodes für eine Multi-Faktor-Authentifizierung (MFA).
**Anmerkung**
Diese Einstellung auf Nachrichtenebene setzt den Standardnachrichtentyp auf Kontoebene außer Kraft. Auf der Seite **Textnachrichten (SMS)** im Abschnitt **Text-Messaging-Einstellungen** können SIe einen Standardnachrichtentyp auf Kontoebene festlegen.
Informationen zu den Gebühren für Aktions- und Transaktionsnachrichten finden Sie unter [Weltweite SMS-Preise](https://aws.amazon.com/sns/sms-pricing/).
1. Geben Sie unter **Zieltelefonnummer** die Telefonnummer ein, an die Sie die Nachricht senden möchten.
1. Geben Sie im Feld **Message (Nachricht)** die Art der zu versendenden Nachricht ein.
1. (Optional) Legen Sie unter **Ursprungsidentitäten** fest, wie Sie sich selbst gegenüber Ihren Empfängern identifizieren möchten:
+ Geben Sie im Feld **Sender ID (Sender-ID)** eine Kunden-ID ein, die 3 bis 11 alphanumerische Zeichen enthält, einschließlich mindestens einem Buchstaben und ohne Leerzeichen. Die Sender-ID wird auf dem Empfänger-Gerät als Sender der Nachricht angezeigt. Sie können z. B. Ihre Unternehmensmarke verwenden, um die Nachrichtenquelle leichter erkennbar zu machen.
Die Support für den Absender IDs ist je nach Land und and/or Region unterschiedlich. Beispiel: Für Nachrichten, die an eine US-Telefonnummer gesendet werden, wird keine Sender-ID angezeigt. Informationen zu den Ländern und Regionen, die Sender unterstützen IDs, finden Sie AWS End User Messaging SMS im *AWS End User Messaging SMS Benutzerhandbuch* unter [Unterstützte Länder und Regionen für SMS-Nachrichten mit](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-sms-by-country.html).
Wenn Sie keine Sender-ID angeben, wird eines der folgenden Elemente als Ursprungsidentität angezeigt:
+ In Ländern, die Langwahlnummern unterstützen, wird die Langwahlnummer angezeigt.
+ In Ländern, in denen nur Absender unterstützt IDs werden, wird *NOTICE* angezeigt.
Diese Sender-ID auf Nachrichtenebene ersetzt die standardmäßige Sender-ID, die Sie auf der Seite **Text messaging preferences (SMS-Präferenzen)** konfigurieren.
+ Um eine **Ursprungsnummer** festzulegen, geben Sie eine Zeichenfolge von 5-14 Nummern ein, die als Telefonnummer des Senders auf dem Gerät des Empfängers angezeigt werden soll. Diese Zeichenfolge muss mit einer Ausgangsnummer übereinstimmen, die in Ihrem AWS-Konto Zielland konfiguriert ist. Bei der Ausgangsnummer kann es sich um eine 10DLC-Nummer, eine gebührenfreie Nummer, einen person-to-person Langcode oder eine Kurzvorwahl handeln. Weitere Informationen finden Sie unter [Herkunftsidentitäten für Amazon SNS SNS-SMS-Nachrichten](channels-sms-originating-identities.md).
Wenn Sie keine Ursprungsnummer angeben, wählt Amazon SNS eine Ursprungsnummer aus, die für die SMS-Textnachricht verwendet werden soll, basierend auf Ihrer AWS-Konto -Konfiguration.
1. Wenn Sie SMS-Nachrichten an Empfänger in Indien senden, erweitern Sie **Länderspezifische Attribute** und legen Sie die folgenden Attribute fest:
+ **Entity-ID** – Die Entity ID oder Principal Entity (PE) -ID für das Senden von SMS-Nachrichten an Empfänger in Indien. Diese ID ist eine eindeutige Zeichenfolge von 1 bis 50 Zeichen, die die Telecom Regulatory Authority of India (TRAI) zur Identifizierung der Entität bereitstellt, die Sie bei der TRAI registriert haben.
+ **ID der Vorlage** – Die Vorlagen-ID für das Senden von SMS-Nachrichten an Empfänger in Indien. Diese ID ist eine eindeutige, von TRAI bereitgestellte Zeichenfolge mit 1 bis 50 Zeichen, die die Vorlage identifiziert, die Sie bei TRAI registriert haben. Die Vorlagen-ID muss der Sender-ID zugeordnet sein, die Sie für die Nachricht angegeben haben.
Weitere Informationen zum Senden von SMS-Nachrichten an Empfänger in Indien, [Indien, Indien,](https://docs.aws.amazon.com/sms-voice/latest/userguide/registrations-sms-senderid-india.html) finden Sie im *AWS End User Messaging SMS Benutzerhandbuch*.
1. Wählen Sie **Publish message (Nachricht veröffentlichen)** aus.
**Tipp**
Um SMS-Nachrichten von einer Ursprungsnummer zu senden, können Sie auch **Ursprungsnummern** im Navigationsbereich in der Amazon SNS-Konsole eingeben. Wählen Sie eine Ursprungsnummer, die in der Spalte **Funktionen** **SMS** enthält und wählen Sie dann **Textnachricht veröffentlichen**.
### Eine Nachricht senden (AWS SDKs)
Um eine SMS-Nachricht mit einem der zu senden AWS SDKs, verwenden Sie den API-Vorgang in diesem SDK, der der `Publish` Anfrage in der Amazon SNS SNS-API entspricht. Mit dieser Anfrage können Sie eine SMS-Nachricht direkt an eine Telefonnummer senden. Sie können auch den `MessageAttributes`-Parameter verwenden, um Werte für die folgenden Attributnamen zu definieren:
**`AWS.SNS.SMS.SenderID`**
Eine benutzerdefinierte ID, die 3 bis 11 alphanumerische Zeichen oder Bindestriche (-) enthält, einschließlich mindestens einem Buchstaben und ohne Leerzeichen. Die Sender-ID wird auf dem Empfänger-Gerät als Sender der Nachricht angezeigt. Sie können z. B. Ihre Unternehmensmarke verwenden, um die Nachrichtenquelle leichter erkennbar zu machen.
Die Support für den Absender IDs ist je nach Land oder Region unterschiedlich. Beispiel: Für Nachrichten, die an eine US-Telefonnummer gesendet werden, wird keine Sender-ID angezeigt. Eine Liste der Länder oder Regionen, die Absender unterstützen IDs, finden Sie AWS End User Messaging SMS im *AWS End User Messaging SMS Benutzerhandbuch* unter [Unterstützte Länder und Regionen für SMS-Nachrichten mit](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-sms-by-country.html).
Wenn Sie keine Sender-ID angeben, erscheint eine [Langwahlnummer](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-request-long-code.html) als Sender-ID in den unterstützten Ländern oder Regionen. Für Länder oder Regionen, die eine alphabetische Sender-ID erfordern, wird *NOTICE* als Sender-ID angezeigt.
Dieses Attribut auf Nachrichtenebene ersetzt das `DefaultSenderID`-Attribut auf Kontoebene, das Sie bei der Nutzung der `SetSMSAttributes`-Anfrage festlegen.
**`AWS.MM.SMS.OriginationNumber`**
Eine benutzerdefinierte Zeichenfolge von 5 bis 14 Zahlen, die ein optionales vorzeitiges Pluszeichen (`+`) enthalten. Diese Zahlenfolge wird als Telefonnummer des Senders auf dem empfangenden Gerät angezeigt. Die Zeichenfolge muss mit einer Ausgangsnummer übereinstimmen, die in Ihrem AWS Konto für das Zielland konfiguriert ist. Bei der Ausgangsnummer kann es sich um eine 10DLC-Nummer, eine gebührenfreie Nummer, einen person-to-person (P2P) -Langcode oder einen Kurzcode handeln. *Weitere Informationen finden Sie im Benutzerhandbuch unter [Telefonnummern](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers.html).AWS End User Messaging SMS *
Wenn Sie keine Ursprungsnummer angeben, wählt Amazon SNS auf der Grundlage Ihrer AWS Kontokonfiguration eine Ursprungsnummer aus.
**`AWS.SNS.SMS.MaxPrice`**
Höchstpreis in USD, den Sie zu zahlen bereit sind, um die SMS-Nachricht zu senden. Wenn Amazon SNS festlegt, dass das Senden der Nachricht zu Kosten führen würde, die Ihren Maximalpreis übersteigen, wird die Nachricht nicht gesendet.
Dieses Attribut hat keine Auswirkung, wenn Ihre month-to-date SMS-Kosten das für das Attribut festgelegte Kontingent bereits überschritten haben. `MonthlySpendLimit` Sie können das `MonthlySpendLimit`-Attribut mit der `SetSMSAttributes`-Anfrage festlegen.
Wenn Sie die Nachricht an ein Amazon SNS-Thema senden, gilt bei jeder Nachrichtenübertragung an alle Telefonnummern, die das Thema abonniert haben, der Höchstpreis.
**`AWS.SNS.SMS.SMSType`**
Der Typ der gesendeten Nachricht:
+ **`Promotional`** (Standard): Unkritische Nachrichten, wie beispielsweise Marketing-Nachrichten.
+ **`Transactional`** – Sensible Nachrichten, die Kundentransaktionen unterstützen, wie beispielsweise One-Time-Passcodes für eine Multi-Faktor-Authentifizierung.
Dieses Attribut auf Nachrichtenebene ersetzt das `DefaultSMSType`-Attribut auf Kontoebene, das Sie bei der Nutzung der `SetSMSAttributes`-Anfrage festlegen.
**`AWS.MM.SMS.EntityId`**
Dieses Attribut ist nur für das Senden von SMS-Nachrichten an Empfänger in Indien erforderlich.
Das ist Ihre Entity ID oder Principal Entity (PE) -ID für das Senden von SMS-Nachrichten an Empfänger in Indien. Diese ID ist eine eindeutige Zeichenfolge von 1 bis 50 Zeichen, die die Telecom Regulatory Authority of India (TRAI) zur Identifizierung der Entität bereitstellt, die Sie bei der TRAI registriert haben.
**`AWS.MM.SMS.TemplateId`**
Dieses Attribut ist nur für das Senden von SMS-Nachrichten an Empfänger in Indien erforderlich.
Dies ist Ihre Vorlage für das Senden von SMS-Nachrichten an Empfänger in Indien. Diese ID ist eine eindeutige, von TRAI bereitgestellte Zeichenfolge mit 1 bis 50 Zeichen, die die Vorlage identifiziert, die Sie bei TRAI registriert haben. Die Vorlagen-ID muss der Sender-ID zugeordnet sein, die Sie für die Nachricht angegeben haben.
#### Senden einer Nachricht
In den folgenden Codebeispielen wird veranschaulicht, wie Sie SMS-Nachrichten über Amazon SNS veröffentlichen.
------
#### [ .NET ]
**SDK für .NET**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/SNS#code-examples) einrichten und ausführen.
```
namespace SNSMessageExample
{
using System;
using System.Threading.Tasks;
using Amazon;
using Amazon.SimpleNotificationService;
using Amazon.SimpleNotificationService.Model;
public class SNSMessage
{
private AmazonSimpleNotificationServiceClient snsClient;
///
/// Initializes a new instance of the class.
/// Constructs a new SNSMessage object initializing the Amazon Simple
/// Notification Service (Amazon SNS) client using the supplied
/// Region endpoint.
///
/// The Amazon Region endpoint to use in
/// sending test messages with this object.
public SNSMessage(RegionEndpoint regionEndpoint)
{
snsClient = new AmazonSimpleNotificationServiceClient(regionEndpoint);
}
///
/// Sends the SMS message passed in the text parameter to the phone number
/// in phoneNum.
///
/// The ten-digit phone number to which the text
/// message will be sent.
/// The text of the message to send.
/// Async task.
public async Task SendTextMessageAsync(string phoneNum, string text)
{
if (string.IsNullOrEmpty(phoneNum) || string.IsNullOrEmpty(text))
{
return;
}
// Now actually send the message.
var request = new PublishRequest
{
Message = text,
PhoneNumber = phoneNum,
};
try
{
var response = await snsClient.PublishAsync(request);
}
catch (Exception ex)
{
Console.WriteLine($"Error sending message: {ex}");
}
}
}
}
```
+ Weitere API-Informationen finden Sie unter [Publish](https://docs.aws.amazon.com/goto/DotNetSDKV3/sns-2010-03-31/Publish) in der *AWS SDK für .NET -API-Referenz*.
------
#### [ C\$1\$1 ]
**SDK für C\$1\$1**
Es gibt noch mehr GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/sns#code-examples) einrichten und ausführen.
```
/**
* Publish SMS: use Amazon Simple Notification Service (Amazon SNS) to send an SMS text message to a phone number.
* Note: This requires additional AWS configuration prior to running example.
*
* NOTE: When you start using Amazon SNS to send SMS messages, your AWS account is in the SMS sandbox and you can only
* use verified destination phone numbers. See https://docs.aws.amazon.com/sns/latest/dg/sns-sms-sandbox.html.
* NOTE: If destination is in the US, you also have an additional restriction that you have use a dedicated
* origination ID (phone number). You can request an origination number using Amazon Pinpoint for a fee.
* See https://aws.amazon.com/blogs/compute/provisioning-and-using-10dlc-origination-numbers-with-amazon-sns/
* for more information.
*
* input parameter uses E.164 format.
* For example, in United States, this input value should be of the form: +12223334444
*/
//! Send an SMS text message to a phone number.
/*!
\param message: The message to publish.
\param phoneNumber: The phone number of the recipient in E.164 format.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::SNS::publishSms(const Aws::String &message,
const Aws::String &phoneNumber,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::SNS::SNSClient snsClient(clientConfiguration);
Aws::SNS::Model::PublishRequest request;
request.SetMessage(message);
request.SetPhoneNumber(phoneNumber);
const Aws::SNS::Model::PublishOutcome outcome = snsClient.Publish(request);
if (outcome.IsSuccess()) {
std::cout << "Message published successfully with message id, '"
<< outcome.GetResult().GetMessageId() << "'."
<< std::endl;
}
else {
std::cerr << "Error while publishing message "
<< outcome.GetError().GetMessage()
<< std::endl;
}
return outcome.IsSuccess();
}
```
+ Weitere API-Informationen finden Sie unter [Publish](https://docs.aws.amazon.com/goto/SdkForCpp/sns-2010-03-31/Publish) in der *AWS SDK für C\$1\$1 -API-Referenz*.
------
#### [ Java ]
**SDK für Java 2.x**
Es gibt noch mehr GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/sns#code-examples) einrichten und ausführen.
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sns.SnsClient;
import software.amazon.awssdk.services.sns.model.PublishRequest;
import software.amazon.awssdk.services.sns.model.PublishResponse;
import software.amazon.awssdk.services.sns.model.SnsException;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class PublishTextSMS {
public static void main(String[] args) {
final String usage = """
Usage:
Where:
message - The message text to send.
phoneNumber - The mobile phone number to which a message is sent (for example, +1XXX5550100).\s
""";
if (args.length != 2) {
System.out.println(usage);
System.exit(1);
}
String message = args[0];
String phoneNumber = args[1];
SnsClient snsClient = SnsClient.builder()
.region(Region.US_EAST_1)
.build();
pubTextSMS(snsClient, message, phoneNumber);
snsClient.close();
}
public static void pubTextSMS(SnsClient snsClient, String message, String phoneNumber) {
try {
PublishRequest request = PublishRequest.builder()
.message(message)
.phoneNumber(phoneNumber)
.build();
PublishResponse result = snsClient.publish(request);
System.out
.println(result.messageId() + " Message sent. Status was " + result.sdkHttpResponse().statusCode());
} catch (SnsException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
+ Weitere API-Informationen finden Sie unter [Publish](https://docs.aws.amazon.com/goto/SdkForJavaV2/sns-2010-03-31/Publish) in der *AWS SDK for Java 2.x -API-Referenz*.
------
#### [ Kotlin ]
**SDK für Kotlin**
Es gibt noch mehr GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/sns#code-examples) einrichten und ausführen.
```
suspend fun pubTextSMS(
messageVal: String?,
phoneNumberVal: String?,
) {
val request =
PublishRequest {
message = messageVal
phoneNumber = phoneNumberVal
}
SnsClient.fromEnvironment { region = "us-east-1" }.use { snsClient ->
val result = snsClient.publish(request)
println("${result.messageId} message sent.")
}
}
```
+ Weitere API-Informationen finden Sie unter [Publish](https://sdk.amazonaws.com/kotlin/api/latest/index.html) in der *API-Referenz zum AWS SDK für Kotlin*.
------
#### [ PHP ]
**SDK für PHP**
Es gibt noch mehr GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/php/example_code/sns#code-examples) einrichten und ausführen.
```
require 'vendor/autoload.php';
use Aws\Exception\AwsException;
use Aws\Sns\SnsClient;
/**
* Sends a text message (SMS message) directly to a phone number using Amazon SNS.
*
* This code expects that you have AWS credentials set up per:
* https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/guide_credentials.html
*/
$SnSclient = new SnsClient([
'profile' => 'default',
'region' => 'us-east-1',
'version' => '2010-03-31'
]);
$message = 'This message is sent from a Amazon SNS code sample.';
$phone = '+1XXX5550100';
try {
$result = $SnSclient->publish([
'Message' => $message,
'PhoneNumber' => $phone,
]);
var_dump($result);
} catch (AwsException $e) {
// output error message if fails
error_log($e->getMessage());
}
```
+ Weitere Informationen finden Sie im [AWS SDK für PHP -Entwicklerhandbuch](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/sns-examples-sending-sms.html#publish-to-a-text-message-sms-message).
+ Weitere API-Informationen finden Sie unter [Publish](https://docs.aws.amazon.com/goto/SdkForPHPV3/sns-2010-03-31/Publish) in der *AWS SDK für PHP -API-Referenz*.
------
#### [ Python ]
**SDK für Python (Boto3)**
Es gibt noch mehr GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/sns#code-examples) einrichten und ausführen.
```
class SnsWrapper:
"""Encapsulates Amazon SNS topic and subscription functions."""
def __init__(self, sns_resource):
"""
:param sns_resource: A Boto3 Amazon SNS resource.
"""
self.sns_resource = sns_resource
def publish_text_message(self, phone_number, message):
"""
Publishes a text message directly to a phone number without need for a
subscription.
:param phone_number: The phone number that receives the message. This must be
in E.164 format. For example, a United States phone
number might be +12065550101.
:param message: The message to send.
:return: The ID of the message.
"""
try:
response = self.sns_resource.meta.client.publish(
PhoneNumber=phone_number, Message=message
)
message_id = response["MessageId"]
logger.info("Published message to %s.", phone_number)
except ClientError:
logger.exception("Couldn't publish message to %s.", phone_number)
raise
else:
return message_id
```
+ Weitere API-Informationen finden Sie unter [Publish](https://docs.aws.amazon.com/goto/boto3/sns-2010-03-31/Publish) in der *API-Referenz zu AWS SDK für Python (Boto3)*.
------
#### [ SAP ABAP ]
**SDK für SAP ABAP**
Es gibt noch mehr dazu. GitHub Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/sns#code-examples) einrichten und ausführen.
```
" iv_phone_number = '+12065550101' - Phone number in E.164 format
TRY.
oo_result = lo_sns->publish( " oo_result is returned for testing purposes. "
iv_phonenumber = iv_phone_number
iv_message = iv_message ).
MESSAGE 'Message published to phone number.' TYPE 'I'.
CATCH /aws1/cx_snsnotfoundexception.
MESSAGE 'Phone number does not exist.' TYPE 'E'.
ENDTRY.
```
+ Details zu API finden Sie unter [Publish](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) (Veröffentlichen) in der *API-Referenz für das AWS SDK für SAP ABAP*.
------
# Einstellungen für SMS-Nachrichten in Amazon SNS einrichten
Verwenden Sie Amazon SNS, um Einstellungen für SMS-Messaging anzugeben. Sie können beispielsweise festlegen, ob Zustellung zu Kosten oder zur Zuverlässigkeit optimiert werden, Ihr monatliches Ausgabelimit, wie Zustellungen protokolliert werden und ob Sie tägliche SMS-Nutzungsberichte erhalten möchten.
Diese Einstellungen gelten für jede SMS-Nachricht, die Sie von Ihrem Konto senden. Sie können jedoch auch beim Senden einer einzelnen Nachricht überschrieben werden. Weitere Informationen finden Sie unter [Veröffentlichen von SMS-Nachrichten auf einem Mobiltelefon mithilfe von Amazon SNS](sms_sending-overview.md#sms_publish-to-phone).
## Einstellung der Einstellungen für SMS-Nachrichten mithilfe der AWS-Managementkonsole
1. Melden Sie sich bei der [Amazon SNS-Konsole](https://console.aws.amazon.com/sns/home) an.
1. Wählen Sie eine [Region aus, die SMS-Messaging unterstützt](https://docs.aws.amazon.com/general/latest/gr/end-user-messaging.html).
1. Wählen Sie im Navigationsbereich **Mobil** und dann **Textnachrichten (SMS)** aus.
1. Wählen Sie auf der Seite **Mobile text messaging (SMS) (Mobile Texttnachrichten (SMS))** im Abschnitt **Text messaging preferences (Textnachrichteneinstellungen)** die Option **Edit (Bearbeiten)** aus.
1. Führen Sie auf der Seite **Edit text messaging preferences (SMS-Einstellungen bearbeiten)** im Abschnitt **Details** Folgendes durch:
1. Wählen Sie für **Default message type (Standardnachrichtentyp)** eine der folgenden Optionen aus:
+ **Werbenachrichten** – Nicht kritische Nachrichten (zum Beispiel Marketing). Amazon SNS optimiert die Übertragung von Nachrichten im Hinblick auf möglichst niedrige Kosten.
+ **Transaktionsnachrichten** (Standard) – Kritische Nachrichten, die Kundentransaktionen unterstützen, wie beispielsweise One-Time-Passcodes für eine Multi-Faktor-Authentifizierung (MFA). Amazon SNS optimiert die Übertragung von Nachrichten im Hinblick auf höchste Zuverlässigkeit.
Informationen zu den Gebühren für Aktions- und Transaktionsnachrichten finden Sie unter [Global SMS Pricing](https://aws.amazon.com/sns/sms-pricing/).
1. (Optional) Geben Sie für **Account spend limit (Kontoausgabenlimit)** den Betrag in US-Dollar ein, den Sie pro Kalendermonat für SMS-Nachrichten ausgeben möchten.
**Wichtig**
Standardmäßig ist das Ausgabenkontingent auf 1,00 US-Dollar festgelegt. Wenn Sie das Service-Kontingent erhöhen möchten, [senden Sie eine Anfrage](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-sns).
Wenn die in der Konsole festgelegte Menge Ihr Service-Kontingent überschreitet, stoppt Amazon SNS die Veröffentlichung von SMS-Nachrichten.
Da Amazon SNS ein verteiltes System ist, beendet es das Senden von SMS-Nachrichten innerhalb von einigen Minuten nach der Überschreitung des Ausgabenkontingents. Wenn Sie während dieses Zeitraums weiter SMS-Nachrichten senden, können Kosten entstehen, die Ihr Kontingent überschreiten.
1. (Optional) Geben Sie im Feld **Default sender ID (Standard-Sender-ID)** eine benutzerdefinierte ID ein, wie z. B. Ihr Unternehmen, die als Sender des Empfängergeräts angezeigt wird.
**Anmerkung**
Die Support für den Absender IDs ist je nach Land unterschiedlich.
1. (Optional) Geben Sie den Namen des **Amazon S3 Bucket Namen für Nutzungsberichte ein.**
**Anmerkung**
Die Amazon S3 S3-Bucket-Richtlinie muss Schreibzugriff auf Amazon SNS gewähren.
1. Wählen Sie **Änderungen speichern ** aus.
## Einstellungen festlegen ()AWS SDKs
Um Ihre SMS-Einstellungen mithilfe einer der festzulegen AWS SDKs, verwenden Sie die Aktion in diesem SDK, die der `SetSMSAttributes` Anfrage in der Amazon SNS SNS-API entspricht. Mit dieser Anforderung können Sie Werte zu den verschiedenen SMS-Attributen zuweisen – beispielsweise das monatliche Ausgabenkontingent und Ihren Standard-SMS-Typ (Werbung oder Transaktionen). Informationen zu allen SMS-Attributen finden Sie unter [Set SMSAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetSMSAttributes.html) in der *Amazon Simple Notification Service API-Referenz*.
Die folgenden Code-Beispiele zeigen, wie `SetSMSAttributes` verwendet wird.
------
#### [ C\$1\$1 ]
**SDK für C\$1\$1**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/sns#code-examples) einrichten und ausführen.
So verwenden Sie Amazon SNS, um das SMSType Standardattribut festzulegen.
```
//! Set the default settings for sending SMS messages.
/*!
\param smsType: The type of SMS message that you will send by default.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::SNS::setSMSType(const Aws::String &smsType,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::SNS::SNSClient snsClient(clientConfiguration);
Aws::SNS::Model::SetSMSAttributesRequest request;
request.AddAttributes("DefaultSMSType", smsType);
const Aws::SNS::Model::SetSMSAttributesOutcome outcome = snsClient.SetSMSAttributes(
request);
if (outcome.IsSuccess()) {
std::cout << "SMS Type set successfully " << std::endl;
}
else {
std::cerr << "Error while setting SMS Type: '"
<< outcome.GetError().GetMessage()
<< "'" << std::endl;
}
return outcome.IsSuccess();
}
```
+ Einzelheiten zur API finden Sie unter [Set SMSAttributes](https://docs.aws.amazon.com/goto/SdkForCpp/sns-2010-03-31/SetSMSAttributes) in der *AWS SDK für C\$1\$1 API-Referenz.*
------
#### [ CLI ]
**AWS CLI**
**So legen Sie SMS-Nachrichtenattribute fest**
Im folgenden Beispiel für `set-sms-attributes` wird die standardmäßige Absender-ID für SMS-Nachrichten auf `MyName` festgelegt.
```
aws sns set-sms-attributes \
--attributes DefaultSenderID=MyName
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie unter [Set SMSAttributes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/set-sms-attributes.html) in der *AWS CLI Befehlsreferenz*.
------
#### [ Java ]
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/sns#code-examples) einrichten und ausführen.
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sns.SnsClient;
import software.amazon.awssdk.services.sns.model.SetSmsAttributesRequest;
import software.amazon.awssdk.services.sns.model.SetSmsAttributesResponse;
import software.amazon.awssdk.services.sns.model.SnsException;
import java.util.HashMap;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class SetSMSAttributes {
public static void main(String[] args) {
HashMap attributes = new HashMap<>(1);
attributes.put("DefaultSMSType", "Transactional");
attributes.put("UsageReportS3Bucket", "janbucket");
SnsClient snsClient = SnsClient.builder()
.region(Region.US_EAST_1)
.build();
setSNSAttributes(snsClient, attributes);
snsClient.close();
}
public static void setSNSAttributes(SnsClient snsClient, HashMap attributes) {
try {
SetSmsAttributesRequest request = SetSmsAttributesRequest.builder()
.attributes(attributes)
.build();
SetSmsAttributesResponse result = snsClient.setSMSAttributes(request);
System.out.println("Set default Attributes to " + attributes + ". Status was "
+ result.sdkHttpResponse().statusCode());
} catch (SnsException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
+ Einzelheiten zur API finden Sie unter [Set SMSAttributes](https://docs.aws.amazon.com/goto/SdkForJavaV2/sns-2010-03-31/SetSMSAttributes) in der *AWS SDK for Java 2.x API-Referenz*.
------
#### [ JavaScript ]
**SDK für JavaScript (v3)**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/sns#code-examples) einrichten und ausführen.
Erstellen Sie den Client in einem separaten Modul und exportieren Sie ihn.
```
import { SNSClient } from "@aws-sdk/client-sns";
// The AWS Region can be provided here using the `region` property. If you leave it blank
// the SDK will default to the region set in your AWS config.
export const snsClient = new SNSClient({});
```
Importieren Sie das SDK- und Client-Module und rufen Sie die API auf.
```
import { SetSMSAttributesCommand } from "@aws-sdk/client-sns";
import { snsClient } from "../libs/snsClient.js";
/**
* @param {"Transactional" | "Promotional"} defaultSmsType
*/
export const setSmsType = async (defaultSmsType = "Transactional") => {
const response = await snsClient.send(
new SetSMSAttributesCommand({
attributes: {
// Promotional – (Default) Noncritical messages, such as marketing messages.
// Transactional – Critical messages that support customer transactions,
// such as one-time passcodes for multi-factor authentication.
DefaultSMSType: defaultSmsType,
},
}),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '1885b977-2d7e-535e-8214-e44be727e265',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// }
// }
return response;
};
```
+ Weitere Informationen finden Sie im [AWS SDK für JavaScript -Entwicklerhandbuch](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/sns-examples-sending-sms.html#sending-sms-setattributes).
+ Einzelheiten zur API finden Sie unter [Set SMSAttributes](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/sns/command/SetSMSAttributesCommand) in der *AWS SDK für JavaScript API-Referenz*.
------
#### [ PHP ]
**SDK für PHP**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/php/example_code/sns#code-examples) einrichten und ausführen.
```
$SnSclient = new SnsClient([
'profile' => 'default',
'region' => 'us-east-1',
'version' => '2010-03-31'
]);
try {
$result = $SnSclient->SetSMSAttributes([
'attributes' => [
'DefaultSMSType' => 'Transactional',
],
]);
var_dump($result);
} catch (AwsException $e) {
// output error message if fails
error_log($e->getMessage());
}
```
+ Weitere Informationen finden Sie im [AWS SDK für PHP -Entwicklerhandbuch](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/sns-examples-sending-sms.html#set-sms-attributes).
+ Einzelheiten zur API finden Sie unter [Set SMSAttributes](https://docs.aws.amazon.com/goto/SdkForPHPV3/sns-2010-03-31/SetSMSAttributes) in der *AWS SDK für PHP API-Referenz*.
------
## Einstellung der SMS-Nachrichteneinstellungen für die länderspezifische Zustellung
Sie können Ihren SMS-Verkehr verwalten und kontrollieren, indem Sie Nachrichten nur an bestimmte Zielländer senden. Dadurch wird sichergestellt, dass Ihre Nachrichten nur in zugelassene Länder gesendet werden, wodurch unerwünschte SMS-Gebühren vermieden werden. Die folgenden Anweisungen verwenden die Protect-Konfiguration von Amazon Pinpoint, um die Länder anzugeben, die Sie zulassen oder blockieren möchten.
1. Öffnen Sie die AWS SMS Konsole unter. [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)
1. Wählen Sie im Navigationsbereich unter **Übersicht** im Abschnitt **Schnellstart** die Option **Create a protect configuration** aus.
1. Geben Sie unter **Protect-Konfigurationsdetails** einen **unternehmensfreundlichen Namen** für Ihre Protect-Konfiguration ein (z. B. Allow-Only-AU).
1. Wählen Sie unter **SMS-Länderregeln** das Kontrollkästchen **Region/Land** aus, um das Senden von Nachrichten in alle unterstützten Länder zu blockieren.
1. Deaktivieren Sie die Kontrollkästchen für die Länder, in die Sie Nachrichten senden möchten. Um beispielsweise nur Nachrichten nach Australien zuzulassen, deaktivieren Sie das Kontrollkästchen für **Australien**.
1. Wählen **Sie im Abschnitt Konfigurationszuordnungen schützen** unter **Zuordnungstyp** die Option **Kontostandard** aus. Dadurch wird sichergestellt, dass sich die AWS End User Messaging SMS Protect-Konfiguration auf alle Nachrichten auswirkt, die über Amazon SNS, [Amazon Cognito](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-identity-pools.html) und den Amazon Pinpoint [https://docs.aws.amazon.com/pinpoint/latest/developerguide/send-messages-sms.html](https://docs.aws.amazon.com/pinpoint/latest/developerguide/send-messages-sms.html)API-Aufruf gesendet werden.
1. Wählen Sie **Create Protect configuration aus, um Ihre Einstellungen** zu speichern.
Die folgende Bestätigungsmeldung wird angezeigt:
```
Success Protect configuration protect-abc0123456789 has been created.
```
1. Melden Sie sich bei der [Amazon-SNS-Konsole](https://console.aws.amazon.com/sns/home) an.
1. [**Veröffentlichen Sie eine Nachricht**](sns-publishing.md) in einem der blockierten Länder, z. B. Indien.
Die Nachricht wird nicht zugestellt. Sie können dies in den Zustellungsfehlerprotokollen mit überprüfen [CloudWatch](sms_stats_cloudwatch.md). Suchen Sie nach einer Protokollgruppe **sns/region/AccountID/DirectPublishToPhoneNumber/Failure**für eine Antwort, die dem folgenden Beispiel ähnelt:
```
{
"notification": {
"messageId": "bd59a509-XXXX-XXXX-82f8-fbdb8cb68217",
"timestamp": "YYYY-MM-DD XX:XX:XX.XXXX“
},
"delivery": {
"destination": "+91XXXXXXXXXX",
"smsType": "Transactional",
"providerResponse": "Cannot deliver message to the specified destination country",
"dwellTimeMs": 85
},
"status": "FAILURE"
}
```
# Verwaltung von Amazon SNS SNS-Telefonnummern und Abonnements
Amazon SNS bietet mehrere Optionen, mit denen Sie verwalten können, wer von Ihrem Konto SMS-Nachrichten erhält. Unter Berücksichtigung einer begrenzten Häufigkeit können Sie Telefonnummern, die den Empfang von SMS-Nachrichten von Ihrem Konto deaktiviert haben, hinzufügen. Um Nachrichten nicht länger an SMS-Abonnements zu senden, können Sie die Abonnements oder die Themen, die an diese Abonnements veröffentlichen, entfernen.
## Deaktivieren des Empfangs von SMS-Nachrichten
Sofern dies nach lokalen Gesetzen und Vorschriften (z. B. in den USA und Kanada) erforderlich ist, können SMS-Empfänger ihre Geräte verwenden, um sich abzumelden, indem sie auf die Nachricht mit einer der folgenden Antworten antworten:
+ ARRET (Französisch)
+ CANCEL
+ END
+ OPT-OUT
+ OPTOUT
+ QUIT
+ REMOVE
+ STOP
+ TD
+ UNSUBSCRIBE
Um sich abzumelden, muss der Empfänger auf dieselbe [Absendernummer](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers.html) antworten, die Amazon SNS für die Zustellung der Nachricht verwendet hat. Nach der Abmeldung erhält der Empfänger keine SMS-Nachrichten mehr von Ihnen, AWS-Konto es sei denn, Sie geben die Telefonnummer an.
Wenn die Telefonnummer ein Amazon SNS SNS-Thema abonniert hat, wird das Abonnement durch die Abmeldung nicht entfernt, aber SMS-Nachrichten können dieses Abonnement nicht zugestellt werden, es sei denn, Sie haben die Telefonnummer aktiviert.
## Verwaltung von Telefonnummern und Abonnements mit der Amazon SNS SNS-Konsole
Sie können über die Amazon SNS-Konsole steuern, welche Telefonnummern SMS-Nachrichten von Ihrem Konto empfangen.
### Anmeldung einer Telefonnummer, für die die Amazon SNS-Konsole deaktiviert wurde
Sie können sehen, welche Telefonnummern für den Empfang von SMS-Nachrichten von Ihrem Konto deaktiviert wurden, und Sie können diese Telefonnummern aktivieren, um weiterhin Nachrichten an diese Personen zu senden.
Sie können sich nur einmal alle 30 Tage für eine Telefonnummer anmelden.
1. Melden Sie sich bei der [Amazon SNS-Konsole](https://console.aws.amazon.com/sns/home) an.
1. Legen Sie im Konsolenmenü unter der Regionsauswahl eine [-Region fest, die SMS-Messaging unterstützt](https://docs.aws.amazon.com/general/latest/gr/end-user-messaging.html).
1. Wählen Sie im Navigationsbereich **Text messaging (SMS) (Textnachrichten (SMS))** aus.
1. Auf der Seite **SMS (Mobile Textnachrichten)** werden **im Abschnitt Abgemeldete Telefonnummern** angezeigt.
1. **Aktivieren Sie das Kontrollkästchen für die Telefonnummer, für die Sie sich anmelden möchten, und wählen Sie Anmelden.** Die Telefonnummer ist nicht mehr deaktiviert und empfängt SMS-Nachrichten, die Sie an sie senden.
#### Löschen eines SMS-Abonnements: Die Amazon SNS SNS-Konsole
Löschen Sie ein SMS-Abonnement, um nicht länger SMS-Nachrichten über Veröffentlichungen zu Ihren Themen an diese Telefonnummer zu senden.
1. Wählen Sie im Navigationsbereich **Subscriptions** (Abonnements) aus.
1. Aktivieren Sie die Kontrollkästchen für die Abonnements, die Sie löschen möchten. Wählen Sie anschließend **Actions (Aktionen)** und **Delete Subscriptions (Abonnements löschen)** aus.
1. Wählen Sie im Fenster **Löschen** **Löschen** aus. Amazon SNS löscht das Abonnement und zeigt eine Erfolgsmeldung an.
#### Löschen eines Themas in der Amazon SNS SNS-Konsole
Löschen Sie ein Thema, wenn Sie nicht länger Nachrichten an die Endpunkte veröffentlichen möchten, die dieses Thema abonniert haben.
1. Wählen Sie im Navigationsbereich **Topics** (Themen) aus.
1. Aktivieren Sie die Kontrollkästchen der Themen, die Sie löschen möchten. Wählen Sie anschließend **Actions (Aktionen)** und **Delete Topics (Themen löschen)** aus.
1. Wählen Sie im Fenster **Löschen** **Löschen** aus. Amazon SNS löscht das Thema und zeigt eine Erfolgsmeldung an.
### Verwaltung von Telefonnummern und Abonnements mithilfe des SDK AWS
Sie können den verwenden AWS SDKs , um programmatische Anfragen an Amazon SNS zu stellen und zu verwalten, welche Telefonnummern SMS-Nachrichten von Ihrem Konto empfangen können.
Um ein AWS SDK verwenden zu können, müssen Sie es mit Ihren Anmeldeinformationen konfigurieren. Weitere Informationen finden Sie unter [Gemeinsam genutzte Konfigurations- und Anmeldeinformationsdateien](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) im Referenzhandbuch *AWS SDKs und im Tools-Referenzhandbuch*.
#### Alle Telefonnummern, für die Sie sich abgemeldet haben, mithilfe des SDK anzeigen AWS
Um alle abgemeldeten Telefonnummern einzusehen, reichen Sie eine `ListPhoneNumbersOptedOut` Anfrage mit der Amazon SNS SNS-API ein.
Die folgenden Code-Beispiele zeigen, wie `ListPhoneNumbersOptedOut` verwendet wird.
------
#### [ CLI ]
**AWS CLI**
**So führen Sie Abmeldungen für SMS-Nachrichten auf**
Das folgende `list-phone-numbers-opted-out`-Beispiel listet die Telefonnummern auf, bei denen der Empfang von SMS-Nachrichten abbestellt wurde.
```
aws sns list-phone-numbers-opted-out
```
Ausgabe:
```
{
"phoneNumbers": [
"+15555550100"
]
}
```
+ *Einzelheiten zur API finden Sie in der Befehlsreferenz [ListPhoneNumbersOptedOut](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/list-phone-numbers-opted-out.html).AWS CLI *
------
#### [ Java ]
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/sns#code-examples) einrichten und ausführen.
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sns.SnsClient;
import software.amazon.awssdk.services.sns.model.ListPhoneNumbersOptedOutRequest;
import software.amazon.awssdk.services.sns.model.ListPhoneNumbersOptedOutResponse;
import software.amazon.awssdk.services.sns.model.SnsException;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class ListOptOut {
public static void main(String[] args) {
SnsClient snsClient = SnsClient.builder()
.region(Region.US_EAST_1)
.build();
listOpts(snsClient);
snsClient.close();
}
public static void listOpts(SnsClient snsClient) {
try {
ListPhoneNumbersOptedOutRequest request = ListPhoneNumbersOptedOutRequest.builder().build();
ListPhoneNumbersOptedOutResponse result = snsClient.listPhoneNumbersOptedOut(request);
System.out.println("Status is " + result.sdkHttpResponse().statusCode() + "\n\nPhone Numbers: \n\n"
+ result.phoneNumbers());
} catch (SnsException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
+ Einzelheiten zur API finden Sie [ListPhoneNumbersOptedOut](https://docs.aws.amazon.com/goto/SdkForJavaV2/sns-2010-03-31/ListPhoneNumbersOptedOut)in der *AWS SDK for Java 2.x API-Referenz*.
------
#### [ PHP ]
**SDK für PHP**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/php/example_code/sns#code-examples) einrichten und ausführen.
```
require 'vendor/autoload.php';
use Aws\Exception\AwsException;
use Aws\Sns\SnsClient;
/**
* Returns a list of phone numbers that are opted out of receiving SMS messages from your AWS SNS account.
*
* This code expects that you have AWS credentials set up per:
* https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/guide_credentials.html
*/
$SnSclient = new SnsClient([
'profile' => 'default',
'region' => 'us-east-1',
'version' => '2010-03-31'
]);
try {
$result = $SnSclient->listPhoneNumbersOptedOut();
var_dump($result);
} catch (AwsException $e) {
// output error message if fails
error_log($e->getMessage());
}
```
+ Weitere Informationen finden Sie im [AWS SDK für PHP -Entwicklerhandbuch](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/sns-examples-sending-sms.html#list-opted-out-phone-numbers).
+ Einzelheiten zur API finden Sie [ListPhoneNumbersOptedOut](https://docs.aws.amazon.com/goto/SdkForPHPV3/sns-2010-03-31/ListPhoneNumbersOptedOut)in der *AWS SDK für PHP API-Referenz*.
------
#### Mithilfe des SDK wird überprüft, ob eine Telefonnummer deaktiviert wurde AWS
Um zu überprüfen, ob eine Telefonnummer deaktiviert ist, reichen Sie eine `CheckIfPhoneNumberIsOptedOut` Anfrage mit der Amazon SNS SNS-API ein.
Die folgenden Code-Beispiele zeigen, wie `CheckIfPhoneNumberIsOptedOut` verwendet wird.
------
#### [ .NET ]
**SDK für .NET**
Es gibt noch mehr dazu. GitHub Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/SNS#code-examples) einrichten und ausführen.
```
using System;
using System.Threading.Tasks;
using Amazon.SimpleNotificationService;
using Amazon.SimpleNotificationService.Model;
///
/// This example shows how to use the Amazon Simple Notification Service
/// (Amazon SNS) to check whether a phone number has been opted out.
///
public class IsPhoneNumOptedOut
{
public static async Task Main()
{
string phoneNumber = "+15551112222";
IAmazonSimpleNotificationService client = new AmazonSimpleNotificationServiceClient();
await CheckIfOptedOutAsync(client, phoneNumber);
}
///
/// Checks to see if the supplied phone number has been opted out.
///
/// The initialized Amazon SNS Client object used
/// to check if the phone number has been opted out.
/// A string representing the phone number
/// to check.
public static async Task CheckIfOptedOutAsync(IAmazonSimpleNotificationService client, string phoneNumber)
{
var request = new CheckIfPhoneNumberIsOptedOutRequest
{
PhoneNumber = phoneNumber,
};
try
{
var response = await client.CheckIfPhoneNumberIsOptedOutAsync(request);
if (response.HttpStatusCode == System.Net.HttpStatusCode.OK)
{
string optOutStatus = response.IsOptedOut ? "opted out" : "not opted out.";
Console.WriteLine($"The phone number: {phoneNumber} is {optOutStatus}");
}
}
catch (AuthorizationErrorException ex)
{
Console.WriteLine($"{ex.Message}");
}
}
}
```
+ Einzelheiten zur API finden Sie [CheckIfPhoneNumberIsOptedOut](https://docs.aws.amazon.com/goto/DotNetSDKV3/sns-2010-03-31/CheckIfPhoneNumberIsOptedOut)in der *AWS SDK für .NET API-Referenz*.
------
#### [ CLI ]
**AWS CLI**
**So überprüfen Sie SMS-Nachrichten-Abmeldungen für eine Telefonnummer**
Im folgenden `check-if-phone-number-is-opted-out` Beispiel wird geprüft, ob die angegebene Telefonnummer den Empfang von SMS-Nachrichten vom AWS Girokonto deaktiviert hat.
```
aws sns check-if-phone-number-is-opted-out \
--phone-number +1555550100
```
Ausgabe:
```
{
"isOptedOut": false
}
```
+ Einzelheiten zur API finden Sie [CheckIfPhoneNumberIsOptedOut](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/check-if-phone-number-is-opted-out.html)unter *AWS CLI Befehlsreferenz*.
------
#### [ Java ]
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/sns#code-examples) einrichten und ausführen.
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sns.SnsClient;
import software.amazon.awssdk.services.sns.model.CheckIfPhoneNumberIsOptedOutRequest;
import software.amazon.awssdk.services.sns.model.CheckIfPhoneNumberIsOptedOutResponse;
import software.amazon.awssdk.services.sns.model.SnsException;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class CheckOptOut {
public static void main(String[] args) {
final String usage = """
Usage:
Where:
phoneNumber - The mobile phone number to look up (for example, +1XXX5550100).
""";
if (args.length != 1) {
System.out.println(usage);
System.exit(1);
}
String phoneNumber = args[0];
SnsClient snsClient = SnsClient.builder()
.region(Region.US_EAST_1)
.build();
checkPhone(snsClient, phoneNumber);
snsClient.close();
}
public static void checkPhone(SnsClient snsClient, String phoneNumber) {
try {
CheckIfPhoneNumberIsOptedOutRequest request = CheckIfPhoneNumberIsOptedOutRequest.builder()
.phoneNumber(phoneNumber)
.build();
CheckIfPhoneNumberIsOptedOutResponse result = snsClient.checkIfPhoneNumberIsOptedOut(request);
System.out.println(
result.isOptedOut() + "Phone Number " + phoneNumber + " has Opted Out of receiving sns messages." +
"\n\nStatus was " + result.sdkHttpResponse().statusCode());
} catch (SnsException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
+ Einzelheiten zur API finden Sie [CheckIfPhoneNumberIsOptedOut](https://docs.aws.amazon.com/goto/SdkForJavaV2/sns-2010-03-31/CheckIfPhoneNumberIsOptedOut)in der *AWS SDK for Java 2.x API-Referenz*.
------
#### [ JavaScript ]
**SDK für JavaScript (v3)**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/sns#code-examples) einrichten und ausführen.
Erstellen Sie den Client in einem separaten Modul und exportieren Sie ihn.
```
import { SNSClient } from "@aws-sdk/client-sns";
// The AWS Region can be provided here using the `region` property. If you leave it blank
// the SDK will default to the region set in your AWS config.
export const snsClient = new SNSClient({});
```
Importieren Sie das SDK- und Client-Module und rufen Sie die API auf.
```
import { CheckIfPhoneNumberIsOptedOutCommand } from "@aws-sdk/client-sns";
import { snsClient } from "../libs/snsClient.js";
export const checkIfPhoneNumberIsOptedOut = async (
phoneNumber = "5555555555",
) => {
const command = new CheckIfPhoneNumberIsOptedOutCommand({
phoneNumber,
});
const response = await snsClient.send(command);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '3341c28a-cdc8-5b39-a3ee-9fb0ee125732',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// isOptedOut: false
// }
return response;
};
```
+ Weitere Informationen finden Sie im [AWS SDK für JavaScript -Entwicklerhandbuch](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/sns-examples-sending-sms.html#sending-sms-checkifphonenumberisoptedout).
+ Einzelheiten zur API finden Sie [CheckIfPhoneNumberIsOptedOut](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/sns/command/CheckIfPhoneNumberIsOptedOutCommand)in der *AWS SDK für JavaScript API-Referenz*.
------
#### [ PHP ]
**SDK für PHP**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/php/example_code/sns#code-examples) einrichten und ausführen.
```
require 'vendor/autoload.php';
use Aws\Exception\AwsException;
use Aws\Sns\SnsClient;
/**
* Indicates whether the phone number owner has opted out of receiving SMS messages from your AWS SNS account.
*
* This code expects that you have AWS credentials set up per:
* https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/guide_credentials.html
*/
$SnSclient = new SnsClient([
'profile' => 'default',
'region' => 'us-east-1',
'version' => '2010-03-31'
]);
$phone = '+1XXX5550100';
try {
$result = $SnSclient->checkIfPhoneNumberIsOptedOut([
'phoneNumber' => $phone,
]);
var_dump($result);
} catch (AwsException $e) {
// output error message if fails
error_log($e->getMessage());
}
```
+ Weitere Informationen finden Sie im [AWS SDK für PHP -Entwicklerhandbuch](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/sns-examples-sending-sms.html#check-if-a-phone-number-has-opted-out).
+ Einzelheiten zur API finden Sie [CheckIfPhoneNumberIsOptedOut](https://docs.aws.amazon.com/goto/SdkForPHPV3/sns-2010-03-31/CheckIfPhoneNumberIsOptedOut)in der *AWS SDK für PHP API-Referenz*.
------
#### Anmeldung einer Telefonnummer, die über die Amazon SNS-API deaktiviert wurde
Um sich für eine Telefonnummer anzumelden, reichen Sie eine `OptInPhoneNumber` Anfrage mit der Amazon SNS SNS-API ein.
Sie können sich nur einmal alle 30 Tage für eine Telefonnummer anmelden.
#### Löschen eines SMS-Abonnements mithilfe des SDK AWS
Um ein SMS-Abonnement von einem Amazon SNS-Thema zu löschen, müssen Sie zunächst anhand einer `ListSubscriptions`-Anfrage über das Amazon SNS-API den ARN des Abonnements abrufen und anschließend den ARN einer `Unsubscribe`-Anfrage übergeben.
Die folgenden Code-Beispiele zeigen, wie `Unsubscribe` verwendet wird.
------
#### [ .NET ]
**SDK für .NET**
Es gibt noch mehr dazu. GitHub Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/cross-service/TopicsAndQueues#code-examples) einrichten und ausführen.
Melden Sie sich mit einem Abonnement-ARN von einem Thema ab.
```
///
/// Unsubscribe from a topic by a subscription ARN.
///
/// The ARN of the subscription.
/// True if successful.
public async Task UnsubscribeByArn(string subscriptionArn)
{
var unsubscribeResponse = await _amazonSNSClient.UnsubscribeAsync(
new UnsubscribeRequest()
{
SubscriptionArn = subscriptionArn
});
return unsubscribeResponse.HttpStatusCode == HttpStatusCode.OK;
}
```
+ Weitere API-Informationen finden Sie unter [Unsubscribe](https://docs.aws.amazon.com/goto/DotNetSDKV3/sns-2010-03-31/Unsubscribe) in der *AWS SDK für .NET -API-Referenz*.
------
#### [ C\$1\$1 ]
**SDK für C\$1\$1**
Es gibt noch mehr GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/sns#code-examples) einrichten und ausführen.
```
//! Delete a subscription to an Amazon Simple Notification Service (Amazon SNS) topic.
/*!
\param subscriptionARN: The Amazon Resource Name (ARN) for an Amazon SNS topic subscription.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::SNS::unsubscribe(const Aws::String &subscriptionARN,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::SNS::SNSClient snsClient(clientConfiguration);
Aws::SNS::Model::UnsubscribeRequest request;
request.SetSubscriptionArn(subscriptionARN);
const Aws::SNS::Model::UnsubscribeOutcome outcome = snsClient.Unsubscribe(request);
if (outcome.IsSuccess()) {
std::cout << "Unsubscribed successfully " << std::endl;
}
else {
std::cerr << "Error while unsubscribing " << outcome.GetError().GetMessage()
<< std::endl;
}
return outcome.IsSuccess();
}
```
+ Weitere API-Informationen finden Sie unter [Unsubscribe](https://docs.aws.amazon.com/goto/SdkForCpp/sns-2010-03-31/Unsubscribe) in der *AWS SDK für C\$1\$1 -API-Referenz*.
------
#### [ CLI ]
**AWS CLI**
**So melden Sie sich von einem Thema ab**
Im folgenden Beispiel für `unsubscribe` wird das angegebene Abonnement aus einem Thema gelöscht.
```
aws sns unsubscribe \
--subscription-arn arn:aws:sns:us-west-2:0123456789012:my-topic:8a21d249-4329-4871-acc6-7be709c6ea7f
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Weitere API-Informationen finden Sie unter [Unsubscribe](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/unsubscribe.html) in der *AWS CLI -Befehlsreferenz*.
------
#### [ Java ]
**SDK für Java 2.x**
Es gibt noch mehr GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/sns#code-examples) einrichten und ausführen.
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sns.SnsClient;
import software.amazon.awssdk.services.sns.model.SnsException;
import software.amazon.awssdk.services.sns.model.UnsubscribeRequest;
import software.amazon.awssdk.services.sns.model.UnsubscribeResponse;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class Unsubscribe {
public static void main(String[] args) {
final String usage = """
Usage:
Where:
subscriptionArn - The ARN of the subscription to delete.
""";
if (args.length < 1) {
System.out.println(usage);
System.exit(1);
}
String subscriptionArn = args[0];
SnsClient snsClient = SnsClient.builder()
.region(Region.US_EAST_1)
.build();
unSub(snsClient, subscriptionArn);
snsClient.close();
}
public static void unSub(SnsClient snsClient, String subscriptionArn) {
try {
UnsubscribeRequest request = UnsubscribeRequest.builder()
.subscriptionArn(subscriptionArn)
.build();
UnsubscribeResponse result = snsClient.unsubscribe(request);
System.out.println("\n\nStatus was " + result.sdkHttpResponse().statusCode()
+ "\n\nSubscription was removed for " + request.subscriptionArn());
} catch (SnsException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
+ Weitere API-Informationen finden Sie unter [Unsubscribe](https://docs.aws.amazon.com/goto/SdkForJavaV2/sns-2010-03-31/Unsubscribe) in der *AWS SDK for Java 2.x -API-Referenz*.
------
#### [ JavaScript ]
**SDK für JavaScript (v3)**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/sns#code-examples) einrichten und ausführen.
Erstellen Sie den Client in einem separaten Modul und exportieren Sie ihn.
```
import { SNSClient } from "@aws-sdk/client-sns";
// The AWS Region can be provided here using the `region` property. If you leave it blank
// the SDK will default to the region set in your AWS config.
export const snsClient = new SNSClient({});
```
Importieren Sie das SDK- und Client-Module und rufen Sie die API auf.
```
import { UnsubscribeCommand } from "@aws-sdk/client-sns";
import { snsClient } from "../libs/snsClient.js";
/**
* @param {string} subscriptionArn - The ARN of the subscription to cancel.
*/
const unsubscribe = async (
subscriptionArn = "arn:aws:sns:us-east-1:xxxxxxxxxxxx:mytopic:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
) => {
const response = await snsClient.send(
new UnsubscribeCommand({
SubscriptionArn: subscriptionArn,
}),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '0178259a-9204-507c-b620-78a7570a44c6',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// }
// }
return response;
};
```
+ Weitere Informationen finden Sie im [AWS SDK für JavaScript -Entwicklerhandbuch](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/sns-examples-managing-topics.html#sns-examples-unsubscribing).
+ Weitere API-Informationen finden Sie unter [Unsubscribe](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/sns/command/UnsubscribeCommand) in der *AWS SDK für JavaScript -API-Referenz*.
------
#### [ Kotlin ]
**SDK für Kotlin**
Es gibt noch mehr GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/sns#code-examples) einrichten und ausführen.
```
suspend fun unSub(subscriptionArnVal: String) {
val request =
UnsubscribeRequest {
subscriptionArn = subscriptionArnVal
}
SnsClient.fromEnvironment { region = "us-east-1" }.use { snsClient ->
snsClient.unsubscribe(request)
println("Subscription was removed for ${request.subscriptionArn}")
}
}
```
+ Weitere API-Informationen finden Sie unter [Unsubscribe](https://sdk.amazonaws.com/kotlin/api/latest/index.html) in der *API-Referenz zum AWS SDK für Kotlin*.
------
#### [ PHP ]
**SDK für PHP**
Es gibt noch mehr GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/php/example_code/sns#code-examples) einrichten und ausführen.
```
require 'vendor/autoload.php';
use Aws\Exception\AwsException;
use Aws\Sns\SnsClient;
/**
* Deletes a subscription to an Amazon SNS topic.
*
* This code expects that you have AWS credentials set up per:
* https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/guide_credentials.html
*/
$SnSclient = new SnsClient([
'profile' => 'default',
'region' => 'us-east-1',
'version' => '2010-03-31'
]);
$subscription = 'arn:aws:sns:us-east-1:111122223333:MySubscription';
try {
$result = $SnSclient->unsubscribe([
'SubscriptionArn' => $subscription,
]);
var_dump($result);
} catch (AwsException $e) {
// output error message if fails
error_log($e->getMessage());
}
```
+ Weitere Informationen finden Sie im [AWS SDK für PHP -Entwicklerhandbuch](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/sns-examples-subscribing-unsubscribing-topics.html#unsubscribe-from-a-topic).
+ Weitere API-Informationen finden Sie unter [Unsubscribe](https://docs.aws.amazon.com/goto/SdkForPHPV3/sns-2010-03-31/Unsubscribe) in der *AWS SDK für PHP -API-Referenz*.
------
#### [ Python ]
**SDK für Python (Boto3)**
Es gibt noch mehr GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/sns#code-examples) einrichten und ausführen.
```
class SnsWrapper:
"""Encapsulates Amazon SNS topic and subscription functions."""
def __init__(self, sns_resource):
"""
:param sns_resource: A Boto3 Amazon SNS resource.
"""
self.sns_resource = sns_resource
@staticmethod
def delete_subscription(subscription):
"""
Unsubscribes and deletes a subscription.
"""
try:
subscription.delete()
logger.info("Deleted subscription %s.", subscription.arn)
except ClientError:
logger.exception("Couldn't delete subscription %s.", subscription.arn)
raise
```
```
class SnsWrapper:
"""Wrapper class for managing Amazon SNS operations."""
def __init__(self, sns_client: Any) -> None:
"""
Initialize the SnsWrapper.
:param sns_client: A Boto3 Amazon SNS client.
"""
self.sns_client = sns_client
@classmethod
def from_client(cls) -> 'SnsWrapper':
"""
Create an SnsWrapper instance using a default boto3 client.
:return: An instance of this class.
"""
sns_client = boto3.client('sns')
return cls(sns_client)
def unsubscribe(self, subscription_arn: str) -> bool:
"""
Unsubscribe from an SNS topic.
:param subscription_arn: The ARN of the subscription to remove.
:return: True if successful.
:raises ClientError: If the unsubscribe operation fails.
"""
try:
self.sns_client.unsubscribe(SubscriptionArn=subscription_arn)
logger.info(f"Unsubscribed: {subscription_arn}")
return True
except ClientError as e:
error_code = e.response.get('Error', {}).get('Code', 'Unknown')
if error_code == 'NotFound':
logger.warning(f"Subscription not found: {subscription_arn}")
return True # Already unsubscribed
else:
logger.error(f"Error unsubscribing: {error_code} - {e}")
raise
```
+ Weitere API-Informationen finden Sie unter [Unsubscribe](https://docs.aws.amazon.com/goto/boto3/sns-2010-03-31/Unsubscribe) in der *API-Referenz zu AWS SDK für Python (Boto3)*.
------
#### [ SAP ABAP ]
**SDK für SAP ABAP**
Es gibt noch mehr dazu. GitHub Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/sns#code-examples) einrichten und ausführen.
```
TRY.
lo_sns->unsubscribe( iv_subscriptionarn = iv_subscription_arn ).
MESSAGE 'Subscription deleted.' TYPE 'I'.
CATCH /aws1/cx_snsnotfoundexception.
MESSAGE 'Subscription does not exist.' TYPE 'E'.
CATCH /aws1/cx_snsinvalidparameterex.
MESSAGE 'Subscription with "PendingConfirmation" status cannot be deleted/unsubscribed. Confirm subscription before performing unsubscribe operation.' TYPE 'E'.
ENDTRY.
```
+ Weitere API-Informationen finden Sie unter [Unsubscribe](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in der *API-Referenz zum AWS SDK für SAP ABAP*.
------
#### [ Swift ]
**SDK für Swift**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/swift/example_code/sns#code-examples) einrichten und ausführen.
```
import AWSSNS
let config = try await SNSClient.SNSClientConfiguration(region: region)
let snsClient = SNSClient(config: config)
_ = try await snsClient.unsubscribe(
input: UnsubscribeInput(
subscriptionArn: arn
)
)
print("Unsubscribed.")
```
+ Weitere API-Informationen finden Sie unter [Unsubscribe](https://sdk.amazonaws.com/swift/api/awssns/latest/documentation/awssns/snsclient/unsubscribe(input:)) in der *API-Referenz zum AWS -SDK für Swift*.
------
#### Löschen eines Themas mithilfe des AWS SDK
Um ein Thema und alle seine Abonnements zu löschen, müssen Sie zunächst anhand einer `ListTopics`-Anfrage über die Amazon SNS-API den ARN des Abonnements einholen und anschließend den ARN einer `DeleteTopic`-Anfrage übergeben.
Die folgenden Code-Beispiele zeigen, wie `DeleteTopic` verwendet wird.
------
#### [ .NET ]
**SDK für .NET**
Es gibt noch mehr dazu. GitHub Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/cross-service/TopicsAndQueues#code-examples) einrichten und ausführen.
Löschen Sie ein Thema mit seinem Themen-ARN.
```
///
/// Delete a topic by its topic ARN.
///
/// The ARN of the topic.
/// True if successful.
public async Task DeleteTopicByArn(string topicArn)
{
var deleteResponse = await _amazonSNSClient.DeleteTopicAsync(
new DeleteTopicRequest()
{
TopicArn = topicArn
});
return deleteResponse.HttpStatusCode == HttpStatusCode.OK;
}
```
+ Einzelheiten zur API finden Sie [DeleteTopic](https://docs.aws.amazon.com/goto/DotNetSDKV3/sns-2010-03-31/DeleteTopic)in der *AWS SDK für .NET API-Referenz*.
------
#### [ C\$1\$1 ]
**SDK für C\$1\$1**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp/example_code/sns#code-examples) einrichten und ausführen.
```
//! Delete an Amazon Simple Notification Service (Amazon SNS) topic.
/*!
\param topicARN: The Amazon Resource Name (ARN) for an Amazon SNS topic.
\param clientConfiguration: AWS client configuration.
\return bool: Function succeeded.
*/
bool AwsDoc::SNS::deleteTopic(const Aws::String &topicARN,
const Aws::Client::ClientConfiguration &clientConfiguration) {
Aws::SNS::SNSClient snsClient(clientConfiguration);
Aws::SNS::Model::DeleteTopicRequest request;
request.SetTopicArn(topicARN);
const Aws::SNS::Model::DeleteTopicOutcome outcome = snsClient.DeleteTopic(request);
if (outcome.IsSuccess()) {
std::cout << "Successfully deleted the Amazon SNS topic " << topicARN << std::endl;
}
else {
std::cerr << "Error deleting topic " << topicARN << ":" <<
outcome.GetError().GetMessage() << std::endl;
}
return outcome.IsSuccess();
}
```
+ Einzelheiten zur API finden Sie [DeleteTopic](https://docs.aws.amazon.com/goto/SdkForCpp/sns-2010-03-31/DeleteTopic)in der *AWS SDK für C\$1\$1 API-Referenz*.
------
#### [ CLI ]
**AWS CLI**
**So löschen Sie das SNS-Thema**
Das folgende `delete-topic`-Beispiel löscht die angegebene SNS-Thema.
```
aws sns delete-topic \
--topic-arn "arn:aws:sns:us-west-2:123456789012:my-topic"
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
+ Einzelheiten zur API finden Sie [DeleteTopic](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sns/delete-topic.html)in der *AWS CLI Befehlsreferenz*.
------
#### [ Go ]
**SDK für Go V2**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/gov2/workflows/topics_and_queues#code-examples) einrichten und ausführen.
```
import (
"context"
"encoding/json"
"log"
"github.com/aws/aws-sdk-go-v2/aws"
"github.com/aws/aws-sdk-go-v2/service/sns"
"github.com/aws/aws-sdk-go-v2/service/sns/types"
)
// SnsActions encapsulates the Amazon Simple Notification Service (Amazon SNS) actions
// used in the examples.
type SnsActions struct {
SnsClient *sns.Client
}
// DeleteTopic delete an Amazon SNS topic.
func (actor SnsActions) DeleteTopic(ctx context.Context, topicArn string) error {
_, err := actor.SnsClient.DeleteTopic(ctx, &sns.DeleteTopicInput{
TopicArn: aws.String(topicArn)})
if err != nil {
log.Printf("Couldn't delete topic %v. Here's why: %v\n", topicArn, err)
}
return err
}
```
+ Einzelheiten zur API finden Sie [DeleteTopic](https://pkg.go.dev/github.com/aws/aws-sdk-go-v2/service/sns#Client.DeleteTopic)in der *AWS SDK für Go API-Referenz*.
------
#### [ Java ]
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/sns#code-examples) einrichten und ausführen.
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.sns.SnsClient;
import software.amazon.awssdk.services.sns.model.DeleteTopicRequest;
import software.amazon.awssdk.services.sns.model.DeleteTopicResponse;
import software.amazon.awssdk.services.sns.model.SnsException;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class DeleteTopic {
public static void main(String[] args) {
final String usage = """
Usage:
Where:
topicArn - The ARN of the topic to delete.
""";
if (args.length != 1) {
System.out.println(usage);
System.exit(1);
}
String topicArn = args[0];
SnsClient snsClient = SnsClient.builder()
.region(Region.US_EAST_1)
.build();
System.out.println("Deleting a topic with name: " + topicArn);
deleteSNSTopic(snsClient, topicArn);
snsClient.close();
}
public static void deleteSNSTopic(SnsClient snsClient, String topicArn) {
try {
DeleteTopicRequest request = DeleteTopicRequest.builder()
.topicArn(topicArn)
.build();
DeleteTopicResponse result = snsClient.deleteTopic(request);
System.out.println("\n\nStatus was " + result.sdkHttpResponse().statusCode());
} catch (SnsException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
+ Einzelheiten zur API finden Sie [DeleteTopic](https://docs.aws.amazon.com/goto/SdkForJavaV2/sns-2010-03-31/DeleteTopic)in der *AWS SDK for Java 2.x API-Referenz*.
------
#### [ JavaScript ]
**SDK für JavaScript (v3)**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/sns#code-examples) einrichten und ausführen.
Erstellen Sie den Client in einem separaten Modul und exportieren Sie ihn.
```
import { SNSClient } from "@aws-sdk/client-sns";
// The AWS Region can be provided here using the `region` property. If you leave it blank
// the SDK will default to the region set in your AWS config.
export const snsClient = new SNSClient({});
```
Importieren Sie das SDK- und Client-Module und rufen Sie die API auf.
```
import { DeleteTopicCommand } from "@aws-sdk/client-sns";
import { snsClient } from "../libs/snsClient.js";
/**
* @param {string} topicArn - The ARN of the topic to delete.
*/
export const deleteTopic = async (topicArn = "TOPIC_ARN") => {
const response = await snsClient.send(
new DeleteTopicCommand({ TopicArn: topicArn }),
);
console.log(response);
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: 'a10e2886-5a8f-5114-af36-75bd39498332',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// }
// }
};
```
+ Weitere Informationen finden Sie im [AWS SDK für JavaScript -Entwicklerhandbuch](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/sns-examples-managing-topics.html#sns-examples-managing-topics-deletetopic).
+ Einzelheiten zur API finden Sie [DeleteTopic](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/sns/command/DeleteTopicCommand)in der *AWS SDK für JavaScript API-Referenz*.
------
#### [ Kotlin ]
**SDK für Kotlin**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/sns#code-examples) einrichten und ausführen.
```
suspend fun deleteSNSTopic(topicArnVal: String) {
val request =
DeleteTopicRequest {
topicArn = topicArnVal
}
SnsClient.fromEnvironment { region = "us-east-1" }.use { snsClient ->
snsClient.deleteTopic(request)
println("$topicArnVal was successfully deleted.")
}
}
```
+ Einzelheiten zur API finden Sie [DeleteTopic](https://sdk.amazonaws.com/kotlin/api/latest/index.html)in der *API-Referenz zum AWS SDK für Kotlin*.
------
#### [ PHP ]
**SDK für PHP**
Es gibt noch mehr dazu. GitHub Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/php/example_code/sns#code-examples) einrichten und ausführen.
```
require 'vendor/autoload.php';
use Aws\Exception\AwsException;
use Aws\Sns\SnsClient;
/**
* Deletes an SNS topic and all its subscriptions.
*
* This code expects that you have AWS credentials set up per:
* https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/guide_credentials.html
*/
$SnSclient = new SnsClient([
'profile' => 'default',
'region' => 'us-east-1',
'version' => '2010-03-31'
]);
$topic = 'arn:aws:sns:us-east-1:111122223333:MyTopic';
try {
$result = $SnSclient->deleteTopic([
'TopicArn' => $topic,
]);
var_dump($result);
} catch (AwsException $e) {
// output error message if fails
error_log($e->getMessage());
}
```
+ Einzelheiten zur API finden Sie [DeleteTopic](https://docs.aws.amazon.com/goto/SdkForPHPV3/sns-2010-03-31/DeleteTopic)in der *AWS SDK für PHP API-Referenz*.
------
#### [ Python ]
**SDK für Python (Boto3)**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/sns#code-examples) einrichten und ausführen.
```
class SnsWrapper:
"""Encapsulates Amazon SNS topic and subscription functions."""
def __init__(self, sns_resource):
"""
:param sns_resource: A Boto3 Amazon SNS resource.
"""
self.sns_resource = sns_resource
@staticmethod
def delete_topic(topic):
"""
Deletes a topic. All subscriptions to the topic are also deleted.
"""
try:
topic.delete()
logger.info("Deleted topic %s.", topic.arn)
except ClientError:
logger.exception("Couldn't delete topic %s.", topic.arn)
raise
```
```
class SnsWrapper:
"""Wrapper class for managing Amazon SNS operations."""
def __init__(self, sns_client: Any) -> None:
"""
Initialize the SnsWrapper.
:param sns_client: A Boto3 Amazon SNS client.
"""
self.sns_client = sns_client
@classmethod
def from_client(cls) -> 'SnsWrapper':
"""
Create an SnsWrapper instance using a default boto3 client.
:return: An instance of this class.
"""
sns_client = boto3.client('sns')
return cls(sns_client)
def delete_topic(self, topic_arn: str) -> bool:
"""
Delete an SNS topic.
:param topic_arn: The ARN of the topic to delete.
:return: True if successful.
:raises ClientError: If the topic deletion fails.
"""
try:
self.sns_client.delete_topic(TopicArn=topic_arn)
logger.info(f"Deleted topic: {topic_arn}")
return True
except ClientError as e:
error_code = e.response.get('Error', {}).get('Code', 'Unknown')
if error_code == 'NotFound':
logger.warning(f"Topic not found: {topic_arn}")
return True # Already deleted
else:
logger.error(f"Error deleting topic: {error_code} - {e}")
raise
```
+ Einzelheiten zur API finden Sie [DeleteTopic](https://docs.aws.amazon.com/goto/boto3/sns-2010-03-31/DeleteTopic)in *AWS SDK for Python (Boto3) API* Reference.
------
#### [ SAP ABAP ]
**SDK für SAP ABAP**
Es gibt noch mehr dazu. GitHub Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/sns#code-examples) einrichten und ausführen.
```
TRY.
lo_sns->deletetopic( iv_topicarn = iv_topic_arn ).
MESSAGE 'SNS topic deleted.' TYPE 'I'.
CATCH /aws1/cx_snsnotfoundexception.
MESSAGE 'Topic does not exist.' TYPE 'E'.
ENDTRY.
```
+ Einzelheiten zur API finden Sie [DeleteTopic](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)in der *API-Referenz zum AWS SDK für SAP ABAP*.
------
#### [ Swift ]
**SDK für Swift**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/swift/example_code/sns#code-examples) einrichten und ausführen.
```
import AWSSNS
let config = try await SNSClient.SNSClientConfiguration(region: region)
let snsClient = SNSClient(config: config)
_ = try await snsClient.deleteTopic(
input: DeleteTopicInput(topicArn: arn)
)
```
+ Einzelheiten zur API finden Sie [DeleteTopic](https://sdk.amazonaws.com/swift/api/awssns/latest/documentation/awssns/snsclient/deletetopic(input:))in der *API-Referenz zum AWS SDK für Swift*.
------
# Überwachung der SMS-Aktivitäten von Amazon SNS
Durch die Überwachung der SMS-Aktivitäten behalten Sie Zieltelefonnummern, erfolgreiche oder fehlgeschlagene Zustellungen, Gründe für Ausfälle, Kosten und andere Informationen im Auge. Amazon SNS hilft, indem es Statistiken in der Konsole zusammenfasst, Informationen an Amazon CloudWatch sendet und tägliche SMS-Nutzungsberichte an einen von Ihnen angegebenen Amazon S3 S3-Bucket sendet.
# Amazon SNS SNS-SMS-Versandstatistiken anzeigen
Sie können Statistiken zu Ihren aktuellen SMS-Zustellungen über die Amazon SNS-Konsole anzeigen.
1. Melden Sie sich bei der [Amazon SNS-Konsole](https://console.aws.amazon.com/sns/home) an.
1. Legen Sie im Konsolenmenü unter der Regionsauswahl eine [-Region fest, die SMS-Messaging unterstützt](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-sms-by-country.html).
1. Wählen Sie im Navigationsbereich **Text messaging (SMS) (Textnachrichten (SMS))** aus.
1. Zeigen Sie auf der Seite **Text messaging (SMS)** im Abschnitt **Account stats (Kontostatistik)** die Diagramme zu den Zustellungen Ihrer transaktions- und werbebezogenen SMS-Nachrichten an. Jedes Diagramm zeigt die folgenden Daten für die letzten 15 Tage:
+ Zustellungsrate (Prozentsatz der erfolgreichen Zustellungen)
+ Gesendet (Anzahl der Zustellversuche)
+ Fehlgeschlagen (Anzahl der fehlgeschlagenen Zustellungen)
Auf dieser Seite können Sie auch die Schaltfläche **Usage (Nutzung)** wählen, um zum Amazon S3-Bucket zu wechseln, in dem Ihre täglichen Nutzungsberichte gespeichert sind. Weitere Informationen finden Sie unter [Abonnieren der täglichen SMS-Nutzungsberichte von Amazon SNS](sms_stats_usage.md).
# Amazon SNS SMS-Versandüberwachung mit CloudWatch Amazon-Metriken und Protokollen
Sie können Amazon CloudWatch und Amazon CloudWatch Logs verwenden, um Ihre SMS-Nachrichtenzustellungen zu überwachen.
## CloudWatch Amazon-Metriken anzeigen
Amazon SNS sammelt automatisch Messwerte über Ihre SMS-Nachrichtenzustellungen und leitet sie an Amazon weiter. CloudWatch Sie können diese Messwerte überwachen und Alarme einrichten, CloudWatch um Sie zu benachrichtigen, wenn eine Metrik einen Schwellenwert überschreitet. Sie können beispielsweise CloudWatch Messwerte überwachen, um Ihre SMS-Zustellrate und Ihre month-to-date SMS-Gebühren zu ermitteln.
Informationen zur Überwachung von CloudWatch Messwerten, zur Einstellung von CloudWatch Alarmen und zu den verfügbaren Messwerttypen finden Sie unter[Überwachung von Amazon SNS SNS-Themen mit CloudWatch](sns-monitoring-using-cloudwatch.md).
## CloudWatch Protokolle anzeigen
Sie können Informationen über erfolgreiche und erfolglose SMS-Nachrichtenzustellungen sammeln, indem Sie Amazon SNS aktivieren, in Amazon CloudWatch Logs zu schreiben. Für jede SMS-Nachricht, die Sie senden, schreibt Amazon SNS ein Protokoll, das die Kosten für die Nachricht, den Erfolgs- oder Fehlerstatus, den Grund für das Fehlschlagen (wenn die Nachricht fehlgeschlagen ist), die Leerlaufzeit für die Nachricht und andere Informationen enthält.
**Um CloudWatch Protokolle für Ihre SMS-Nachrichten zu aktivieren und anzuzeigen**
1. Melden Sie sich bei der [Amazon SNS-Konsole](https://console.aws.amazon.com/sns/home) an.
1. Legen Sie im Konsolenmenü unter der Regionsauswahl eine [-Region fest, die SMS-Messaging unterstützt](https://docs.aws.amazon.com/general/latest/gr/end-user-messaging.html).
1. Wählen Sie im Navigationsbereich **Text messaging (SMS) (Textnachrichten (SMS))** aus.
1. Wählen Sie auf der Seite **Mobile text messaging (SMS) (Mobile Texttnachrichten (SMS))** im Abschnitt **Text messaging preferences (Textnachrichteneinstellungen)** die Option **Edit (Bearbeiten)** aus.
1. Erweitern Sie auf der nächsten Seite den Abschnitt **Protokollierung des Zustellungsstatus**.
1. Geben Sie für **Success sample rate** den Prozentsatz der erfolgreichen SMS-Lieferungen an, für die Amazon SNS CloudWatch Protokolle in Logs schreibt. Beispiel:
+ Um nur Protokolle für fehlgeschlagene Zustellungen zu schreiben, setzen Sie diesen Wert auf 0.
+ Um Protokolle für 10 % der erfolgreichen Zustellungen zu schreiben, setzen Sie den Wert auf 10.
Wenn Sie keinen Prozentsatz angeben, schreibt Amazon SNS Protokolle für alle erfolgreichen Zustellungen.
1. Gehen Sie wie folgt vor, um die angeforderten Genehmigungen bereitzustellen:
+ Zum Erstellen einer neuen Servicerolle wählen Sie **Neue Servicerolle erstellen** und dann **Neue Rollen erstellen**. Wählen Sie auf der nächsten Seite **Erlauben**, um Amazon SNS Schreibzugriff auf die Ressourcen Ihres Kontos zu geben.
+ Um eine bestehende Servicerolle zu verwenden, wählen Sie **Vorhandene Servicerolle verwenden** und fügen Sie dann den ARN-Namen im Feld **IAM-Rolle für erfolgreiche und fehlgeschlagene Übermittlungen**.
Die angegebene Servicerolle muss Schreibzugriff auf die Ressourcen Ihres Kontos ermöglichen. Weitere Informationen zum Erstellen von IAM-Rollen finden Sie unter [Erstellen einer Rolle für einen AWS Service](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html#roles-creatingrole-service-console) im *IAM-Benutzerhandbuch*.
1. Wählen Sie **Änderungen speichern ** aus.
1. Zurück auf der Seite **Text-Messaging (SMS)** gehen Sie zum Abschnitt **Zustellungsstatusprotokolle**, um verfügbare Protokolle anzuzeigen.
**Anmerkung**
Je nach Carrier der Zieltelefonnummer kann es bis zu 72 Stunden dauern, bis Zustellungsprotokolle in der Amazon-SNS-Konsole angezeigt werden.
## Beispielprotokoll für eine erfolgreiche SMS-Zustellung
Das Zustellungsstatusprotokoll für eine erfolgreiche SMS-Zustellung ähnelt dem folgenden Beispiel:
```
{
"notification": {
"messageId": "34d9b400-c6dd-5444-820d-fbeb0f1f54cf",
"timestamp": "2016-06-28 00:40:34.558"
},
"delivery": {
"phoneCarrier": "My Phone Carrier",
"mnc": 270,
"numberOfMessageParts": 1,
"destination": "+1XXX5550100",
"priceInUSD": 0.00645,
"smsType": "Transactional",
"mcc": 310,
"providerResponse": "Message has been accepted by phone carrier",
"dwellTimeMs": 599,
"dwellTimeMsUntilDeviceAck": 1344
},
"status": "SUCCESS"
}
```
## Beispielprotokoll für eine fehlgeschlagene SMS-Zustellung
Das Zustellungsstatusprotokoll für eine fehlgeschlagene SMS-Zustellung ähnelt dem folgenden Beispiel:
```
{
"notification": {
"messageId": "1077257a-92f3-5ca3-bc97-6a915b310625",
"timestamp": "2016-06-28 00:40:34.559"
},
"delivery": {
"mnc": 0,
"numberOfMessageParts": 1,
"destination": "+1XXX5550100",
"priceInUSD": 0.00645,
"smsType": "Transactional",
"mcc": 0,
"providerResponse": "Unknown error attempting to reach phone",
"dwellTimeMs": 1420,
"dwellTimeMsUntilDeviceAck": 1692
},
"status": "FAILURE"
}
```
## Gründe für das Fehlschlagen der SMS-Zustellung
Der Grund für das Fehlschlagen wird mit dem `providerResponse`-Attribut angegeben. SMS-Nachrichten können aus den folgenden Gründen fehlschlagen:
+ Telefonnetzbetreiber hat die Nachricht als Spam blockiert
+ Ziel befindet sich auf einer blockierten Liste
+ Telefonnummer ist ungültig
+ Nachrichtentext ist ungültig
+ Telefonnentzbetreiber hat die Nachricht blockiert
+ Telefonnetzbetreiber ist derzeit nicht erreichbar/nicht verfügbar
+ Telefon blockiert SMS
+ Telefon befindet sich auf einer blockierten Liste
+ Telefon ist derzeit nicht erreichbar/nicht verfügbar
+ Telefonnummer lehnt Empfang ab
+ Zustellung würde den Maximalpreis überschreiten
+ Unbekannter Fehler versucht das Telefon zu erreichen
# Abonnieren der täglichen SMS-Nutzungsberichte von Amazon SNS
Sie können Ihre SMS-Zustellungen überwachen, indem Sie tägliche Nutzungsberichte von Amazon SNS abonnieren. Für jeden Tag, an dem Sie mindestens eine SMS-Nachricht senden, sendet Amazon SNS einen Nutzungsbericht als CSV-Datei an den angegebenen Amazon S3-Bucket. Es dauert 24 Stunden, bis der SMS-Nutzungsbericht im Amazon S3 S3-Bucket verfügbar ist.
## Informationen im täglichen Nutzungsbericht
Der Nutzungsbericht umfasst die folgenden Informationen für jede SMS-Nachricht, die Sie von Ihrem Konto senden.
Beachten Sie, dass der Bericht keine Nachrichten enthält, die an Empfänger gesendet werden, die sich vom Nachrichtenempfang abgemeldet haben.
+ Zeitpunkt der Veröffentlichung für die Nachricht (in UTC)
+ Nachrichten-ID
+ Zieltelefonnummer
+ Nachrichtentyp
+ Zustellungsstatus
+ Kosten für die Nachricht (in US-Dollar)
+ Segmentnummer (eine Nachricht wird in mehrere Segmente aufgeteilt, wenn sie für eine einzelne Nachricht zu lang ist)
+ Gesamtanzahl der Segmente
**Anmerkung**
Wenn Amazon SNS die Segmentnummer nicht erhalten hat, setzen wir deren Wert auf Null.
## Abonnieren der täglichen Nutzungsberichte
Um tägliche Nutzungsberichte zu abonnieren, müssen Sie einen Amazon S3-Bucket mit den entsprechenden Berechtigungen erstellen.
**So erstellen Sie einen Amazon-S3-Bucket für Ihre täglichen Nutzungsberichte**
1. Melden Sie sich über den AWS-Konto , der SMS-Nachrichten sendet, [bei der Amazon S3-Konsole](https://console.aws.amazon.com/s3/) an.
1. Wählen Sie **Create Bucket (Bucket erstellen)** aus.
1. Unter **Bucket Name (Bucket-Name)** empfiehlt es sich, einen für Ihr Konto und Ihre Organisation eindeutigen Namen einzugeben. Verwenden Sie zum Beispiel das Muster `--`.
Weitere Informationen über Konventionen und Einschränkungen für Bucket-Namen finden Sie unter [Regeln für die Bucket-Benennung](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html#bucketnamingrules) im *Benutzerhandbuch zu Amazon Simple Storage Service*.
1. Wählen Sie **Erstellen** aus.
1. Wählen Sie in der Tabelle **Alle Buckets** den Bucket aus.
1. Wählen Sie in der Registerkarte **Genehmigungen** **Bucket-Richtlinie**.
1. Geben Sie im Fenster **Bucket Policy Editor (Bucket-Richtlinieneditor)** eine Richtlinie ein, die den Amazon SNS-Serviceprinzipal berechtigt, in Ihren Bucket zu schreiben. Ein Beispiel finden Sie unter [Beispiel einer Bucket-Richtlinie](#example_bucket_policy).
Wenn Sie die Beispielrichtlinie verwenden, denken Sie daran, sie durch den Bucket-Namen zu *my-s3-bucket* ersetzen, den Sie in Schritt 3 ausgewählt haben.
1. Wählen Sie **Speichern**.
**So abonnieren Sie tägliche Nutzungsberichte**
1. Melden Sie sich bei der [Amazon SNS-Konsole](https://console.aws.amazon.com/sns/) an.
1. Wählen Sie im Navigationsbereich **Text messaging (SMS) (Textnachrichten (SMS))** aus.
1. Wählen Sie auf der Seite **Text messaging (SMS) (Textnachrichten (SMS))** im Abschnitt **Text messaging preferences (Textnachrichteneinstellungen)** die Option **Edit (Bearbeiten)** aus.
![\[Bereich „Einstellungen für Textnachrichten“ in der Amazon SNS SNS-Konsole\]](http://docs.aws.amazon.com/de_de/sns/latest/dg/images/daily-usage-report1.png)
1. Geben Sie auf der Seite **Edit text messaging preferences (Textnachrichteneinstellungen bearbeiten)** im Abschnitt **Details** **Amazon S3 bucket name for usage reports (Amazon S3-Bucket-Name für Nutzungsberichte)** an.
![\[Abschnitt „Details“ auf der Seite „Einstellungen für Textnachrichten bearbeiten“ in der Amazon SNS SNS-Konsole\]](http://docs.aws.amazon.com/de_de/sns/latest/dg/images/daily-usage-report2.png)
1. Wählen Sie **Änderungen speichern ** aus.
### Beispiel einer Bucket-Richtlinie
Die folgende Richtlinie berechtigt den Amazon SNS-Service, die Aktionen `s3:PutObject`, `s3:GetBucketLocation` und `s3:ListBucket` durchzuführen.
AWS bietet Tools für alle Dienste mit Service Principals, denen Zugriff auf Ressourcen in Ihrem Konto gewährt wurde. Wenn der Principal in einer Amazon S3 S3-Bucket-Richtlinienerklärung ein [verwirrtes stellvertretendes Problem](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html) ist. Um zu begrenzen, welche Region und welches Konto der Bucket tägliche Nutzungsberichte erhalten kann, verwenden Sie `aws:SourceArn`, wie im folgenden Beispiel gezeigt. Wenn Sie die Regionen, die diese Berichte genieren können, nicht einschränken wollen, können Sie mit `aws:SourceAccount` einschränken, welche Konten die Berichte generieren. Wenn Sie den ARN der Ressource nicht kennen, verwenden Sie `aws:SourceAccount`.
Verwenden Sie das folgende Beispiel, das einen Schutz vor dem Problem des verwirrten Stellvertreters enthält, um eine Amazon-S3-Bucket für den Empfang von täglichen SMS-Nutzungsberichten von Amazon SNS zu erstellen.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowPutObject",
"Effect": "Allow",
"Principal": {
"Service": "sns.amazonaws.com"
},
"Action": "s3:PutObject",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "account_id"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sns:us-west-1:123456789012:*"
}
}
},
{
"Sid": "AllowGetBucketLocation",
"Effect": "Allow",
"Principal": {
"Service": "sns.amazonaws.com"
},
"Action": "s3:GetBucketLocation",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "account_id"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sns:us-west-1:123456789012:*"
}
}
},
{
"Sid": "AllowListBucket",
"Effect": "Allow",
"Principal": {
"Service": "sns.amazonaws.com"
},
"Action": "s3:ListBucket",
"Resource": "arn:aws:s3:::amzn-s3-demo-bucket",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "account_id"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sns:us-west-1:123456789012:*"
}
}
}
]
}
```
------
**Anmerkung**
Sie können Nutzungsberichte in Amazon-S3-Buckets veröffentlichen, die sich im Besitz von AWS-Konto befinden, die in der Amazon S3-Richtlinie im `Condition`-Element festgelegt sind. Informationen zum Veröffentlichen von Nutzungsberichten in einem Amazon S3 S3-Bucket, der einem anderen AWS-Konto gehört, finden Sie unter [Wie kann ich Amazon S3 S3-Objekte von einem anderen kopieren AWS-Konto?](https://aws.amazon.com/premiumsupport/knowledge-center/copy-s3-objects-account/) .
### Beispiel eines täglichen Nutzungsberichts
Nachdem Sie die täglichen Nutzungsberichte abonniert haben, speichert Amazon SNS jeden Tag eine CSV-Datei mit Nutzungsdaten am folgenden Speicherort:
```
/SMSUsageReports//YYYY/MM/DD/00x.csv.gz
```
Jede Datei kann bis zu 50.000 Datensätze enthalten. Wenn die Berichte für einen Tag dieses Kontingent übersteigen, fügt Amazon SNS mehrere Dateien hinzu. Nachstehend finden Sie einen Beispielbericht:
```
PublishTimeUTC,MessageId,DestinationPhoneNumber,MessageType,DeliveryStatus,PriceInUSD,PartNumber,TotalParts
2016-05-10T03:00:29.476Z,96a298ac-1458-4825-a7eb-7330e0720b72,1XXX5550100,Promotional,Message has been accepted by phone carrier,0.90084,0,1
2016-05-10T03:00:29.561Z,1e29d394-d7f4-4dc9-996e-26412032c344,1XXX5550100,Promotional,Message has been accepted by phone carrier,0.34322,0,1
2016-05-10T03:00:30.769Z,98ba941c-afc7-4c51-ba2c-56c6570a6c08,1XXX5550100,Transactional,Message has been accepted by phone carrier,0.27815,0,1
```
# Unterstützung für Amazon SNS SMS-Messaging anfordern
**Wichtig**
Der Amazon SNS SMS Developer Guide wurde aktualisiert. Amazon SNS hat sich [AWS End User Messaging SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html)für die Zustellung von SMS-Nachrichten integriert. Dieses Handbuch enthält die neuesten Informationen zur Erstellung, Konfiguration und Verwaltung Ihrer Amazon SNS SNS-SMS-Nachrichten.
Bestimmte SMS-Optionen mit Amazon SNS sind für Ihr AWS Konto erst verfügbar, wenn Sie Kontakt aufnehmen Support. Erstellen Sie einen Fall im [AWS Support Center](https://console.aws.amazon.com/support/home#/), um eine der folgenden Optionen anzufordern:
+ Eine Erhöhung Ihres monatlichen Ausgabenschwellenwerts für SMS
Standardmäßig liegt der monatliche Ausgabenschwellenwert bei 1,00 USD. Ihr Ausgabenschwellenwert bestimmt die Anzahl der Nachrichten, die Sie mit Amazon SNS senden können. Sie können einen Ausgabenschwellenwert anfordern, der der erwarteten monatlichen Menge an Nachrichten für Ihren SMS-Anwendungsfall entspricht.
+ Eine Verschiebung aus der [SMS-Sandbox](sns-sms-sandbox.md), damit Sie SMS-Nachrichten ohne Einschränkungen versenden können. Weitere Informationen finden Sie unter [Verlassen der Amazon SNS SMS-Sandbox](sns-sms-sandbox-moving-to-production.md).
+ Eine engagierte [Ursprungsnummer](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers.html)
+ Eine spezielle [Absender-ID.](https://docs.aws.amazon.com/sms-voice/latest/userguide/sender-id.html) Eine Sender-ID ist eine benutzerdefinierte ID, die auf dem Gerät des Empfängers als Sender angezeigt wird. Sie können z. B. Ihre Unternehmensmarke verwenden, um die Nachrichtenquelle leichter erkennbar zu machen. Die Support für den Absender IDs ist je nach Land oder Region unterschiedlich. Weitere Informationen finden Sie AWS End User Messaging SMS im *AWS End User Messaging SMS Benutzerhandbuch* unter [Unterstützte Länder und Regionen für SMS-Nachrichten mit](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-sms-by-country.html).
# Erhöhung Ihres monatlichen Amazon SNS SMS-Ausgabenkontingents beantragen
Amazon SNS stellt Ausgabenkontingente zur Verfügung, mit denen Sie die maximalen Kosten pro Monat verwalten können, die durch das Senden von SMS über Ihr Konto entstehen. Das Ausgabenkontingent begrenzt Ihr Risiko im Falle eines böswilligen Angriffs und verhindert, dass Ihre Upstream-Anwendung mehr Nachrichten sendet als erwartet. Sie können Amazon SNS so konfigurieren, dass die Veröffentlichung von SMS-Nachrichten eingestellt wird, wenn festgestellt wird, dass beim Senden einer SMS-Nachricht Kosten anfallen, die Ihr Ausgabenkontingent für den aktuellen Monat übersteigen.
Um sicherzustellen, dass Ihr Betrieb nicht beeinträchtigt wird, empfehlen wir, eine Ausgabenquote anzufordern, die hoch genug ist, um Ihre Produktions-Workloads zu unterstützen. Weitere Informationen finden Sie unter [Schritt 1: Öffnen eines Amazon-SNS-SMS-Falls](#channels-sms-awssupport-spend-threshold-open). Sobald Sie das Kontingent erhalten haben, können Sie Ihr Risiko verwalten, indem Sie das volle Kontingent oder einen kleineren Wert anwenden, wie unter [Schritt 2: Aktualisieren Ihrer SMS-Einstellungen](#channels-sms-awssupport-spend-threshold-settings) beschrieben. Wenn Sie einen kleineren Wert anwenden, können Sie Ihre monatlichen Ausgaben mit der Option steuern, bei Bedarf hochzuskalieren.
**Wichtig**
Da Amazon SNS ein verteiltes System ist, beendet es das Senden von SMS-Nachrichten innerhalb von einigen Minuten, falls das Ausgabenkontingent überschritten wurde. Wenn Sie in diesem Zeitraum weiter SMS-Nachrichten senden, können Kosten entstehen, die Ihr Kontingent überschreiten.
Wir setzen das Ausgabenkontingent für alle neuen Konten auf 1,00 USD pro Monat fest. Dieses Kontingent soll Ihnen erlauben, die Möglichkeiten des Nachrichtenversands von Amazon SNS zu testen. Um eine Erhöhung des SMS-Ausgabenkontingents für Ihr Konto zu beantragen, öffnen Sie im AWS Support Center einen Fall zur Erhöhung des Kontingents.
**Topics**
+ [Schritt 1: Öffnen eines Amazon SNS SMS-Falls](#channels-sms-awssupport-spend-threshold-open)
+ [Schritt 2: Aktualisieren Ihrer SMS-Einstellungen in der Amazon SNS-Konsole](#channels-sms-awssupport-spend-threshold-settings)
## Schritt 1: Öffnen eines Amazon SNS SMS-Falls
Sie können eine Erhöhung Ihres monatlichen Ausgabenkontingents beantragen, indem Sie im AWS Support Center einen Fall zur Erhöhung des Kontingents eröffnen.
**Anmerkung**
Einige der Felder im Antragsformular sind als „optional“ markiert. Allerdings benötigt Support alle Informationen, die in den folgenden Schritten aufgeführt sind, um Ihre Anfrage zu bearbeiten. Wenn Sie nicht alle erforderlichen Informationen bereitstellen, kann es bei der Bearbeitung Ihrer Anfrage zu Verzögerungen kommen.
1. Melden Sie sich unter [https://console.aws.amazon.com/ AWS-Managementkonsole](https://console.aws.amazon.com/)an.
1. Klicken Sie im Menü **Support** (Support) auf **Support Center** (Support-Center).
1. Wählen Sie auf der Registerkarte **Offene Support-Fälle** die Option **Fall erstellen** aus.
1. Wählen Sie den Link **Erhöhung des Servicelimits?** und gehen Sie dann wie folgt vor:
+ Wählen Sie für **Grenzwerttyp** die Option **SNSSMS** aus.
+ (Optional) Geben Sie unter **Link zur Website oder App angeben, die die SMS-Nachrichten senden wird** Informationen über die Website, die Anwendung oder den Service an, die bzw. der SMS-Nachrichten senden wird.
+ (Optional) Wählen Sie für **Art der Nachrichten, die gesendet werden sollen** die Art der Nachrichten aus, die Sie mit Ihren Langwahlnummern senden möchten:
+ **One-time Password (Einmaliges Passwort)** – Nachrichten, die für Ihre Kunden Passwörter zur Authentifizierung bei Ihrer Website oder Anwendung bereitstellen.
+ **Promotional (Werbung)** – Nicht kritische Nachrichten, die Ihr Unternehmen oder Ihren Service bewerben, wie beispielsweise Sonderangebote oder Ankündigungen.
+ **Transactional (Transaktionsnachrichten)** – Wichtige Informationsmeldung, die Kundentransaktionen unterstützen, wie beispielsweise Bestellbestätigungen oder Kontowarnungen. Transaktionsnachrichten dürfen keine Werbeaktionen oder Marketinginhalte enthalten.
+ (Optional) Wählen Sie für **welche AWS Region Sie Nachrichten senden möchten, die Region aus**, aus der Sie Nachrichten senden möchten.
+ (Optional) Geben Sie für **In welche Länder möchten Sie Nachrichten senden** das Land oder die Region ein, in dem bzw. der Sie Kurzwahlnummern erwerben möchten.
+ (Optional) Geben Sie unter **Wie entscheiden sich Ihre Kunden dafür, Nachrichten von Ihnen zu erhalten** Einzelheiten zu Ihrem Anmeldeverfahren an.
+ (Optional) Geben Sie im Feld **Bitte geben Sie die Nachrichtenvorlage an, die Sie verwenden möchten, um Nachrichten an Ihre Kunden zu senden** die Vorlage ein, die Sie verwenden werden.
1. Führen Sie unter **Requests** (Anforderungen) die folgenden Abschnitte aus:
+ Wählen Sie für die **Region** die Region aus, aus der Sie Nachrichten senden möchten.
**Anmerkung**
Die Region ist im Abschnitt **Anforderungen** erforderlich. Auch wenn Sie diese Informationen im Abschnitt **Falldetails** angegeben haben, müssen Sie sie auch hier angeben.
+ Wählen Sie für **Resource Type (Ressourcentyp)** die Option **General Limits (Allgemeine Limits)** aus.
+ Wählen Sie für **Limit** **Account Spend Threshold Increase (Erhöhung des Ausgabenschwellenwerts)** aus.
1. Geben Sie für den Neuen Grenzwert den Höchstbetrag in USD ein, den Sie pro Kalendermonat für SMS-Nachrichten ausgeben möchten.
1. Machen Sie unter **Case description (Fallbeschreibung)** für **Use case description (Anwendungsfall-Beschreibung)** die folgenden Angaben:
+ Die Website oder App des Unternehmens oder Services, das/der SMS-Nachrichten sendet.
+ Den Service, der von Ihrer Website oder App bereitgestellt wird, und wie Ihre SMS-Nachrichten zu diesem Service beitragen.
+ Wie sich Benutzer bei Ihrer Website, App oder an einem anderen Ort anmelden, um Ihre SMS-Nachrichten freiwillig zu erhalten.
Wenn Ihr angefordertes Ausgabenkontingent (der Wert, den Sie unter **New quota value (Neuer Kontingentwert)** angegeben haben), 10.000 USD überschreitet, geben Sie für jedes Zielland Ihrer Nachrichten die folgenden zusätzlichen Einzelheiten an:
+ Ob Sie eine Sender-ID oder eine Kurzwahlnummer verwenden. Wenn Sie eine Sender-ID verwenden, geben Sie an:
+ Die Sender-ID.
+ Ob die Sender-ID bei Mobilnetzanbietern in dem betreffenden Land registriert ist.
+ Das erwartete Maximum transactions-per-second (TPS) für Ihre Nachrichten.
+ Die durchschnittliche Nachrichtengröße.
+ Die Vorlage für die in das betreffende Land gesendeten Nachrichten.
+ (Optional) Eventuelle Zeichenverschlüsselungsanforderungen.
1. (Optional) Wenn Sie weitere Anforderungen einreichen möchten, wählen Sie **Weitere Anforderung hinzufügen**. Wenn Sie mehrere Anfragen durchführen, geben Sie für jede davon die erforderlichen Informationen an. Die erforderlichen Informationen finden Sie in den anderen Abschnitten von [Unterstützung für Amazon SNS SMS-Messaging anfordern](channels-sms-awssupport.md).
1. Wählen Sie unter **Kontaktoptionen** für **Bevorzugte Kontaktsprache** die Sprache aus, in der Sie Mitteilungen zu diesem Fall erhalten möchten.
1. Wenn Sie fertig sind, klicken Sie auf **Submit** (Absenden).
Das Support Team gibt innerhalb von 24 Stunden eine erste Antwort auf Ihre Anfrage.
Da wir verhindern möchten, dass unerwünschte oder schädliche Inhalte in unseren Systemen eingehen, müssen wir jede Anfrage sorgfältig prüfen. Nach einer Prüfung kommen wir Ihrer Anfrage innerhalb dieses 24-Stunden-Zeitraums nach. Für den Fall, dass wir weitere Informationen von Ihnen benötigen, kann die Bearbeitung Ihrer Anfrage länger dauern.
Wenn Ihr Anwendungsfall gegen unsere Richtlinien verstößt, können wir Ihrer Anfrage möglicherweise nicht nachkommen.
## Schritt 2: Aktualisieren Ihrer SMS-Einstellungen in der Amazon SNS-Konsole
Nachdem wir Sie darüber informiert haben, dass Ihr monatliches Ausgabenkontingent erhöht wurde, müssen Sie das Ausgabenkontingent für Ihr Konto in der Amazon SNS-Konsole anpassen.
**Wichtig**
Sie müssen die folgenden Schritte ausführen, sonst wird Ihr SMS-Ausgabenlimit nicht erhöht.
**So passen Sie Ihr Ausgabenkontingent in der Konsole an**
1. Melden Sie sich bei der [Amazon-SNS-Konsole](https://console.aws.amazon.com/sns/home) an.
1. Öffnen Sie das linke Navigationsmenü, erweitern Sie **Mobil** und wählen Sie dann **SMS**.
1. Wählen Sie auf der Seite **Mobile text messaging (SMS) (Mobile Texttnachrichten (SMS))** im Abschnitt **Text messaging preferences (Textnachrichteneinstellungen)** die Option **Edit (Bearbeiten)** aus.
1. Geben Sie auf der Seite **SMS-Voreinstellungen bearbeiten** unter **Details** Ihr neues SMS-Ausgabenlimit unter **Kontoausgabenlimit** ein.
**Anmerkung**
Möglicherweise erhalten Sie eine Warnung, dass der eingegebene Wert größer als das Standardausgabenlimit ist. Sie können dies ignorieren.
1. Wählen Sie **Änderungen speichern ** aus.
**Anmerkung**
Wenn der Fehler „Invalid Parameter (Ungültiger Parameter)” angezeigt wird, überprüfen Sie den Kontakt beim AWS Support, und prüfen Sie, ob Sie das richtige neue SMS-Ausgabenlimit eingegeben haben. Wenn Sie immer noch ein Problem haben, öffnen Sie einen Fall im AWS Support Center.
Wenn Sie Ihren Fall im Support Center erstellen, achten Sie darauf, dass Sie alle erforderlichen Informationen für die Art der Anfrage angeben, die Sie einreichen. Andernfalls Support müssen Sie sich mit Ihnen in Verbindung setzen, um diese Informationen zu erhalten, bevor Sie fortfahren. Indem Sie einen detaillierten Fall übermitteln, tragen Sie dazu bei, dass Ihr Fall ohne Verzögerungen gelöst werden kann. Informationen zu den Details, die für bestimmte Arten von SMS-Anfragen benötigt werden, finden Sie in den folgenden Themen.
Weitere Informationen zum Absender IDs finden Sie in der folgenden Dokumentation im *AWS End User Messaging SMS Benutzerhandbuch*:
| AWS End User Messaging SMS Thema | Beschreibung |
| --- | --- |
| [Eine Erhöhung der Ausgabenquote beantragen](https://docs.aws.amazon.com/sms-voice/latest/userguide/awssupport-spend-threshold.html) | Ihr Ausgabenkontingent bestimmt, wie viel Geld Sie AWS End User Messaging SMS jeden Monat für den Versand von SMS-Nachrichten ausgeben können. |
| [Eröffnen Sie im Support Center einen Fall für eine Absender-ID](https://docs.aws.amazon.com/sms-voice/latest/userguide/awssupport-sender-id.html) | Wenn Sie beabsichtigen, Nachrichten an Empfänger in einem Land zu senden, in dem Absender erforderlich IDs sind, können Sie eine Absender-ID anfordern, indem Sie im Support Center einen neuen Fall erstellen. |
# Bewährte Methoden für Amazon SNS SMS-Messaging
**Wichtig**
Der Amazon SNS SMS Developer Guide wurde aktualisiert. Amazon SNS hat sich [AWS End User Messaging SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/what-is-service.html)für die Zustellung von SMS-Nachrichten integriert. Dieses Handbuch enthält die neuesten Informationen zur Erstellung, Konfiguration und Verwaltung Ihrer Amazon SNS SNS-SMS-Nachrichten.
Mobiltelefonbenutzer neigen zu einer sehr geringen Toleranz für unerwünschte SMS-Nachrichten. Die Antwortraten für unaufgeforderte SMS-Kampagnen sind fast immer sehr niedrig, was gleichzeitig auch eine schlechte Investitionsrendite bedeutet.
Außerdem überwachen Mobilfunkanbieter Massen-SMS-Sender kontinuierlich. Nummern, die offenbar unerwünschte Nachrichten senden, werden gedrosselt oder gesperrt.
Das Senden von unerwünschten Inhalten stellt auch einen Verstoß gegen die [AWS Acceptable Use Policy](https://aws.amazon.com/aup/#No_E-Mail_or_Other_Message_Abuse) dar. Das Amazon SNS-Team überprüft SMS-Kampagnen regelmäßig und kann Ihre Möglichkeiten zum Senden von Nachrichten drosseln oder sperren, wenn Sie offensichtlich unerwünschte Nachrichten senden.
Schließlich gelten in vielen Ländern, Regionen und Rechtsbereichen empfindliche Strafen für das Senden unerwünschter SMS-Nachrichten. So bestimmt beispielsweise in den USA der Telephone Consumer Protection Act (TCPA), dass Verbraucher einen Anspruch auf eine (vom Sender zu leistende) Zahlung von 500 bis 1.500 USD für jede unerwünschte Nachricht haben, die sie erhalten.
Dieser Abschnitt beschreibt verschiedene bewährte Methoden, die Ihnen dabei helfen können, die Einbeziehung Ihrer Kunden zu verbessern und hohe Strafzahlungen zu vermeiden. Beachten Sie jedoch, dass diesem Abschnitt keine Rechtsberatung darstellt. Wenden Sie sich immer an einen Rechtsanwalt, um juristischen Rat einzuholen.
## Einhaltung von Gesetzen, Vorschriften und Anforderungen der Anbieter
Für Verstöße gegen die Gesetze und Bestimmungen der Länder, in denen sich Ihre Kunden befinden, drohen erhebliche Geldbußen und Strafen. Daher müssen Sie die Gesetze kennen, die SMS-Messaging in den Ländern und Regionen regeln, in denen Sie geschäftlich tätig sind.
Die folgende Liste enthält Links auf die wichtigsten Gesetze zu SMS-Kommunikation in den größten Märkten der Welt.
+ **USA**: Der Telephone Consumer Protection Act (TCPA) von 1991 gilt für bestimmte Arten von SMS-Nachrichten. Weitere Informationen finden Sie unter [Rules and Regulations (Regeln und Vorschriften)](https://www.fcc.gov/document/telephone-consumer-protection-act-1991) auf der Website der Federal Communication Commission.
+ **Großbritannien und Nordirland**: Die Privacy and Electronic Communications (EG-Richtlinie) (PECR) von 2003 gilt für bestimmte Arten von SMS-Nachrichten. Weitere Informationen finden Sie unter [What are PECR? (Was sind PECR?)](https://ico.org.uk/for-organisations/direct-marketing-and-privacy-and-electronic-communications/guide-to-pecr/what-are-pecr/) auf der Website des UK Information Commissioner's Office.
+ **Europäische Union**: Die Datenschutzrichtlinie für elektronische Kommunikation von 2002 (auch ePrivacy-Richtlinie) gilt für einige Typen von SMS-Nachrichten. Weitere Informationen finden Sie im [vollständigen Gesetzestext](http://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32002L0058) auf der Website Europa.eu.
+ **Kanada**: Der Fighting Internet and Wireless Spam Act, auch als kanadisches Antispamgesetz (CASL) bekannt, gilt für bestimmte Arten von SMS-Nachrichten. Weitere Informationen finden Sie im [vollständigen Gesetzestext](http://www.parl.ca/DocumentViewer/en/40-3/bill/C-28/first-reading) auf der Website des kanadischen Parlaments.
+ **Japan**: Das Gesetz zur Regulierung der Übermittlung von bestimmten elektronischen Mails kann für bestimmte Arten von SMS-Nachrichten gelten. Weitere Informationen finden Sie unter [Japan's Countermeasures Against Spam](https://www.japaneselawtranslation.go.jp/en/laws/view/3767/en) auf der Website des japanischen Ministeriums für innere Angelegenheiten und Kommunikation.
Diese Gesetze können für Sie als Absender auch dann gelten, wenn Ihr Unternehmen oder Ihre Organisation nicht in einem dieser Länder ansässig ist. Einige der Gesetze in dieser Liste wurden ursprünglich für unerwünschte E-Mails oder Anrufe erlassen, wurden seither jedoch auch auf SMS-Nachrichten erweitert. In anderen Ländern und Regionen können andere Gesetze für die Übermittlung von SMS-Nachrichten gelten. Fragen Sie einen Anwalt in einem Land oder einer Region, in der sich Ihre Kunden befinden, um sich entsprechend beraten zu lassen.
In vielen Ländern haben die lokalen Netzbetreiber letztendlich die Befugnis, zu bestimmen, welche Art von Datenverkehr ihre Netze passiert. Dies bedeutet, dass die Netzbetreiber möglicherweise Beschränkungen für SMS-Inhalte auferlegen, die über die Mindestanforderungen der örtlichen Gesetzgebung hinausgehen.
## Einholen von Berechtigungen
Senden Sie niemals Nachrichten an Empfänger, die nicht ausdrücklich darum gebeten haben, die Arten von Nachrichten zu erhalten, die Sie senden möchten. Teilen Sie keine Opt-in-Listen, auch nicht in Organisationen innerhalb desselben Unternehmens.
Wenn Empfänger über ein Onlineformular angeben können, dass sie Ihre Nachrichten erhalten möchten, fügen Sie dem Formular Systeme hinzu, die verhindern, dass automatisierte Scripts ohne Wissen der Benutzer Abonnements für sie abschließen. Sie sollten auch die Häufigkeit begrenzen, mit der ein Benutzer in einer einzelnen Sitzung eine Telefonnummer angeben kann.
Wenn Sie eine SMS-Opt-in-Anfrage erhalten, senden Sie dem Empfänger eine Nachricht mit der Bitte, zu bestätigen, dass er Nachrichten von Ihnen erhalten möchte. Senden Sie diesem Empfänger keine weiteren Nachrichten, bis er sein Abonnement bestätigt hat. Eine Bestätigungsnachricht für ein Abonnement kann wie folgt aussehen:
`Text YES to join ExampleCorp alerts. 2 msgs/month. Msg & data rates may apply. Reply HELP for help, STOP to cancel.`
Führen Sie Unterlagen mit Datum, Uhrzeit und Quelle der einzelnen Opt-in-Anfragen und Bestätigungen. Dies kann hilfreich sein, wenn ein Anbieter oder eine Regulierungsbehörde danach fragt, oder auch für Routineprüfungen Ihrer Kundenliste.
### Opt-in-Workflow
In einigen Fällen (wie bei der gebührenfreien Registrierung in den USA oder der Kurzwahl-Registrierung) verlangen Mobilfunkanbieter, dass Sie Mockups oder Screenshots Ihres gesamten Opt-in-Workflows zur Verfügung stellen. Die Mockups oder Screenshots müssen dem Opt-in-Workflow, den Ihre Empfänger ausführen werden, sehr ähnlich sein.
Ihre Mockups oder Screenshots sollten alle unten aufgeführten erforderlichen Angaben enthalten, um ein Höchstmaß an Compliance zu gewährleisten.
**Erforderliche Angaben**
+ Eine Beschreibung des Messaging-Anwendungsfalls, den Sie über Ihr Programm senden.
+ Der Satz „Es können Gebühren für Nachrichten und Daten anfallen“.
+ Ein Hinweis darauf, wie oft Empfänger Nachrichten von Ihnen erhalten. Beispielsweise könnte die Angabe für ein wiederkehrendes Messaging-Programm „eine Nachricht pro Woche“ lauten. Ein Anwendungsfall für ein Einmalpasswort oder eine Multi-Faktor-Authentifizierung könnte lauten: „Nachrichtenfrequenz variiert“ oder „eine Nachricht pro Anmeldeversuch“.
+ Links zu Ihren Allgemeinen Geschäftsbedingungen und Datenschutzrichtlinien.
**Häufige Ablehnungsgründe für nicht konforme Opt-ins**
+ Wenn der angegebene Firmenname nicht mit dem übereinstimmt, was im Mockup oder Screenshot angegeben ist. Alle nicht offensichtlichen Zusammenhänge sollten in der Beschreibung des Opt-in-Workflows erklärt werden.
+ Wenn es den Anschein hat, dass eine Nachricht an den Empfänger gesendet wird, zuvor jedoch keine ausdrückliche Zustimmung eingeholt wurde. Die ausdrückliche Zustimmung ist eine Voraussetzung für alle Nachrichten.
+ Wenn es den Anschein hat, dass der Empfang einer Textnachricht erforderlich ist, um sich für einen Service anzumelden. Dies ist nicht konform, wenn der Workflow keine Alternative zum Empfang einer Opt-in-Nachricht in anderer Form wie E-Mail oder Sprachanruf bietet.
+ Wenn die Opt-in-Formulierungen vollständig in den Nutzungsbedingungen angegeben ist. Die Angaben sollten dem Empfänger immer zum Opt-in-Zeitpunkt vorgelegt werden und nicht in einem verknüpften Richtliniendokument enthalten sein.
+ Wenn ein Kunde zugestimmt hat, eine bestimmte Art von Nachricht von Ihnen zu erhalten, und Sie ihm andere Arten von Textnachrichten senden. Der Kunde stimmt beispielsweise zu, Einmalpasswörter zu erhalten, erhält aber auch Umfragenachrichten.
+ Wenn die erforderlichen Angaben (siehe oben) den Empfängern nicht vorgelegt werden.
Das folgende Beispiel erfüllt die Anforderungen der Mobilfunkanbieter für einen Anwendungsfall mit Multi-Faktor-Authentifizierung.
![\[Ein step-by-step Modell des Opt-In-Workflows zur Aktivierung der Multi-Faktor-Authentifizierung (MFA) für ein Benutzerkonto mit. ExampleCorp Der Vorgang beginnt damit, dass der Benutzer grundlegende Kontoinformationen wie Name und E-Mail-Adresse angibt. Als Nächstes entscheidet der Benutzer, ob MFA für zusätzliche Sicherheit aktiviert werden soll. Wenn MFA aktiviert ist, wählt der Benutzer aus, wie er das MFA-Token erhalten möchte, mit Optionen wie Textnachricht oder Telefonanruf. Wenn der Benutzer Textnachricht auswählt, erhält er eine SMS mit einem Bestätigungscode. Im letzten Schritt muss der Benutzer den erhaltenen Code eingeben, um seine Telefonnummer zu bestätigen und den Anmeldevorgang abzuschließen. Dieses Modell stellt sicher, dass alle zur Einhaltung der SMS-Vorschriften erforderlichen Angaben gemacht werden.\]](http://docs.aws.amazon.com/de_de/sns/latest/dg/images/best-practices-usecase.png)
Es enthält finalisierten Text und Bilder und zeigt den gesamten Opt-in-Workflow mit Anmerkungen. Im Opt-in-Workflow muss der Kunde eindeutige, absichtliche Maßnahmen ergreifen, um seine Zustimmung zum Erhalt von Textnachrichten zu erteilen. Der Workflow enthält außerdem alle erforderlichen Angaben.
### Andere Opt-in-Workflowtypen
Mobilfunkanbieter akzeptieren auch Opt-in-Workflows außerhalb von Anwendungen und Websites wie mündliches oder schriftliches Opt-in, wenn dies den oben genannten Anforderungen entspricht. Ein konformer Opt-in-Workflow und ein mündliches oder schriftliches Skript holen die ausdrückliche Zustimmung des Empfängers ein, einen bestimmten Nachrichtentyp zu erhalten. Beispiele hierfür sind das mündliche Skript, das ein Kundendienstmitarbeiter verwendet, um die Zustimmung einzuholen, bevor er die Daten in eine Servicedatenbank aufnimmt, oder eine Telefonnummer, die auf einem Werbeflyer aufgeführt ist. Um ein Modell dieser Arten von Opt-in-Workflows zu erstellen, können Sie einen Screenshot Ihres Anmeldeskripts, Marketingmaterials oder Ihrer Datenbank, in der Zahlen gesammelt werden, bereitstellen. Mobilfunkanbieter haben möglicherweise zusätzliche Fragen zu diesen Anwendungsfällen, wenn ein Opt-in nicht klar ist oder der Anwendungsfall bestimmte Volumina überschreitet.
## Nicht an alte Listen senden
Empfänger ändern ihre Telefonnummer häufig. Eine Telefonnummer, für die Sie vor zwei Jahren eine Zustimmung zur Kontaktaufnahme eingeholt haben, könnte heute jemand anderem gehören. Verwenden Sie keine alte Liste von Telefonnummern für ein neues Messaging-Programm. Andernfalls werden wahrscheinlich einige Nachrichten ihren Empfänger nicht erreichen, weil die Nummer nicht mehr vergeben ist, und einige Personen werden sich abmelden, weil sie sich nicht erinnern können, Ihnen ihre Zustimmung gegeben zu haben.
## Prüfung Ihrer Kundenlisten
Wenn Sie wiederkehrende SMS-Kampagnen versenden, sollten Sie Ihre Kundenlisten regelmäßig überprüfen. Dadurch stellen Sie sicher, dass nur Kunden, die an Ihren Nachrichten interessiert sind, diese auch erhalten.
Senden Sie bei der Prüfung Ihrer Liste jedem angemeldeten Kunden eine Nachricht, die diesen an sein Abonnement erinnert, begleitet von Anleitungen zum eventuellen Abbestellen der Nachrichten. Eine solche Erinnerungsnachricht kann wie folgt aussehen:
`You're subscribed to ExampleCorp alerts. Msg & data rates may apply. Reply HELP for help, STOP to unsubscribe.`
## Aufbewahren von Aufzeichnungen
Führen Sie Aufzeichnungen, aus denen hervorgeht, wann ein Kunde den Erhalt von SMS-Nachrichten von Ihnen angefordert hat und welche Nachrichten Sie an welche Kunden senden. Viele Ländern und Regionen auf der Welt fordern Sender von SMS-Nachrichten auf, dieses so aufzubewahren, dass Sie problemlos abgerufen werden können. Auch Mobilfunkanbieter können diese Informationen jederzeit von Ihnen anfordern. Die genauen Informationen, die Sie bereitstellen müssen, variieren je nach Land oder Region. Weitere Informationen über Aufbewahrungsanforderungen finden Sie in den Bestimmungen zu kommerziellem SMS Messaging in den Ländern oder Regionen, in denen Ihre Kunden ansässig sind.
Es kann vorkommen, dass ein Anbieter oder eine Regulierungsbehörde von uns verlangt, dass wir nachweisen, dass Kunden sich dafür entschieden haben, Nachrichten von Ihnen zu empfangen. Support Kontaktiert Sie in diesen Situationen mit einer Liste der Informationen, die der Transporteur oder die Agentur benötigt. Wenn Sie die notwendigen Informationen nicht bereitstellen können, schränken wir Ihre Möglichkeit, weitere SMS-Nachrichten zu senden, möglicherweise ein.
## Formulieren Sie Ihre Nachrichten klar, ehrlich und präzise
SMS ist ein einzigartiges Medium. Das character-per-message 160-Limit bedeutet, dass Ihre Nachrichten präzise sein müssen. Techniken, die Sie möglicherweise in anderen Kommunikationskanälen wie E-Mail verwenden, gelten möglicherweise nicht für den SMS-Kanal und wirken möglicherweise sogar unehrlich oder irreführend, wenn sie mit SMS-Nachrichten verwendet werden. Wenn der Inhalt Ihrer Nachrichten nicht mit bewährten Methoden übereinstimmt, ignorieren die Empfänger Ihre Nachrichten möglicherweise. Im schlimmsten Fall identifizieren die Mobilfunkanbieter Ihre Nachrichten möglicherweise als Spam und blockieren künftige Nachrichten von Ihrer Telefonnummer.
Dieser Abschnitt enthält einige Tipps und Anregungen zum Erstellen eines effektiven SMS-Nachrichtentexts.
### Identifizieren Sie sich als Absender
Ihre Empfänger sollten sofort erkennen können, dass eine Nachricht von Ihnen stammt. Absender, die diese bewährte Methode befolgen, geben am Anfang jeder Nachricht einen identifizierenden Namen („Programmname“) an.
**Vermeiden Sie Folgendes:**
`Your account has been accessed from a new device. Reply Y to confirm.`
**Versuchen Sie stattdessen dieses Linkformat:**
`ExampleCorp Financial Alerts: You have logged in to your account from a new device. Reply Y to confirm, or STOP to opt-out.`
### Versuchen Sie nicht, Ihre Nachricht wie eine Nachricht aussehen zu person-to-person lassen
Einige Vermarkter sind versucht, ihren SMS-Nachrichten eine persönliche Note zu verleihen, indem sie den Eindruck erwecken, dass ihre Nachrichten von einer Person stammen. Diese Strategie kann jedoch dazu führen, dass Ihre Nachricht wie ein Phishing-Versuch erscheint.
**Vermeiden Sie Folgendes:**
`Hi, this is Jane. Did you know that you can save up to 50% at Example.com? Click here for more info: https://www.example.com.`
**Versuchen Sie stattdessen dieses Linkformat:**
`ExampleCorp Offers: Save 25-50% on sale items at Example.com. Click here to browse the sale: https://www.example.com. Text STOP to opt-out.`
### Seien Sie vorsichtig, wenn Sie über Geld sprechen.
Betrüger machen sich oft den Wunsch der Menschen zunutze, Geld zu sparen und zu erhalten. Lassen Sie Angebote nicht so erscheinen, als seien sie zu gut, um wahr zu sein. Nutzen Sie die Verlockung des Geldes nicht, um Menschen zu täuschen. Verwenden Sie keine Währungssymbole, um Geldbeträge anzugeben.
**Vermeiden Sie Folgendes:**
`Save big $$$ on your next car repair by going to https://www.example.com.`
**Versuchen Sie stattdessen dieses Linkformat:**
`ExampleCorp Offers: Your ExampleCorp insurance policy gets you discounts at 2300+ repair shops nationwide. More info at https://www.example.com. Text STOP to opt-out.`
### Verwenden Sie nur die notwendigen Zeichen
Unternehmen neigen oft dazu, ihre eingetragenen Marken zu schützen, indem sie Markensymbole wie ™ oder ® in ihre Nachrichten aufnehmen. Diese Symbole sind jedoch nicht Teil des Standardzeichensatzes (bekannt als GSM-Alphabet), der in einer SMS-Nachricht mit 160 Zeichen enthalten sein kann. Wenn Sie eine Nachricht senden, die eines dieser Zeichen enthält, wird Ihre Nachricht automatisch mit einem anderen Zeichencodierungssystem gesendet, das nur 70 Zeichen pro Nachricht unterstützt. Infolgedessen könnte Ihre Nachricht in mehrere Teile zerlegt werden. Da Ihnen jeder gesendete Nachrichtenteil in Rechnung gestellt wird, kann die Nachricht Sie mehr kosten als erwartet. Darüber hinaus erhalten Ihre Empfänger statt einer einzigen Nachricht möglicherweise mehrere aufeinanderfolgende Nachrichten von Ihnen. Weitere Informationen zur SMS-Zeichencodierung erhalten Sie unter [SMS-Zeichenbeschränkungen in Amazon SNS](#channels-sms-limitations-characters).
**Vermeiden Sie Folgendes:**
`ExampleCorp Alerts: Save 20% when you buy a new ExampleCorp Widget® at example.com and use the promo code WIDGET.`
**Versuchen Sie stattdessen dieses Linkformat:**
`ExampleCorp Alerts: Save 20% when you buy a new ExampleCorp Widget(R) at example.com and use the promo code WIDGET.`
**Anmerkung**
Die beiden vorherigen Beispiele sind fast identisch. Das erste Beispiel enthält jedoch ein Symbol für eine eingetragene Marke (®), das nicht Bestandteil des GSM-Alphabets ist. Dadurch wird das erste Beispiel in zwei Nachrichtenteilen gesendet, während das zweite Beispiel als ein Nachrichtenteil seinen Empfänger erreicht.
### Verwenden gültiger, sicherer Links
Wenn Ihre Nachricht Links enthält, überprüfen Sie die Links, um sicherzustellen, dass sie funktionieren. Testen Sie Ihre Links auf einem Gerät außerhalb Ihres Unternehmensnetzwerks, um sicherzustellen, dass sie ordnungsgemäß aufgelöst werden. Aufgrund der Beschränkung von 160 Zeichen für SMS-Nachrichten URLs kann sehr lange Nachrichten auf mehrere Nachrichten aufgeteilt werden. Sie sollten Umleitungsdomänen verwenden, um verkürzte Inhalte bereitzustellen. URLs Sie sollten jedoch keine kostenlosen Linkverkürzungsdienste, wie tinyurl.com oder bitly.com, verwenden, da Netzbetreiber dazu neigen, Nachrichten zu filtern, die Links zu diesen Domänen enthalten. Sie können jedoch kostenpflichtige Linkverkürzungsdienste nutzen, solange Ihre Links auf eine Domäne verweisen, die ausschließlich der Nutzung Ihres Unternehmens oder Ihrer Organisation vorbehalten ist.
**Vermeiden Sie Folgendes:**
`Go to https://tinyurl.com/4585y8mr today for a special offer!`
**Versuchen Sie stattdessen dieses Linkformat:**
`ExampleCorp Offers: Today only, get an exclusive deal on an ExampleCorp Widget. See https://a.co/cFKmaRG for more info. Text STOP to opt-out.`
### Verwenden Sie nur eine begrenzte Anzahl von Abkürzungen
Das Limit von 160 Zeichen für den SMS-Kanal verleitet einige Absender dazu, in ihren Nachrichten verstärkt Abkürzungen zu verwenden. Die übermäßige Verwendung von Abkürzungen kann jedoch vielen Lesern unprofessionell erscheinen und dazu führen, dass einige Benutzer Ihre Nachricht als Spam melden. Es ist durchaus möglich, eine zusammenhängende Nachricht zu schreiben, ohne übermäßig viele Abkürzungen zu verwenden.
**Vermeiden Sie Folgendes:**
`Get a gr8 deal on ExampleCorp widgets when u buy a 4-pack 2day.`
**Versuchen Sie stattdessen dieses Linkformat:**
`ExampleCorp Alerts: Today only—an exclusive deal on ExampleCorp Widgets at example.com. Text STOP to opt-out.`
## Angemessene Antworten
Wenn ein Empfänger auf Ihre Nachrichten antwortet, stellen Sie sicher, dass Sie mit nützlichen Informationen reagieren. Zum Beispiel: Wenn ein Kunde auf eine Ihrer Nachrichten mit dem Schlüsselwort „HILFE“ antwortet, senden Sie diesem Informationen zu dem von ihm abonnierten Programm, zu der Anzahl der pro Monat gesendeten Nachrichten und Möglichkeiten zur Kontaktaufnahme mit Ihnen für weitere Informationen zu. Eine „HILFE“-Antwort kann wie folgt aussehen:
`HELP: ExampleCorp alerts: email help@example.com or call 425-555-0199. 2 msgs/month. Msg & data rates may apply. Reply STOP to cancel.`
Wenn ein Kunde mit dem Schlüsselwort „STOPP“ antwortet, teilen Sie ihm mit, dass er fortan keine weiteren Nachrichten mehr erhalten wird. Eine „STOPP“-Antwort kann wie folgt aussehen:
`You're unsubscribed from ExampleCorp alerts. No more messages will be sent. Reply HELP, email help@example.com, or call 425-555-0199 for more info.`
## Anpassen Ihres Sendens basierend auf der Kundenbeteiligung
Die Prioritäten Ihrer Kunden können sich mit der Zeit ändern. Wenn Kunden Ihre Nachrichten nicht mehr nützlich finden, bestellen sie sie möglicherweise ganz ab oder melden sie sogar als unerwünscht. Daher ist es wichtig, dass Sie Ihr Sendeverhalten auf der Grundlage der Kundenbeteiligung anpassen.
Für Kunden, die nur selten mit Ihren Nachrichten interagieren, sollten Sie die Häufigkeit Ihrer Nachrichten entsprechend anpassen. Wenn Sie z. B. wöchentliche Nachrichten an interessierte Kunden senden, können Sie für weniger interessierte Kunden einen monatlichen Kurzbericht erstellen.
Entfernen Sie schließlich Kunden, die niemals mit Ihren Nachrichten interagieren, vollständig aus Ihren Kundenlisten. Dieser Schritt wird verhindert, dass die Kunden irgend wann verärgert auf Ihre Nachrichten reagieren. Außerdem sparen Sie dadurch Geld und schützen Ihren guten Ruf als Sender.
## Senden zu angemessenen Zeiten
Senden Sie Nachrichten nur während üblicher Arbeitszeiten am Tage. Wenn Sie Nachrichten zur Mittagszeit oder mitten in der Nacht senden, ist es sehr wahrscheinlich, dass Kunden Ihre Nachrichten abbestellen, um davon nicht mehr gestört zu werden. Darüber hinaus ist es nicht sinnvoll, SMS-Nachrichten dann zu senden, wenn Ihre Kunden nicht sofort darauf reagieren können.
Wenn Sie Kampagnen oder Journeys an sehr große Zielgruppen senden, überprüfen Sie die Durchsatzraten für Ihre Ursprungsnummern. Teilen Sie die Anzahl der Empfänger durch Ihre Durchsatzrate, um zu bestimmen, wie lange es dauert, Nachrichten an alle Ihre Empfänger zu senden.
## Vermeiden Sie Ermüdungen durch die Nutzung mehrerer Kanäle
Wenn Sie in Ihren Kampagnen mehrere Kommunikationskanäle (z. B. E-Mail, SMS und Push-Nachrichten) verwenden, senden Sie nicht die gleiche Nachricht über jeden Kanal. Wenn Sie dieselbe Nachricht gleichzeitig über mehrere Kanäle senden, fühlen sich Ihre Kunden sehr wahrscheinlich dadurch eher gestört.
## Verwenden dedizierter Kurzwahlnummern
Wenn Sie Kurzwahlnummern verwenden, unterhalten Sie eine separate Kurzwahlnummer für jede Marke und jeden Nachrichtentyp. Wenn Ihr Unternehmen z. B. zwei Marken hat, verwenden Sie für jede davon eine eigene Kurzwahlnummer. Wenn Sie Transaktions- und Werbenachrichten versenden, verwenden Sie auch dafür jeweils separate Kurzwahlnummern. Weitere Informationen zum Anfordern von Kurzcodes finden Sie unter [Anfordern von Kurzcodes für SMS-Nachrichten mit AWS End User Messaging SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-request-short-code.html) im *AWS End User Messaging SMS Benutzerhandbuch*.
## Bestätigen Sie Ihre Ziel-Telefonnummern
Wenn Sie SMS-Nachrichten über Amazon SNS senden, wird Ihnen jeder Nachrichtenteil, den Sie senden, in Rechnung gestellt. Der Preis, den Sie pro Nachrichtenteil zahlen, hängt vom Land oder der Region des Empfängers ab. Weitere Informationen zu SMS-Preisen finden Sie unter [AWS Weltweite SMS-Preise](https://aws.amazon.com/sns/sms-pricing).
Wenn Amazon SNS eine Anfrage zum Senden einer SMS-Nachricht akzeptiert (als Ergebnis eines [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages)API-Aufrufs oder als Ergebnis einer gestarteten Kampagne oder Journey), wird Ihnen das Senden dieser Nachricht in Rechnung gestellt. Diese Aussage gilt auch dann, wenn der beabsichtigte Empfänger die Nachricht nicht erhält. Wenn beispielsweise die Telefonnummer des Empfängers nicht mehr vergeben ist oder wenn die Nummer, an die Sie die Nachricht gesendet haben, keine gültige Mobiltelefonnummer war, wird Ihnen das Senden der Nachricht dennoch in Rechnung gestellt.
Amazon SNS akzeptiert gültige Anfragen zum Senden von SMS-Nachrichten und versucht, diese zuzustellen. Aus diesem Grund sollten Sie überprüfen, ob die Telefonnummern, an die Sie Nachrichten senden, gültige Mobiltelefonnummern sind. Sie können AWS End User Messaging SMS damit eine Testnachricht senden, um festzustellen, ob eine Telefonnummer gültig ist und um welche Art von Nummer es sich handelt (z. B. Mobilfunk, Festnetz oder VoIP). Weitere Informationen finden [Sie im *AWS End User Messaging SMS Benutzerhandbuch* unter Senden einer Testnachricht mit dem SMS-Simulator](https://docs.aws.amazon.com/sms-voice/latest/userguide/getting-started-tutorial.html#getting-started-tutorial-step3).
## Erstellen Sie Entwürfe unter Beachtung der Redundanz
Für geschäftskritische Messaging-Programme empfehlen wir, Amazon SNS in mehr als einer AWS-Region zu konfigurieren. Amazon SNS ist in mehreren AWS-Regionen Varianten erhältlich. Eine Liste der Regionen, in denen Amazon SNS erhältlich ist, finden Sie in der [Allgemeine AWS-Referenz](https://docs.aws.amazon.com/general/latest/gr/sns.html).
Die Telefonnummern, die Sie für SMS-Nachrichten verwenden – einschließlich Kurzwahl-, Langwahl-, gebührenfreien Nummern und 10DLC-Nummern – können in AWS-Regionen nicht repliziert werden. Damit Sie Amazon SNS in mehreren Regionen verwenden können, müssen Sie daher in jeder Region, in der Sie Amazon SNS verwenden möchten, separate Telefonnummern anfordern. Wenn Sie beispielsweise eine Kurzvorwahl verwenden, um Textnachrichten an Empfänger in den Vereinigte Staaten zu senden, müssen Sie in jeder, AWS-Region die Sie verwenden möchten, separate Kurzcodes anfordern.
In einigen Ländern können Sie auch mehrere Arten von Telefonnummern verwenden, um die Redundanz zu erhöhen. In den USA können Sie beispielsweise Kurzwahlnummern, 10DLC-Nummern und gebührenfreie Nummern anfordern. Jeder dieser Telefonnummerntypen nimmt einen anderen Weg zum Empfänger. Die Verfügbarkeit mehrerer Rufnummerntypen — entweder in derselben AWS-Region oder auf mehrere verteilt AWS-Regionen— bietet eine zusätzliche Redundanzebene, die zur Verbesserung der Ausfallsicherheit beitragen kann.
## SMS-Limits und -Einschränkungen
Informationen zu den Beschränkungen und Beschränkungen für [SMS finden Sie unter Beschränkungen und Einschränkungen für SMS und MMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/sms-limitations.html) im *AWS End User Messaging SMS Benutzerhandbuch*.
## Verwalten von Schlüsselwörtern für die Abmeldung
SMS-Empfänger können ihre Geräte verwenden, um Nachrichten abzubestellen, indem sie mit einem Schlüsselwort antworten. Weitere Informationen finden Sie unter [Deaktivieren des Empfangs von SMS-Nachrichten](sms_manage.md#sms_manage_optout).
## CreatePool
Verwenden Sie die API-Aktion `CreatePool`, um einen neuen Pool zu erstellen und diesem Pool eine festgelegte Ursprungsidentität zuzuordnen. Weitere Informationen finden Sie [CreatePool](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_CreatePool.html)unter *AWS End User Messaging SMS API-Referenz*.
## PutKeyword
Verwenden Sie die `PutKeyword` API-Aktion, um eine Schlüsselwortkonfiguration für eine ursprüngliche Telefonnummer oder einen Pool zu erstellen oder zu aktualisieren. Weitere Informationen finden Sie [PutKeyword](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_PutKeyword.html)unter *AWS End User Messaging SMS API-Referenz.*
## Verwalten von Nummerneinstellungen
Informationen zum Verwalten der Einstellungen für die speziellen Kurz- und Langcodes, die Sie beim AWS Support angefordert und Ihrem Konto zugewiesen haben, finden Sie unter [Ändern der Funktionen einer Telefonnummer mit AWS CLI der](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-change-capabilitiy.html) Eingabe *AWS End User Messaging SMS*.
## SMS-Zeichenbeschränkungen in Amazon SNS
Eine einzelne SMS-Nachricht kann bis zu 140 Bytes enthalten. Die Anzahl der Zeichen für eine einzelne SMS-Nachricht hängt vom Typ der in der Nachricht verwendeten Zeichen ab.
Wenn Ihre Nachricht nur [Zeichen aus dem Zeichensatz GSM 03.38](#channels-sms-limitations-characters-gsm-alphabet), auch als GSM 7-Bit-Alphabet bekannt, enthält, sind bis zu 160 Zeichen zulässig. Enthält Ihre Nachricht nicht im Zeichensatz GSM 03.38 enthaltene Zeichen, sind 70 Zeichen zulässig. Wenn Sie eine SMS-Nachricht senden, bestimmt Amazon SNS automatisch die effizienteste Kodierung.
Enthält eine Nachricht mehr als die maximale Anzahl von Zeichen, wird die Nachricht in mehrere Teile aufgeteilt. Wenn Nachrichten in mehrere Teile aufgeteilt werden, enthält jedes Teil zusätzliche Informationen über den Nachrichtenteil, der ihm vorangestellt ist. Empfängt das Gerät des Empfängers dann die so getrennten Nachrichtenteile, verwendet es diese zusätzlichen Informationen, um alle Nachrichtenteile in der richtigen Reihenfolge anzuzeigen. Je nach Mobilfunkanbieter und Gerät des Empfängers können mehrere Nachrichten als eine Nachricht oder als Sequenz von separaten Nachrichten angezeigt werden. Daher verringert sich die Anzahl der Zeichen in den einzelnen Nachrichten auf 153 (für Nachrichten, die nur GSM 03.38 Zeichen enthalten) oder auf 67 (für Nachrichten, die andere Zeichen enthalten). Sie können vor dem Senden schätzen, wie viele Nachrichtenteile Ihre Nachricht enthält, indem Sie einen SMS-Längenrechner verwenden (es sind mehrere online verfügbar). Die maximal unterstützte Größe einer Nachricht beträgt 1600 GSM-Zeichen oder 630 Nicht-GSM-Zeichen. Weitere Informationen zum Durchsatz und zur Nachrichtengröße finden Sie unter [Begrenzungen für SMS-Zeichen in Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-sms-limitations-mps.html) im *Amazon-Pinpoint-Benutzerhandbuch*.
Wenn Sie die Anzahl der Nachrichtenteile für jede gesendete Nachricht anzeigen möchten, sollten Sie zuerst die [Ereignisstreamingeinstellungen](https://docs.aws.amazon.com/pinpoint/latest/userguide/settings-event-streams.html) aktivieren. Dann erzeugt Amazon SNS ein `_SMS.SUCCESS`-Ereignis, sobald die Nachricht an den Mobilfunkanbieter des Empfängers zugestellt wurde. Der `_SMS.SUCCESS`-Ereignisdatensatz enthält ein Attribut namens `attributes.number_of_message_parts`. Dieses Attribut gibt die Anzahl der Nachrichtenteile an, die in der Nachricht enthalten sind.
**Wichtig**
Wenn Sie eine Nachricht mit mehr als einem Nachrichtenteil senden, wird Ihnen die Anzahl der enthaltenen Nachrichtenteile in Rechnung gestellt.
### Zeichensatz GSM 03.38
In der folgenden Tabelle sind alle Zeichen aus dem Zeichensatz GSM 03.38 aufgeführt. Wenn Sie eine Nachricht senden, die nur Zeichen aus der folgenden Tabelle enthält, kann die Nachricht bis zu 160 Zeichen enthalten.
| GSM 03.38-Standardzeichen |
| --- |
| A | B | C | D | E | F | G | H | I | J | K | L | M |
| N | O | P | Q | R | S | T | U | V | W | X | Y | Z |
| a | b | c | d | e | f | g | h | i | j | k | l | i |
| n | o | p | q | r | S | t | u | V | w | x | y | z |
| à | Å | å | Ä | ä | Ç | É | é | è | ì | Ñ | ñ | ò |
| Ø | ø | Ö | ö | ù | Ü | ü | Æ | æ | ß | 0 | 1 | 2 |
| 3 | 4 | 5 | 6 | 7 | 8 | 9 | & | \$1 | @ | : | , | ¤ |
| \$1 | = | \$1 | > | \$1 | - | ¡ | ¿ | ( | < | % | . | \$1 |
| £ | ? | " | ) | § | ; | ' | / | \$1 | ¥ | Δ | Φ | Γ |
| Λ | Ω | Π | Ψ | Σ | Θ | Ξ | | | | | | |
Der Zeichensatz GSM 03.38 enthält neben den in der vorherigen Tabelle gezeigten Symbole noch weitere. Diese Zeichen zählen jedoch als zwei Zeichen, da sie alle ein unsichtbares Escape-Zeichen enthalten:
+ ^
+ \$1
+ \$1
+ \$1
+ [
+ ]
+ \$1
+ \$1
+ €
Darüber hinaus enthält der Zeichensatz GSM 03.38 die folgenden Zeichen, die nicht gedruckt werden:
+ Ein Leerzeichen.
+ Ein Zeilenvorschub-Steuerzeichen, das das Ende eine Textzeile und den Beginn einer neuen markiert.
+ Ein Wagenrücklauf-Steuerzeichen, das zum Anfang einer Textzeile führt (folgt in der Regel einem Zeilenvorschubzeichen).
+ Ein Escape-Steuerzeichen, das automatisch zu den Zeichen in der vorherigen Liste hinzugefügt wird.
### Beispielnachrichten
Dieser Abschnitt enthält Beispiele für SMS-Nachrichten. In diesem Abschnitt werden für jedes Beispiel die Gesamtzahl der Zeichen sowie die Anzahl der Nachrichtenteile einer Nachricht angezeigt.
**Beispiel 1: Lange Nachricht, die nur Zeichen im GSM 03.38-Alphabet enthält**
Die folgende Nachricht enthält nur Zeichen, die im GSM 03.38-Alphabet enthalten sind.
`Hello Carlos. Your Example Corp. bill of $100 is now available. Autopay is scheduled for next Thursday, April 9. To view the details of your bill, go to https://example.com/bill1.`
Die obige Nachricht enthält 180 Zeichen und muss daher in mehrere Nachrichtenteile aufgeteilt werden. Wenn eine Nachricht in mehrere Nachrichtenteile aufgeteilt wird, kann jedes Teil 153 GSM 03.38-Zeichen enthalten. Daher wird diese Nachricht in zwei Teilen gesendet.
**Beispiel 2: Nachricht, die Multibyte-Zeichen enthält**
Die folgende Nachricht enthält chinesische Zeichen, die nicht dem GSM 03.38-Alphabet angehören.
`亚马逊公司是一家总部位于美国西雅图的跨国电子商务企业，业务起始于线上书店，不久之后商品走向多元化。杰夫·贝佐斯于1994年7月创建了这家公司。`
Die obige Nachricht enthält 71 Zeichen. Da jedoch fast alle Zeichen in der Nachricht nicht im GSM 03.38-Alphabet enthalten sind, werden zwei Nachrichtenteile gesendet. Jedes dieser Nachrichtenteile kann maximal 67 Zeichen enthalten.
**Beispiel 3: Nachricht, die ein einzelnes Nicht-GSM-Zeichen enthält**
Die folgende Nachricht enthält ein Zeichen, das nicht Teil des GSM 03.38-Alphabets ist. In diesem Beispiel ist das Zeichen ein schließendes einfaches Anführungszeichen (’), das kein regulärer Apostroph (') ist. Textverarbeitungsanwendungen wie Microsoft Word ersetzen häufig automatisch Apostrophe durch schließende einfache Anführungszeichen. Wenn Sie Ihre SMS-Nachrichten in Microsoft Word entwerfen und in Amazon SNS einfügen, sollten Sie diese Sonderzeichen entfernen und durch Apostrophe ersetzen.
`John: Your appointment with Dr. Salazar’s office is scheduled for next Thursday at 4:30pm. Reply YES to confirm, NO to reschedule.`
Die obige Nachricht enthält 130 Zeichen. Da sie jedoch das schließende einfache Anführungszeichen enthält, das nicht Teil des GSM 03.38-Alphabets ist, werden zwei Nachrichtenteile gesendet.
Wenn Sie das schließende einfache Anführungszeichen in dieser Nachricht durch ein Apostroph (das im GSM 03.38-Alphabet enthalten ist) ersetzen, wird nur eine Nachricht gesendet.