Exemple de données d'événement de messagerie SMS destinées à un utilisateur AWS final

Mode de mise au point

Exemple de données d'événement de messagerie SMS destinées à un utilisateur AWS final - AWS Messagerie SMS à l'utilisateur final

Exemple de journal de SMS Exemple de journal d'événements vocaux Exemple de journal MMS

AWS Les SMS de messagerie à l'utilisateur final peuvent diffuser des données d'événements concernant les envois de SMS, de MMS et de messages vocaux. Les événements générés par les transporteurs peuvent prendre jusqu'à 72 heures pour être reçus et ne doivent pas être utilisés pour déterminer s'il y a un retard dans la livraison des messages sortants. Après 72 heures, si aucun événement final de AWS la part d'un opérateur n'a été envoyé par SMS à l'utilisateur final, le service renvoie automatiquement un message INCONNU, messageStatus car nous ne savons pas ce qu'il est advenu de ce message.

Exemple de journal de SMS

L'objet JSON d'un événement SMS contient les données illustrées dans l'exemple suivant.



{
    "eventType": "TEXT_SUCCESSFUL",
    "eventVersion": "1.0",
    "eventTimestamp": 1686975103470,
    "isFinal": true,
    "originationPhoneNumber": "+12065550152",
    "destinationPhoneNumber": "+14255550156",
    "isoCountryCode": "US",
    "mcc": "310",
    "mnc": "800",
    "messageId": "862a8790-60c0-4430-9b2b-658bdexample",
    "messageRequestTimestamp": 1686975103170,
    "messageEncoding": "GSM",
    "messageType": "PROMOTIONAL",
    "messageStatus": "SUCCESSFUL",
    "messageStatusDescription": "Message has been accepted by phone carrier",
    "context": {
        "account": "bar"
    },
    "totalMessageParts": 1,
    "totalMessagePrice": 0.09582,
    "totalCarrierFee": 0.0
}

Attribut	Description
`eventType`	Type d'événement. Les valeurs sont répertoriées dans Types d'événements pour les SMS, les MMS et les appels vocaux
`eventVersion`	Version du schéma JSON de l'événement.
`eventTimestamp`	Heure à laquelle l'événement a été signalé, affichée sous la forme Heure Unix en millisecondes.
`isFinal`	`True`s'il s'agit du statut final du message. Il existe des statuts de message intermédiaires et la réception du statut final du message peut prendre jusqu'à 72 heures.
`originationPhoneNumber`	Numéro de téléphone à partir duquel le message a été envoyé.
`destinationPhoneNumber`	Numéro de téléphone auquel vous avez tenté d'envoyer le message.
`isoCountryCode`	Pays associé au numéro de téléphone du destinataire, affiché au format ISO 3166-1 alpha-2.
`mcc`	Les codes de pays mobiles identifient le pays auquel appartient un numéro de téléphone. Ce champ est facultatif et peut ne pas être présent.
`mnc`	Les codes de réseau mobile identifient un opérateur de réseau mobile. Ce champ est facultatif et peut ne pas être présent.
`messageId`	L'identifiant unique généré par SMS par l'utilisateur AWS final lorsqu'il accepte le message.
`messageRequestTimestamp`	Heure à laquelle la demande de message SMS a été reçue, exprimée sous forme d'heure Unix en millisecondes.
`messageEncoding`	Le codage du message. Les valeurs possibles sont GSM et Unicode. Pour plus d'informations sur le codage des messages, consultezLimites de caractères des SMS.
`messageType`	Type du message. Les valeurs possibles sont Promotional et Transactional.
`messageStatus`	État du message. Les valeurs possibles sont : SUCCÈS — Le message a été accepté par l'opérateur téléphonique. LIVRÉ — Le message a été accepté par l'appareil du destinataire. PENDING : le message n'a pas encore été remis à l'appareil du destinataire. INVALID : le numéro de téléphone de destination n'est pas valide. UNREACHABLE : l'appareil du destinataire est actuellement inaccessible ou indisponible. Par exemple, l'appareil peut être éteint ou déconnecté du réseau. Vous pouvez réessayer d'envoyer le message ultérieurement. UNKNOWN : une erreur s'est produite qui a empêché la remise du message. Cette erreur est généralement transitoire et vous pouvez essayer d'envoyer le message à nouveau ultérieurement. BLOQUÉ — L'appareil du destinataire bloque les SMS provenant du numéro de téléphone de l'expéditeur. CARRIER_UNREACHABLE : un problème lié au réseau mobile du destinataire a empêché la remise du message. Cette erreur est généralement transitoire et vous pouvez essayer d'envoyer le message à nouveau ultérieurement. SPAM : l'opérateur mobile du destinataire a identifié le contenu du message comme courrier indésirable et a bloqué la distribution du message. INVALID_MESSAGE : le corps du message SMS n'est pas valide et ne peut pas être remis. CARRIER_BLOCKED : l'opérateur du destinataire a bloqué la distribution de ce message. Cela se produit souvent lorsque le transporteur identifie le contenu du message comme indésirable ou malveillant. TTL_EXPIRED : le SMS n'a pas pu être distribué dans un délai donné. Cette erreur est généralement transitoire et vous pouvez essayer d'envoyer le message à nouveau ultérieurement. ACCEPTÉ — Le message SMS a été accepté. ÉCHEC — Le message SMS n'a pas pu être envoyé à l'appareil du destinataire. ENVOYÉ — Le message a été envoyé mais n'a pas été remis à l'appareil du destinataire. IRROUTABLE — Impossible de router en raison d'une mauvaise configuration du compte. EN FILE D'ATTENTE — Le message est en attente de livraison
`messageStatusDescription`	Description de l'état du message.
`context`	Attributs personnalisés que vous pouvez spécifier et qui seront enregistrés lorsque vous enverrez un message.
`totalMessageParts`	Le nombre de parties du message créées par SMS par l'utilisateur AWS final afin d'envoyer le message. En général, les SMS ne peuvent contenir que 160 caractères GSM-7 ou 67 caractères autres que GSM, même si ces limites peuvent varier selon le pays . Si vous envoyez un message qui dépasse ces limites, AWS la messagerie SMS à l'utilisateur final divise automatiquement le message en plusieurs parties plus petites. Nous vous facturons en fonction du nombre de parties du message que vous envoyez. Pour plus d'informations sur les parties du message, voirQuelles sont les limites du nombre de parties de message par seconde (MPS) ?.
`totalMessagePrice`	Montant facturé pour l'envoi du message. Ce prix est indiqué en millièmes d'un cent des États-Unis. Par exemple, si la valeur de cet attribut est `645`, nous vous avons facturé 0,645 ¢ pour envoyer le message (645 / 1000 = 0,645 ¢ = 0,00645 $).
`totalCarrierFee`	Le coût total des frais du transporteur pour un message.

Exemple de journal d'événements vocaux

L'objet JSON d'un événement vocal contient les données présentées dans l'exemple suivant.



{
    "eventType": "VOICE_COMPLETED",
    "eventVersion": "1.0",
    "eventTimestamp": 1697835373500,
    "isFinal": true,
    "originationPhoneNumber": "+12065550153",
    "destinationPhoneNumber": "+14255550159",
    "isoCountryCode": "US",
    "messageId": "567f6c11-6e8b-4352-9749-a42a0example",
    "messageRequestTimestamp": 1697835372720,
    "messageStatus": "COMPLETED",
    "callDurationInSeconds": 60,
    "totalDurationInMinutes": 1,
    "totalMessagePrice": 0.013,
    "context": {
        "account": "bar"
    }
}

Attribut	Description
`eventType`	Type d'événement. Les valeurs sont répertoriées dans Types d'événements pour les SMS, les MMS et les appels vocaux
`eventVersion`	Version du schéma JSON de l'événement.
`eventTimestamp`	Heure à laquelle l'événement a été signalé, affichée sous la forme Heure Unix en millisecondes.
`isFinal`	`True`s'il s'agit du statut final du message. Il existe des statuts de message intermédiaires.
`originationPhoneNumber`	Numéro de téléphone à partir duquel le message a été envoyé.
`destinationPhoneNumber`	Numéro de téléphone auquel vous avez tenté d'envoyer le message.
`isoCountryCode`	Pays associé au numéro de téléphone du destinataire, affiché au format ISO 3166-1 alpha-2.
`messageId`	L'identifiant unique généré par SMS par l'utilisateur AWS final lorsqu'il accepte le message.
`messageRequestTimestamp`	Heure à laquelle la demande de message SMS a été reçue, exprimée sous forme d'heure Unix en millisecondes.
`messageStatus`	État du message. Les valeurs possibles sont : INITIÉ — Le message vocal est prêt à être composé. SONNERIE — Les sonneries se produisent une fois que l'appel a été passé, mais avant que le destinataire ne réponde. TERMINÉ — Envoie tous les événements terminés pour les messages vocaux à la destination spécifiée. Les événements terminés se produisent lorsque le message audio est diffusé au destinataire. Ce statut ne signifie pas nécessairement que le message a été remis à un destinataire humain. Par exemple, cela peut indiquer que le message a été envoyé à un système de messagerie vocale. RÉPONDU — Les événements auxquels une réponse a été donnée se produisent lorsque le destinataire répond au téléphone. TERMINÉ — L'appel a été répondu et s'est terminé. OCCUPÉ — Les événements d'affluence se produisent lorsque la ligne téléphonique du destinataire est occupée. NO_ANSWER — Des événements d'absence de réponse se produisent une fois que l'appel a été passé, mais le destinataire (ou son système de messagerie vocale) ne répond jamais. ÉCHEC — Des événements d'échec se produisent lorsque le message ne parvient pas à être remis. TTL_EXPIRED — Les événements TTL expirés se produisent lorsque le temps nécessaire pour délivrer le message dépasse la `TTL` valeur que vous avez spécifiée lors de l'envoi du message. SPAM — L'appel a été marqué comme spam et bloqué.
`callDurationInSeconds`	Durée de l'appel en secondes.
`totalDurationInMinutes`	Durée de l'appel en minutes.
`totalMessagePrice`	Le montant que nous vous avons facturé pour envoyer le message vocal. Ce prix est indiqué en millièmes d'un cent des États-Unis.
`context`	Attributs personnalisés que vous pouvez spécifier et qui seront enregistrés lorsque vous enverrez un message.

Exemple de journal MMS

L'objet JSON d'un événement MMS contient les données présentées dans l'exemple suivant.


{
    "contentType":"MMS",
    "eventType": "MEDIA_DELIVERED",
    "eventVersion": "1.0",
    "eventTimestamp": 1635197695208,
    "isFinal": true,
    "originationPhoneNumber": "+12065550153",
    "destinationPhoneNumber": "+14255550159",
    "isoCountryCode": "US",
    "messageId": "b4a3196d-5b61-4884-a0d9-745acf1f6235example",
    "messageRequestTimestamp": 1635197693241,
    "messageType": "TRANSACTIONAL",
    "messageStatus": "DELIVERED",
    "messageStatusDescription": "Message has been accepted by phone",
    "context": {"foo":"bar"},
    "totalMessageParts": 1,
    "totalMessagePrice": 0.0195,
    "totalCarrierFee": 0.00266
}

Attribut	Description
`eventType`	Type d'événement. Les valeurs sont répertoriées dans Types d'événements pour les SMS, les MMS et les appels vocaux
`eventVersion`	Version du schéma JSON de l'événement.
`eventTimestamp`	Heure à laquelle l'événement a été signalé, affichée sous la forme Heure Unix en millisecondes.
`isFinal`	`True`s'il s'agit du statut final du message. Il existe des statuts de message intermédiaires et la réception du statut final du message peut prendre jusqu'à 72 heures.
`originationPhoneNumber`	Numéro de téléphone à partir duquel le message a été envoyé.
`destinationPhoneNumber`	Numéro de téléphone auquel vous avez tenté d'envoyer le message.
`isoCountryCode`	Pays associé au numéro de téléphone du destinataire, affiché au format ISO 3166-1 alpha-2.
`messageId`	L'identifiant unique généré par SMS par l'utilisateur AWS final lorsqu'il accepte le message.
`messageRequestTimestamp`	Heure à laquelle la demande de message SMS a été reçue, exprimée sous forme d'heure Unix en millisecondes.
`messageType`	Type du message. Les valeurs possibles sont Promotional et Transactional.
`messageStatus`	État du message. Les valeurs possibles sont : SUCCÈS — Le message a été accepté par l'opérateur téléphonique. LIVRÉ — Le message a été accepté par l'appareil du destinataire. PENDING : le message n'a pas encore été remis à l'appareil du destinataire. INVALID : le numéro de téléphone de destination n'est pas valide. UNREACHABLE : l'appareil du destinataire est actuellement inaccessible ou indisponible. Par exemple, l'appareil peut être éteint ou déconnecté du réseau. Vous pouvez réessayer d'envoyer le message ultérieurement. UNKNOWN : une erreur s'est produite qui a empêché la remise du message. Cette erreur est généralement transitoire et vous pouvez essayer d'envoyer le message à nouveau ultérieurement. BLOQUÉ — L'appareil du destinataire bloque les messages SMS/MMS provenant du numéro de téléphone de l'expéditeur. CARRIER_UNREACHABLE : un problème lié au réseau mobile du destinataire a empêché la remise du message. Cette erreur est généralement transitoire et vous pouvez essayer d'envoyer le message à nouveau ultérieurement. SPAM : l'opérateur mobile du destinataire a identifié le contenu du message comme courrier indésirable et a bloqué la distribution du message. INVALID_MESSAGE — Le corps du message SMS/MMS n'est pas valide et ne peut pas être remis. CARRIER_BLOCKED : l'opérateur du destinataire a bloqué la distribution de ce message. Cela se produit souvent lorsque le transporteur identifie le contenu du message comme indésirable ou malveillant. TTL_EXPIRED : le SMS n'a pas pu être distribué dans un délai donné. Cette erreur est généralement transitoire et vous pouvez essayer d'envoyer le message à nouveau ultérieurement. ACCEPTÉ — Le message SMS a été accepté. ÉCHEC — Le message SMS n'a pas pu être envoyé à l'appareil du destinataire. ENVOYÉ — Le message a été envoyé mais n'a pas été remis à l'appareil du destinataire. IRROUTABLE — Impossible de router en raison d'une mauvaise configuration du compte. EN FILE D'ATTENTE — Le message est en attente de livraison
`messageStatusDescription`	Description de l'état du message.
`context`	Attributs personnalisés que vous pouvez spécifier et qui seront enregistrés lorsque vous enverrez un message.
`totalMessageParts`	Le nombre de parties du message créées par SMS par l'utilisateur AWS final afin d'envoyer le message. Pour plus d'informations sur les parties du message, voirQuelles sont les limites du nombre de parties de message par seconde (MPS) ?.
`totalMessagePrice`	Montant facturé pour l'envoi du message. Ce prix est indiqué en millièmes d'un cent des États-Unis. Par exemple, si la valeur de cet attribut est `645`, nous vous avons facturé 0,645 ¢ pour envoyer le message (645 / 1000 = 0,645 ¢ = 0,00645 $).
`totalCarrierFee`	Le coût total des frais du transporteur pour un message.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Types d’événements

Configurer la destination de CloudWatch l'événement Amazon

Sur cette page

Sélectionner vos préférences de cookies

Personnaliser les préférences de cookies

Essentiels

Performances

Fonctionnels

Publicitaires

Impossible d'enregistrer les préférences concernant les cookies

Exemple de données d'événement de messagerie SMS destinées à un utilisateur AWS final

Exemple de journal de SMS

Exemple de journal d'événements vocaux

Exemple de journal MMS

Sur cette page

Cette page vous a-t-elle été utile ?

Rubrique suivante :

Rubrique précédente :

Avez-vous besoin d’aide ?