View a markdown version of this page

Exemple AWS Données relatives aux événements de messagerie SMS destinés à l'utilisateur final - AWS Messagerie SMS à l'utilisateur final

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.

Exemple AWS Données relatives aux événements de messagerie SMS destinés à l'utilisateur final

AWS Les SMS de messagerie à l'utilisateur final peuvent diffuser des données d'événements pour les envois de SMS, de MMS et de messages vocaux. Étant donné que la réception des événements générés par les transporteurs peut prendre jusqu'à 72 heures, vous ne devez pas les utiliser pour déterminer s'il y a un retard dans la livraison des messages sortants. Après 72 heures, si AWS aucun événement final n'a été envoyé par SMS à l'utilisateur final, le service renvoie automatiquement un message UNKNOWN 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", "isInternationalSend": false, "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 Trues'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 Le numéro de téléphone ou l'identifiant de l'agent RCS à partir duquel le message a été envoyé. Pour les SMS et MMS, cette valeur est un E.164 numéro de téléphone ou un code abrégé. Pour les messages RCS délivrés nativement via RCS, cette valeur est l'ID de l'agent RCS. Pour les messages RCS qui sont revenus à des SMS, cette valeur est le E.164 numéro de téléphone ou le code abrégé utilisé pour la livraison des SMS. Si vous envoyez des messages à l'aide de l'SendMessagesAPI Amazon Pinpoint, le champ équivalent dans l'événement de livraison est. originationNumber
destinationPhoneNumber Numéro de téléphone auquel vous avez tenté d'envoyer le message.
isInternationalSend Truesi la messagerie internationale est activée pour ce numéro de téléphone.
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 L'encodage 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 d'acheminer en raison d'une mauvaise configuration du compte.

  • EN FILE D'ATTENTE — Le message est en file d'attente pour être livré.

  • PROTECT_BLOCKED — Le message SMS a été bloqué par les règles de protection SMS.

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

Nombre de parties du message créées par SMS par l'utilisateur AWS final pour envoyer le message.

En général, les SMS ne peuvent contenir que 160 GSM-7 caractères ou 67 caractères non GSM, bien que ces limites puissent varier en fonction du 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 SMS Protect

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

{ "eventType": "TEXT_PROTECT_BLOCKED", "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": "PROTECT_BLOCKED", "messageStatusDescription": "Message blocked by protect configuration", "context": { "account": "bar" }, "totalMessageParts": 1, "totalMessagePrice": 0, "totalCarrierFee": 0, "protectConfiguration": { "protectConfigurationId": "protect-d777777777777771bbd5d59f4d903479", "protectStatus": "FILTER" }, "protectConfigurationAssessment": { "protectRecommendation": "BLOCK" "protectInsights": { "blockReason": "AIT_SUSPECTED" } } }
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 Trues'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 L'encodage 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 d'acheminer en raison d'une mauvaise configuration du compte.

  • EN FILE D'ATTENTE — Le message est en file d'attente pour être livré.

  • PROTECT_BLOCKED — Le message SMS a été bloqué par les règles de protection SMS.

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

Nombre de parties du message créées par SMS par l'utilisateur AWS final pour envoyer le message.

En général, les SMS ne peuvent contenir que 160 GSM-7 caractères ou 67 caractères non GSM, bien que ces limites puissent varier en fonction du 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.
protectConfiguration L'identifiant de la configuration de protection utilisée lors de l'envoi du message et le statut du pays de destination à ce moment-là. Pour plus d'informations sur SMS Protect, voir SMS Protect.
protectConfigurationAssessment Une évaluation visant à déterminer si SMS Protect pense que l'envoi de votre message doit être autorisé ou bloqué et les raisons du blocage, le cas échéant.

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 Trues'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 sans réponse se produisent une fois l'appel 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 requis 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é.

  • PROTECT_BLOCKED — Le message SMS a été bloqué par les règles de protection SMS.

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 Trues'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 SMS/MMS messages 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 SMS/MMS message 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 d'acheminer 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

Nombre de parties du message créées par SMS par l'utilisateur AWS final pour 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.

Exemple de journal RCS

L'objet JSON d'un événement RCS contient les données présentées dans les exemples suivants. Le originationPhoneNumber champ diffère selon que le message a été délivré nativement via RCS ou qu'il a été renvoyé à un SMS.

RCS-native livraison — Le originationPhoneNumber champ contient l'ID de l'agent RCS :

{ "eventType": "TEXT_SUCCESSFUL", "eventVersion": "1.0", "eventTimestamp": 1714000000000, "isFinal": true, "originationPhoneNumber": "rcs-agent-id-example", "destinationPhoneNumber": "+14255550156", "isInternationalSend": false, "messageId": "a1b2c3d4-e5f6-7890-abcd-ef1234example", "messageRequestTimestamp": 1714000000000, "messageType": "TRANSACTIONAL", "messageStatus": "SUCCESSFUL", "messageStatusDescription": "Message has been accepted by phone carrier", "totalMessageParts": 1, "totalMessagePrice": 0.003, "totalCarrierFee": 0.0 }

Livraison de secours par SMS — Le originationPhoneNumber champ contient le E.164 numéro de téléphone ou le code abrégé utilisé pour la livraison des SMS :

{ "eventType": "TEXT_SUCCESSFUL", "eventVersion": "1.0", "eventTimestamp": 1714000000000, "isFinal": true, "originationPhoneNumber": "+12065550152", "destinationPhoneNumber": "+14255550156", "isInternationalSend": false, "messageId": "b2c3d4e5-f6a7-8901-bcde-f12345example", "messageRequestTimestamp": 1714000000000, "messageType": "TRANSACTIONAL", "messageStatus": "SUCCESSFUL", "messageStatusDescription": "Message has been accepted by phone carrier", "totalMessageParts": 1, "totalMessagePrice": 0.00645, "totalCarrierFee": 0.0 }

Pour déterminer le canal de distribution, inspectez le originationPhoneNumber terrain. Si la valeur est un ID d'agent RCS, le message a été délivré via RCS. Si la valeur est un E.164 numéro de téléphone ou un code court, le message a été envoyé par SMS (soit directement, soit après le repli du RCS). Pour plus d'informations sur le comportement de repli du RCS, consultez. Solution de repli entre RCS et SMS à l'aide de pools téléphoniques