Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Événements liés aux messages RCS

Lorsque vous envoyez des messages RCS avec AWS la messagerie à l'utilisateur final, la plateforme RCS génère des événements qui signalent les modifications du cycle de vie des messages, les interactions avec les destinataires et les résultats au niveau du système. Ces événements fournissent des signaux plus riches que les reçus de livraison par SMS traditionnels, vous permettant de savoir en temps réel si un message a été livré, lu, expiré ou s'il est revenu à un SMS ou à un MMS.

Les événements de statut sortants (livraison, lecture, expiration et secours) sont transmis via des destinations d'événements définies dans la configuration. Les événements d'interaction entrante (indicateurs de saisie et suggestions) sont transmis à la rubrique bidirectionnelle Amazon SNS que vous configurez sur votre agent RCS. Pour configurer les destinations des événements, voirDestinations des événements dans les messages SMS destinés aux utilisateurs AWS finaux.

Pour plus de détails sur les messages qui génèrent ces événements, consultezEnvoi de messages RCS enrichis.

Champs communs sur les événements RCS

Tous les événements RCS, y compris les événements d'état de livraison, les accusés de lecture et les événements d'interaction entrante, incluent les champs suivants qui identifient l'agent RCS :

Ces champs sont présents sur tous les événements du RCS. Ils ne sont pas inclus dans les événements SMS ou MMS.

Événements relatifs à l'état de livraison

Les événements relatifs à l'état de livraison indiquent l'état du cycle de vie d'un message RCS sortant. Vous utilisez ces événements pour confirmer la livraison, déclencher une logique de repli ou alerter votre équipe opérationnelle en cas de violation du contenu.

Chaque événement de statut sortant possède un eventType de RCS_DELIVERED (et les types d'événements de statut RCS associés) et un messageStatus champ contenant l'une des valeurs suivantes :

L'exemple suivant montre la charge utile d'un événement de livraison :

{
    "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"
}

Lire les reçus

Un accusé de lecture indique que le destinataire a ouvert ou consulté votre message. Utilisez des reçus de lecture pour suivre l'engagement et mesurer les taux de lecture.

L'événement read utilise un eventType de RCS_READ avec messageStatus défini sur 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"
}

Vous pouvez calculer votre taux de lecture en divisant le nombre d'READévénements par le nombre d'DELIVEREDévénements, multiplié par 100.

Indicateurs de saisie

Les événements liés aux indicateurs de saisie indiquent qu'un participant est en train de rédiger un message. Ces événements se déroulent dans les deux sens :

L'exemple suivant montre une notification de saisie entrante :

{
    "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"
}

Événements d'expiration du TTL

Lorsque vous définissez une TimeToLive valeur sur un message et que le TTL expire avant que le message ne soit délivré, la plateforme RCS tente de révoquer (supprimer) le message. Le résultat génère l'un des événements suivants :

Les événements d'expiration du TTL vont de pair avec votre stratégie de repli. Pour plus de détails sur la configuration de l'expiration des messages, consultezConfiguration de l'expiration des messages RCS.

Événements de secours

Lorsqu'un message RCS ne peut pas être délivré et que la messagerie de l'utilisateur AWS final déclenche une solution de secours par SMS ou MMS (soit par le biais d'une configuration basée sur le pool, soit par messageFallbackConfiguration), le service génère des événements qui indiquent le résultat de la solution de secours.

Les événements de repli indiquent :

Surveillez ces événements pour mesurer votre taux de repli et identifier les numéros de téléphone qui nécessitent régulièrement une livraison de secours. Pour plus de détails sur la configuration de la solution de secours par message, consultez. Configuration de la solution de secours par SMS ou MMS par message

Suggestion d'événements en appuyant sur le bouton (postback)

Lorsqu'un destinataire choisit une suggestion (une réponse suggérée ou une action suggérée), vous recevez un événement postback contenant la PostbackData chaîne que vous avez configurée pour cette suggestion. Utilisez les données de post-back pour acheminer votre logique conversationnelle, et non le texte affiché.

La notification messageBody contient un objet JSON avec un type deSUGGESTION, l'affichage text et le paramètre postbackData que vous avez défini sur la suggestion :

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

Pour plus de détails sur la configuration des suggestions et de leurs données de post-back, consultezConfiguration des suggestions RCS.

Événements et champs de tarification conversationnels

Si vous enregistrez votre agent RCS pour utiliser la tarification conversationnelle, AWS la messagerie utilisateur final ajoute des champs aux événements de livraison et d'entrée lorsqu'un message fait partie d'une session de conversation active, et envoie un CONVERSATION_STARTED événement au début d'une session. Pour un aperçu du modèle de tarification conversationnel, voirTarification conversationnelle.

Champs de conversation

Les champs suivants apparaissent sur une livraison ou un événement entrant uniquement lorsque le message fait partie d'une session de conversation active. Lorsque le message ne fait pas partie d'une conversation, AWS la messagerie à l'utilisateur final omet complètement ces champs.

Lorsqu'un message fait partie d'une session de conversation active, son événement de livraison signale un totalMessagePrice et un totalCarrierFee de0.0, car les frais de session couvrent le message. L'exemple suivant montre un événement de remise d'un message dans le cadre d'une conversation active :

{
    "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
}

événement CONVERSATION_STARTED

AWSLa messagerie destinée aux utilisateurs finaux envoie un CONVERSATION_STARTED événement à la rubrique Amazon SNS de votre événement RCS lorsqu'une session de conversation commence. Une session commence lorsque votre agent envoie un message et que le destinataire répond dans les 24 heures (initiative commerciale), ou lorsque le destinataire envoie un message et que votre agent répond (initiative initiée par l'utilisateur).

messageBodyIl contient un objet JSON avec les champs suivants :

L'exemple suivant montre un CONVERSATION_STARTED événement :

{
    "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"
}

Acheminement des événements vers des destinations

AWSLa messagerie destinée aux utilisateurs finaux achemine les événements RCS via des destinations d'événements définies dans la configuration. Vous configurez les destinations des événements sur le jeu de configuration associé à vos opérations d'envoi. Les destinations prises en charge incluent :

Pour savoir comment créer et configurer des destinations d'événements, consultezDestinations des événements dans les messages SMS destinés aux utilisateurs AWS finaux.

Lorsque vous appelezSendRcsMessage, spécifiez le ConfigurationSetName paramètre pour associer le message à votre ensemble de configuration. Les événements de statut sortants générés par ce message sont acheminés vers les destinations que vous avez configurées.

Lorsque vous configurez les types d'événements auxquels correspond une destination d'événement, vous pouvez choisir de vous abonner RCS_ALL à tous les types d'événements RCS avec un seul type correspondant, au lieu de répertorier chaque type d'événement RCS individuellement (tel que RCS_DELIVERED etRCS_READ).

Bonnes pratiques pour le traitement des événements