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
Topics
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.
| 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.
| 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.
| 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
| Limit | Wert |
|---|---|
| Hauptteil der Textnachricht | 3.072 Zeichen |
| Umfangreicher Kartentitel | 200 Zeichen |
| Umfangreiche Kartenbeschreibung | 2 000 Zeichen |
| Größe der Mediendatei | 100 MB |
| Länge der Medien-URL | 2 000 Zeichen |
| Vorschläge pro Nachricht | 11 |
| Vorschläge pro Karte | 4 |
| Text für Vorschläge anzeigen | 25 Zeichen |
| Postback-Daten | 2,048 Zeichen |
| Karussell-Karten | 2 bis 10 Karten |
| Time-to-live | 1 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