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](configuration-sets-event-destinations.md)
Einzelheiten zu den Nachrichten, die diese Ereignisse auslösen, finden Sie unter[Senden umfangreicher RCS-Nachrichten](rcs-rich-messaging.md).
**Topics**
+ [Allgemeine Felder bei RCS-Ereignissen](#rcs-events-common-fields)
+ [Ereignisse zum Lieferstatus](#rcs-events-delivery-status)
+ [Quittungen lesen](#rcs-events-read-receipts)
+ [Indikatoren eingeben](#rcs-events-typing-indicators)
+ [TTL-Ablaufereignisse](#rcs-events-ttl-expiration)
+ [Fallback-Ereignisse](#rcs-events-fallback)
+ [Tippe auf Ereignisse (Postback), um Vorschläge zu machen](#rcs-events-postback)
+ [Preisgestaltung, Ereignisse und Felder im Konversationsmodus](#rcs-events-conversational)
+ [Ereignisse an Ziele weiterleiten](#rcs-events-routing)
+ [Bewährte Methoden für die Verarbeitung von Ereignissen](#rcs-events-best-practices)
## 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` von`RCS_READ`, der auf `messageStatus` Folgendes gesetzt ist`READ`:
```
{
"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](rcs-message-expiration.md)
## 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 Nachricht`FallbackConfiguration`), 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](rcs-fallback-per-message.md)
## 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` von`SUGGESTION`, der Anzeige und dem`text`, 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 unter[Konfiguration von RCS-Vorschlägen](rcs-suggestions.md).
**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 nach Kundenwünschen](rcs-billing.md#rcs-billing-conversational)
### 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` von`0.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 danach`startTime`.
`conversationInitiatingMessageId`
Die Nachrichten-ID, mit der die Konversation gestartet wurde.
`conversationInitiatingMessageType`
`OUTBOUND`wann 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](configuration-sets-event-destinations.md)
Geben Sie beim Aufrufen den `ConfigurationSetName` Parameter an`SendRcsMessage`, 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 festlegen`RCS_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.