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.
Exemples
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 :
|
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 :
|
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 :
|
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 :
|
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