View a markdown version of this page

Senden umfangreicher RCS-Nachrichten - AWS SMS-Nachrichten für Endbenutzer

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.

Senden umfangreicher RCS-Nachrichten

Mit der SendRcsMessage API-Aktion in AWS End User Messaging können Sie umfangreiche, interaktive Inhalte über RCS (Rich Communication Services) an Empfänger senden. Umfangreiche RCS-Nachrichten gehen über reinen Text hinaus und enthalten umfangreiche Karten, Karussells, Mediendateien und Vorschläge, dass Empfänger Maßnahmen ergreifen. Diese interaktiven Elemente verwandeln unidirektionale Benachrichtigungen in wechselseitige Konversationserlebnisse. So können Empfänger beispielsweise einen Termin bestätigen, einen Produktkatalog durchsuchen oder ihren Standort teilen, ohne die Konversation zu verlassen.

Verwenden Sie diese Option, SendRcsMessage wenn Sie visuell ansprechende, interaktive Inhalte bereitstellen müssen, z. B. Produktkarten mit Bildern und Aktionsschaltflächen, Terminbestätigungen mit einem Kalendervorschlag, Dateianhänge oder Karussells mit mehreren Artikeln, durch die die Empfänger blättern. Jede SendRcsMessage Anfrage umfasst einen eigenen Textkörper für jeden beliebigen Textinhalt und kann für Empfänger, deren Geräte RCS nicht unterstützen, ein optionales SMS- oder MMS-Fallback beinhalten.

Verwenden Sie für Klartext-Nachrichten, für die keine umfangreiche Formatierung erforderlich ist, stattdessen die API-Aktion. SendTextMessage SendTextMessageakzeptiert nur Textinhalte, wodurch die Anfrage einfacher wird, und es funktioniert mit Messaging-Pools, die je nach Empfängerkapazität automatisch zwischen RCS und SMS wählen. Details hierzu finden Sie unter Senden von RCS-Nachrichten.

Wichtig

Sie können RCS-Messaging SendRcsMessage in allen Ländern verwenden, in denen RCS unterstützt wird. Die aktuelle Liste finden Sie unter. Unterstützte Länder für RCS

Voraussetzungen

Bevor Sie umfangreiche RCS-Nachrichten senden, führen Sie die RCS-Einrichtungsschritte unter durch. Erste Schritte mit RCS Bestätigen Sie zusätzlich zu einem registrierten AWS RCS-Agenten im Status Aktiv Folgendes:

  • Um umfangreiche Inhalte zu überprüfen, bevor Sie sie an Produktionsempfänger senden, fügen Sie Ihrem Testagenten ein registriertes Testgerät hinzu und senden Sie Testnachrichten an ihn. Details hierzu finden Sie unter Testen von RCS-Nachrichten.

  • Konfigurieren Sie ein Ereignisziel (ein Amazon SNS SNS-Thema oder ein Amazon Data Firehose-Lieferstream), um Lieferstatus-Ereignisse zu empfangen. Ein Ziel für das Ereignis ist erforderlich, wenn Ihre Nachrichten interaktive Elemente wie Vorschläge enthalten, da die ausgewählten Empfänger als Postback-Ereignisse an Ihre Anwendung gesendet werden. Details hierzu finden Sie unter Veranstaltungsziele in AWS End User Messaging SMS.

  • Wenn Sie ein SMS- oder MMS-Fallback konfigurieren und an Ziele senden, bei denen das Risiko besteht, dass die SMS weitergeleitet werden, ordnen Sie eine Schutzkonfiguration zu, um die Abmelde- und Länderregeln auf die Fallback-Nachricht anzuwenden. Details hierzu finden Sie unter Betrugsschutz in AWS SMS-Nachrichten für Endbenutzer.

Wählen Sie zwischen und SendTextMessage SendRcsMessage

Beide API-Aktionen können Nachrichten über RCS übermitteln, sie dienen jedoch unterschiedlichen Zwecken. SendTextMessagegeht davon aus, dass jede Nachricht als SMS zugestellt werden kann und sie auch über RCS zugestellt werden kann, wodurch ein einfacherer Anforderungsvertrag möglich ist. SendRcsMessagegeht von umfangreichen RCS-Inhalten aus und fügt Funktionen hinzu, die nicht SendTextMessage verfügbar sind, darunter Medien und strukturierte Inhaltstypen, Nachrichtenablaufzeiten mit Time-to-Live (TTL) und SMS- oder MMS-Fallback pro Nachricht.

SendTextMessage verglichen mit SendRcsMessage
Funktion SendTextMessage SendRcsMessage
Nachrichteninhalt Nur Klartext Text, Dateien, umfangreiche Karten und Karussells, jeweils mit optionalen Vorschlägen
Lieferkanäle RCS oder SMS RCS, mit optionalem SMS- oder MMS-Fallback
Kanalauswahl Der Pool wählt RCS oder SMS automatisch nach Empfängerfunktion aus Zuerst RCS, dann Ihr konfigurierter SMS- oder MMS-Fallback
Fallback Automatisch, poolbasiert Explizit, pro Nachricht
Herkunft, Identität Pool, Telefonnummer, Absender-ID oder AWS RCS Agent Pool oder AWS RCS Agent
Ablauf der Nachricht (TTL) Nein Ja
Vertrag anfragen Einfacher. Gleiche API wie beim Senden von SMS und MMS Dedizierte RCS-API mit separatem Textkörper und separaten Inhaltstypen

SendTextMessageEntscheiden Sie sich für Klartext-Benachrichtigungen, wenn Sie eine automatische Kanalauswahl auf Poolbasis wünschen oder wenn Sie bestehende SMS-Workflows mit minimalen Codeänderungen migrieren möchten. Wählen Sie, SendRcsMessage wann Sie Rich-Cards, Karussells, Mediendateien oder Vorschläge benötigen, wann Sie ein definiertes Fallback pro Nachricht wünschen oder wann Sie ein Ablaufdatum für zeitkritische Inhalte benötigen. TTL-based

Arten von Inhalten

Der RcsMessageContent Parameter enthält ein Content Objekt mit genau einem Inhaltstyp und eine optionale Liste auf NachrichtenebeneSuggestions. Sie können nicht mehrere Inhaltstypen in einer einzigen Anfrage kombinieren.

RCS-Inhaltstypen
Inhaltstyp Description Weitere Informationen
TextMessage Textkörper mit bis zu 3.072 Zeichen, mit optionalen Vorschlägen. Im Gegensatz zu einer SMS-Nachricht kann eine RCS-Textnachricht Vorschläge enthalten und wird als einzelne Nachricht zugestellt, anstatt in Segmente aufgeteilt zu werden. Senden von RCS-Textnachrichten
FileMessage Eine einzelne Mediendatei (Bild, Video, Audio oder PDF), auf die über eine HTTPS- oder Amazon S3 S3-URL verwiesen wird. RCS-Dateinachrichten senden
RichCard Eine strukturierte Karte mit optionalen Medien, einem Titel, einer Beschreibung und bis zu 4 Vorschlägen. RCS-Rich Cards versenden
Karussell Ein scrollbares Set mit 2 bis 10 Karten, jede mit eigenen Medien, Text und Vorschlägen. RCS-Karussells senden

Vorschläge

Vorschläge sind interaktive Chips, die die Empfänger auswählen, um eine Aktion auszuführen. Sie können Vorschläge zu jedem Inhaltstyp hinzufügen: Vorschläge auf Nachrichtenebene gelten für die gesamte Nachricht (bis zu 11), und Vorschläge auf Kartenebene gelten für eine einzelne Rich Card oder Carousel Card (bis zu 4). AWSEnd User Messaging unterstützt sechs Arten von Vorschlägen, darunter Antworten, Links und Aktionen wie das Wählen einer Telefonnummer oder das Teilen eines Standorts. Eine vollständige Liste der Vorschlagstypen, ihrer Parameter und Informationen zum Empfangen von Tippvorschlägen finden Sie unter. Konfiguration von RCS-Vorschlägen

SendRcsMessage Übersicht anfordern

Die SendRcsMessage Anfrage verwendet die folgenden Schlüsselparameter.

Die wichtigsten SendRcsMessage Parameter
Parameter Erforderlich Beschreibung
DestinationPhoneNumber Ja Zum Beispiel die Telefonnummer des Empfängers im E.164 Format+12065550100.
OriginationIdentity Ja Die ID oder der ARN eines Pools oder eines AWS RCS-Agenten, von dem aus gesendet werden soll. Der Agent muss sich im Status Aktiv befinden.
RcsMessageContent Nein Der Inhalt der Nachricht. Enthält ein Content Objekt mit genau einem vonTextMessage, FileMessage RichCardCarousel, oder und einer optionalen Suggestions Liste auf oberster Ebene.
FallbackConfiguration Nein Die SMS- oder MMS-Nachricht, die gesendet werden soll, wenn die RCS-Zustellung nicht erfolgreich ist. Enthält ein erforderliches Channel (SMSoderMMS)MessageBody, ein optionales MediaUrls für MMS und ein, OriginationIdentity das eine Telefonnummer oder Absender-ID ist.
TimeToLive Nein Die Zeit in Sekunden, bevor die Nachricht abläuft, wenn sie nicht zugestellt wird. Das Minimum ist 1 Sekunde und das Maximum ist 172.800 Sekunden (48 Stunden). Ein Wert von 10 Sekunden oder mehr wird empfohlen.
MessageFeedbackEnabled Nein Stellen Sie auf true ein, um Nachrichtenfeedback für die Nachricht zu aktivieren. Wenn der Empfänger die Nachricht erhält, aktualisieren Sie den Nachrichtenstatus, indem Sie den PutMessageFeedback Vorgang aufrufen.

Bei einer erfolgreichen Antwort wird eine zurückgegebenMessageId, mit der Sie Ereignisse im Zustellungsstatus korrelieren können.

Anmerkung

Fallback für SendRcsMessage wird pro Nachricht bis konfiguriert. FallbackConfiguration Das vollständige Fallback-Verhalten finden Sie unter. Konfiguration von SMS- oder MMS-Fallback pro Nachricht

Beschränkungen für Nachrichtengröße und Anzahl

Grenzwerte für RCS-Nachrichten
Limit Wert
Hauptteil der Textnachricht3.072 Zeichen
Umfangreicher Kartentitel200 Zeichen
Umfangreiche Kartenbeschreibung2 000 Zeichen
Größe der Mediendatei100 MB
Länge der Medien-URL2 000 Zeichen
Vorschläge pro Nachricht11
Vorschläge pro Karte4
Text für Vorschläge anzeigen25 Zeichen
Postback-Daten2,048 Zeichen
Karussell-Karten2 bis 10 Karten
Time-to-live1 Sekunde bis 172.800 Sekunden (48 Stunden)

Informationen zu RCS-Grenzwerten und Einschränkungen für alle Inhaltstypen finden Sie unter. Grenzwerte und Einschränkungen bei der Nachrichtenübermittlung

Zustellungsereignisse und Empfängeraktionen

AWSEnd User Messaging generiert Ereignisse, die den Status der Nachrichtenzustellung und die Aktionen des Empfängers melden, darunter Ereignisse wie Zugestellt, Gelesen, Fehlgeschlagen, Abgelaufen und Postback. Ein Postback-Ereignis wird generiert, wenn ein Empfänger einen Vorschlag auswählt und den PostbackData Wert angibt. Leiten Sie diese Ereignisse an ein Amazon SNS SNS-Thema, einen Amazon Data Firehose-Lieferstream oder Amazon CloudWatch Logs weiter. Details hierzu finden Sie unter RCS-Meldungsereignisse.

Bewährte Methoden

Gestalten Sie umfangreiche RCS-Nachrichten als interaktive Konversationserlebnisse. Legen Sie eine TimeToLive Option für zeitkritische Inhalte wie Einmalkennwörter fest, konfigurieren Sie ein SMS- oder MMS-Fallback für Nachrichten, die den Empfänger auch dann erreichen müssen, wenn sein Gerät RCS nicht unterstützt, halten Sie die Bezeichnungen für Vorschläge kurz (das Limit liegt bei 25 Zeichen) und fügen Sie strukturierte Identifikatoren hinzu, PostbackData damit Ihre Anwendung Antworten ohne zusätzliche Nachschlagevorgänge weiterleiten kann. Eine ausführliche Anleitung finden Sie unter. Bewährte Methoden von RCS