View a markdown version of this page

RCS-Meldungsereignisse - 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.

RCS-Meldungsereignisse

Wenn Sie RCS-Nachrichten mit AWS End User Messaging senden, generiert die RCS-Plattform Ereignisse, die Änderungen des Nachrichtenlebenszyklus, Empfängerinteraktionen und Ergebnisse auf Systemebene melden. Diese Ereignisse liefern aussagekräftigere Signale als herkömmliche SMS-Zustellungsbestätigungen und geben Ihnen in Echtzeit einen Überblick darüber, ob eine Nachricht zugestellt, gelesen, abgelaufen oder auf SMS oder MMS zurückgesendet wurde.

Ausgehende Statusereignisse (Zustellung, Lesen, Ablauf und Fallback) werden über konfigurierte Ereignisziele übermittelt. Eingehende Interaktionsereignisse (Tippindikatoren und Tippvorschläge) werden an das bidirektionale Amazon SNS SNS-Thema übermittelt, das Sie auf Ihrem RCS-Agenten konfigurieren. Informationen zum Einrichten von Veranstaltungszielen finden Sie unter. Veranstaltungsziele in AWS End User Messaging SMS

Einzelheiten zu den Nachrichten, die diese Ereignisse auslösen, finden Sie unterSenden umfangreicher RCS-Nachrichten.

Allgemeine Felder bei RCS-Ereignissen

Alle RCS-Ereignisse, einschließlich Zustellungsstatusereignisse, Lesebestätigungen und eingehende Interaktionsereignisse, enthalten die folgenden Felder, die den RCS-Agenten identifizieren:

rcsBusinessId

Die Plattform-ID für den RCS-Agenten, der die Nachricht gesendet oder empfangen hat.

agentIsoCountryCode

Der ISO-Ländercode des Landes, in dem der RCS-Agent registriert ist, zum Beispiel US oder. CA

Diese Felder sind bei allen RCS-Ereignissen vorhanden. Sie sind nicht in SMS- oder MMS-Ereignissen enthalten.

Ereignisse zum Lieferstatus

Ereignisse im Zustellungsstatus geben den Lebenszyklusstatus einer ausgehenden RCS-Nachricht an. Sie verwenden diese Ereignisse, um die Zustellung zu bestätigen, eine Ausweichlogik auszulösen oder Ihr Betriebsteam vor Inhaltsverstößen zu warnen.

Jedes ausgehende Statusereignis hat einen eventType Wert von RCS_DELIVERED (und zugehörige RCS-Statusereignistypen) und ein messageStatus Feld, das einen der folgenden Werte enthält:

DELIVERED

Die Nachricht hat das Gerät des Empfängers erreicht. Verwenden Sie dieses Ereignis, um alle ausstehenden Fallback-Timer zu stornieren.

PENDING

Die RCS-Plattform hat die Nachricht akzeptiert, sie aber noch nicht zugestellt. Starten Sie Ihren Fallback-Timer, wenn Sie dieses Ereignis erhalten.

UNDELIVERABLE

Die Plattform kann die Nachricht dauerhaft nicht zustellen (z. B. unterstützt das Gerät des Empfängers RCS nicht). Löse deinen SMS- oder MMS-Fallback aus und markiere die Telefonnummer für future Routing-Entscheidungen.

REJECTED

Die Nachricht wurde aufgrund eines Verstoßes gegen die Inhaltsrichtlinien abgelehnt. Informieren Sie Ihr Betriebsteam und überprüfen Sie den Inhalt der Nachricht.

Das folgende Beispiel zeigt eine Payload für ein Zustellungsereignis:

{ "eventType": "RCS_DELIVERED", "eventVersion": "1.0", "eventTimestamp": 1781661267660, "isFinal": true, "originationPhoneNumber": "rcs-c020de2520714385964ebf7b095c4b60", "destinationPhoneNumber": "+13022640220", "isoCountryCode": "US", "isInternationalSend": false, "messageId": "test-sc1-004", "messageRequestTimestamp": 1781300397157, "messageEncoding": "UNICODE", "messageType": "TRANSACTIONAL", "messageStatus": "DELIVERED", "messageStatusDescription": "Message has been accepted by phone", "totalMessageParts": 1, "totalMessagePrice": 0.007, "totalCarrierFee": 0.00494, "rcsMetadata": { "billingEventType": "RICH" }, "rcsBusinessId": "endusermessagingtesting1_06fr8x6o_agent", "agentIsoCountryCode": "US" }
Anmerkung

Statusereignisse für umfangreiche RCS-Nachrichten enthalten Abrechnungsmetadaten. Der rcsMetadata.billingEventType Wert gilt RICH für umfangreiche RCS-Nachrichten.

Quittungen lesen

Eine Lesebestätigung gibt an, dass der Empfänger Ihre Nachricht geöffnet oder angesehen hat. Verwenden Sie Lesebestätigungen, um das Engagement nachzuverfolgen und die Leseraten zu messen.

READ

Der Empfänger hat sich die Nachricht angesehen. Ein RCS_DELIVERED Ereignis wird immer vor oder zusammen mit dem RCS_READ Ereignis gesendet. Wenn Sie also kein separates Zustellungsereignis verarbeitet haben, behandeln Sie die Nachricht als zugestellt, wenn Sie das Leseereignis erhalten.

Das Leseereignis verwendet einen Wert eventType vonRCS_READ, der auf messageStatus Folgendes gesetzt istREAD:

{ "eventType": "RCS_READ", "eventVersion": "1.0", "eventTimestamp": 1781661267203, "isFinal": true, "originationPhoneNumber": "rcs-c020de2520714385964ebf7b095c4b60", "destinationPhoneNumber": "+13022640220", "isoCountryCode": "US", "isInternationalSend": false, "messageId": "test-sc1-004", "messageRequestTimestamp": 1781300397157, "messageEncoding": "UNICODE", "messageType": "TRANSACTIONAL", "messageStatus": "READ", "messageStatusDescription": "Message has been read by recipient", "totalMessageParts": 1, "totalMessagePrice": 0.0, "totalCarrierFee": 0.0, "rcsBusinessId": "endusermessagingtesting1_06fr8x6o_agent", "agentIsoCountryCode": "US" }

Sie können Ihre Leserate als die Anzahl der READ Ereignisse geteilt durch die Anzahl der DELIVERED Ereignisse, multipliziert mit 100, berechnen.

Indikatoren eingeben

Indikatorereignisse signalisieren, dass ein Teilnehmer gerade eine Nachricht verfasst. Diese Ereignisse fließen in beide Richtungen ab:

  • Eingehend (vom Benutzer zum Agenten): Wenn der Empfänger mit dem Verfassen einer Antwort beginnt, erhalten Sie eine eingehende Benachrichtigung zu Ihrem bidirektionalen Amazon SNS SNS-Thema. Das messageBody enthält ein JSON-Objekt mit einem von. type RCS_TYPING Verwenden Sie dies, um Ihre Konversationslogik vorzubereiten oder den Status in Ihrem Dashboard anzuzeigen.

  • Ausgehend (vom Agenten zum Benutzer): Agent-initiated Tippindikatoren, die dem Empfänger zeigen, dass Ihr Agent eine Antwort vorbereitet, sind eine geplante Funktion. Die aktuelle Verfügbarkeit finden Sie in den Versionshinweisen zu AWS End User Messaging.

Das folgende Beispiel zeigt eine eingehende Eingabebenachrichtigung:

{ "originationNumber": "12679164820", "destinationNumber": "rcs-cb1e6e519e9049fabf8c0ae38e4d876b", "messageBody": "{\"type\":\"RCS_TYPING\",\"receivedAt\":\"2026-06-17T17:36:29.937+0000\"}", "inboundMessageId": "12679164820-2026-06-17T17:36:29.937+0000" }
Anmerkung

Agent-initiated Eingabeindikatoren und von Agenten initiierte Lesebestätigungen, die Ihr Agent an einen Empfänger sendet, sind geplante Funktionen. Die aktuelle Verfügbarkeit finden Sie in den Versionshinweisen zu AWS End User Messaging.

TTL-Ablaufereignisse

Wenn Sie einen TimeToLive Wert für eine Nachricht festlegen und die TTL verstrichen ist, bevor die Nachricht zugestellt wird, versucht die RCS-Plattform, die Nachricht zu widerrufen (zu löschen). Das Ergebnis generiert eines der folgenden Ereignisse:

TTL_EXPIRATION_REVOKED

Die abgelaufene Nachricht wurde erfolgreich entfernt, bevor der Empfänger sie angesehen hat. Sie können Ihr SMS- oder MMS-Fallback ohne Bedenken auslösen, um sicherzustellen, dass der Empfänger den Inhalt erhält.

TTL_EXPIRATION_REVOKE_FAILED

Der Widerruf ist fehlgeschlagen und die Nachricht wird möglicherweise immer noch an den Empfänger zugestellt. Prüfen Sie in diesem Fall, ob das Senden einer Fallback-Nachricht zu einem Duplikat führen würde, bevor Sie fortfahren.

TTL-Ablaufereignisse passen zu Ihrer Fallback-Strategie. Einzelheiten zur Konfiguration des Ablaufs von Nachrichten finden Sie unter. Konfiguration des Ablaufs von RCS-Nachrichten

Fallback-Ereignisse

Wenn eine RCS-Nachricht nicht zugestellt werden kann und AWS End User Messaging einen SMS- oder MMS-Fallback auslöst (entweder über eine poolbasierte Konfiguration oder pro NachrichtFallbackConfiguration), generiert der Dienst Ereignisse, die auf das Fallback-Ergebnis hinweisen.

Fallback-Ereignisse deuten auf Folgendes hin:

  • Ob die Fallback-Nachricht erfolgreich gesendet wurde.

  • Der für den Fallback verwendete Kanal (SMS oder MMS).

  • Der Grund, warum die ursprüngliche RCS-Nachricht nicht zugestellt wurde (z. B. Gerät nicht RCS-capable, TTL-Ablauf oder Nichtverfügbarkeit der Plattform).

Überwachen Sie diese Ereignisse, um Ihre Fallback-Rate zu messen und Telefonnummern zu identifizieren, für die regelmäßig eine Ersatzzustellung erforderlich ist. Einzelheiten zur Konfiguration des Fallbacks pro Nachricht finden Sie unter. Konfiguration von SMS- oder MMS-Fallback pro Nachricht

Tippe auf Ereignisse (Postback), um Vorschläge zu machen

Wenn ein Empfänger einen Vorschlag auswählt (eine vorgeschlagene Antwort oder eine vorgeschlagene Aktion), erhalten Sie ein Postback-Ereignis, das die PostbackData Zeichenfolge enthält, die Sie für diesen Vorschlag konfiguriert haben. Verwenden Sie Postback-Daten, um Ihre Konversationslogik weiterzuleiten, nicht den Anzeigetext.

Wichtig

Ereignisse mit Suggestion Tap (Postback) werden nur an Ihr bidirektionales Amazon SNS SNS-Thema gesendet, nicht an konfigurierte Ereignisziele.

Die Benachrichtigung messageBody enthält ein JSON-Objekt mit einem type vonSUGGESTION, der Anzeige und demtext, was postbackData Sie auf dem Vorschlag festgelegt haben:

{ "originationNumber": "12679164820", "destinationNumber": "rcs-cb1e6e519e9049fabf8c0ae38e4d876b", "messageBody": "{\"type\":\"SUGGESTION\",\"text\":\"Open\",\"postbackData\":\"Open\"}", "inboundMessageId": "nIMYZGrBUILWng0Qck0deqVaAoTSJY5PsktKYOBYJhVaTsrdMdrs714e8SLZAjD3" }

Einzelheiten zur Konfiguration von Vorschlägen und ihren Postback-Daten finden Sie unterKonfiguration von RCS-Vorschlägen.

Wichtig

Entwerfen Sie Ihre PostbackData Werte als strukturierte Bezeichner (z. B.action:confirm_order:12345), sodass Sie sie programmgesteuert analysieren können. Vermeiden Sie es, sich auf Anzeigetext zu verlassen, der sich ändern kann, ohne Ihre Routing-Logik zu beeinträchtigen.

Preisgestaltung, Ereignisse und Felder im Konversationsmodus

Wenn Sie Ihren RCS-Agenten für die Nutzung von Conversational Pricing registrieren, fügt AWS End User Messaging Felder zu Liefer- und Eingangsereignissen hinzu, solange eine Nachricht Teil einer aktiven Konversationssitzung ist, und sendet ein CONVERSATION_STARTED Ereignis, wenn eine Sitzung beginnt. Einen Überblick über das Preismodell für Konversationen finden Sie unter. Preisgestaltung im Konversationsmodus

Felder für Konversationen

Die folgenden Felder werden bei einem Zustellungs- oder Eingangsereignis nur angezeigt, wenn die Nachricht Teil einer aktiven Konversationssitzung ist. Wenn die Nachricht nicht Teil einer Konversation ist, lässt AWS End User Messaging diese Felder vollständig weg.

conversationInitiatingMessageId

Die Nachrichten-ID, mit der die Konversationssitzung gestartet wurde. Anwesend bei der Zustellung und bei eingehenden Ereignissen.

conversationInitiatingMessageType

Wie die Konversation begann: OUTBOUND als Ihr Agent die erste Nachricht gesendet hat oder INBOUND als der Empfänger die erste Nachricht gesendet hat. Anwesend bei der Zustellung und bei eingehenden Ereignissen.

conversationSessionFee

Die Gebühr für eine einmalige Sitzung in US-Dollar wird einmal pro 24-Stunden-Konversationssitzung berechnet. Nur bei Lieferterminen anwesend.

Wenn eine Nachricht Teil einer aktiven Konversationssitzung ist, meldet ihr Zustellungsereignis ein totalMessagePrice und totalCarrierFee von0.0, da die Sitzungsgebühr die Nachricht abdeckt. Das folgende Beispiel zeigt ein Zustellungsereignis für eine Nachricht innerhalb einer aktiven Konversation:

{ "eventType": "RCS_DELIVERED", "eventVersion": "1.0", "eventTimestamp": 1751234567890, "isFinal": true, "originationPhoneNumber": "rcs-f4e4252a5abe48bea50a6c176a056124", "destinationPhoneNumber": "+14376638816", "isoCountryCode": "CA", "isInternationalSend": false, "messageId": "b4a3196d-5b61-4884-a0d9-745acf1f6235", "messageRequestTimestamp": 1751234565000, "messageEncoding": "UNICODE", "messageType": "TRANSACTIONAL", "messageStatus": "DELIVERED", "messageStatusDescription": "Message has been accepted by phone", "totalMessageParts": 1, "totalMessagePrice": 0.0, "totalCarrierFee": 0.0, "rcsMetadata": { "billingEventType": "BASIC" }, "rcsBusinessId": "endusermessagingtesting1_06fr8x6o_agent", "agentIsoCountryCode": "CA", "conversationInitiatingMessageId": "177930985040408106521449", "conversationInitiatingMessageType": "OUTBOUND", "conversationSessionFee": 0.012 }

CONVERSATION_STARTED-Ereignis

AWSEnd User Messaging sendet ein CONVERSATION_STARTED Ereignis an Ihr RCS-Event Amazon SNS SNS-Thema, wenn eine Konversationssitzung beginnt. Eine Sitzung beginnt, wenn Ihr Agent eine Nachricht sendet und der Empfänger innerhalb von 24 Stunden antwortet (geschäftlich initiiert), oder wenn der Empfänger eine Nachricht sendet und Ihr Agent antwortet (vom Benutzer initiiert).

Das messageBody enthält ein JSON-Objekt mit den folgenden Feldern:

type

Immer CONVERSATION_STARTED.

startTime

Die Startzeit der Sitzung im ISO 8601-Format.

endTime

Die Ablaufzeit der Sitzung im ISO 8601-Format. Dies ist immer 24 Stunden danachstartTime.

conversationInitiatingMessageId

Die Nachrichten-ID, mit der die Konversation gestartet wurde.

conversationInitiatingMessageType

OUTBOUNDwann Ihr Agent die erste Nachricht gesendet hat oder INBOUND wann der Empfänger die erste Nachricht gesendet hat.

Das folgende Beispiel zeigt ein CONVERSATION_STARTED Ereignis:

{ "originationNumber": "14376638816", "destinationNumber": "rcs-e138fa39eabf4d6d8e95546248c8dfa7", "messageBody": "{\"type\":\"CONVERSATION_STARTED\",\"startTime\":\"2026-06-28T04:03:08.002+0000\",\"endTime\":\"2026-06-29T04:08:08.002+0000\",\"conversationInitiatingMessageId\":\"7e7da6ec-234a-4d4f-bbc5-943bcca663ab\",\"conversationInitiatingMessageType\":\"OUTBOUND\"}", "inboundMessageId": "7e7da6ec-234a-4d4f-bbc5-943bcca663ab" }

Ereignisse an Ziele weiterleiten

AWSEnd User Messaging leitet RCS-Ereignisse über konfigurierte Ereignisziele weiter. Sie konfigurieren Ereignisziele in dem Konfigurationssatz, der Ihren Sendevorgängen zugeordnet ist. Zu den unterstützten Zielen gehören:

Amazon SNS

Verwenden Sie ein Amazon SNS SNS-Thema für die Verarbeitung von Ereignissen in Echtzeit, einschließlich der Auslösung von AWS Lambda-Funktionen, um auf Lieferbestätigungen oder das Tippen von Vorschlägen zu antworten.

Amazon Data Firehose

Verwenden Sie einen Firehose-Lieferstream, um Ereignisse zur langfristigen Speicherung und Berichterstattung an Amazon S3, Amazon Redshift oder andere Analyseziele zu senden.

CloudWatch Amazon-Protokolle

Verwenden Sie CloudWatch Logs zum Debuggen, zur Protokollanalyse und zur Einrichtung von CloudWatch Alarmen bei Ereignismustern (z. B. für Warnmeldungen bei hohen Ablehnungsraten).

Informationen zum Erstellen und Konfigurieren von Ereigniszielen finden Sie unter. Veranstaltungsziele in AWS End User Messaging SMS

Geben Sie beim Aufrufen den ConfigurationSetName Parameter anSendRcsMessage, um die Nachricht Ihrem Konfigurationssatz zuzuordnen. Durch diese Nachricht generierte ausgehende Statusereignisse werden an die von Ihnen konfigurierten Ziele weitergeleitet.

Wenn Sie die Ereignistypen konfigurieren, denen ein Ereignisziel entspricht, können Sie festlegenRCS_ALL, dass alle RCS-Ereignistypen mit einem einzigen passenden Typ abonniert werden, anstatt jeden RCS-Ereignistyp einzeln aufzulisten (z. B. und). RCS_DELIVERED RCS_READ

Anmerkung

Eingehende Interaktionsereignisse, einschließlich Tippindikatoren und Tippvorschlägen (Postbacks), werden an das bidirektionale Amazon SNS SNS-Thema gesendet, das auf Ihrem RCS-Agenten konfiguriert ist, nicht an konfigurierte Ereignisziele.

Bewährte Methoden für die Verarbeitung von Ereignissen

  • Konfigurieren Sie die Ziele für Ereignisse, bevor Sie mit dem Senden von Produktionsnachrichten beginnen. Dadurch wird sichergestellt, dass Sie alle Ereignisse von Anfang an erfassen.

  • Verwenden Sie DELIVERED Ereignisse, um Fallback-Timer zu stornieren. Wenn Sie eine Lieferbestätigung erhalten, senden Sie kein SMS- oder MMS-Fallback.

  • Verarbeiten Sie Abonnementereignisse (UNSUBSCRIBE) sofort, um die Einhaltung der Messaging-Vorschriften zu gewährleisten.

  • Implementieren Sie eine idempotente Ereignisverarbeitung. Verwenden Sie die Nachrichten-ID in Kombination mit dem Ereignistyp als Deduplizierungsschlüssel, um doppelte Ereigniszustellungen zu verarbeiten.

  • Behandeln Sie Ereignisse, die nicht in der richtigen Reihenfolge sind, indem Sie die Zeitstempel der Ereignisse vergleichen. Ereignisse können in einer anderen Reihenfolge eintreffen, als sie aufgetreten sind.

  • Überwachen Sie die Anzahl von Ablehnungen und unzustellbaren Lieferungen mithilfe von CloudWatch Alarmen, um Inhaltsprobleme zu erkennen oder Probleme frühzeitig zu beheben.