

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.

# Destinations des événements dans les messages SMS destinés aux utilisateurs AWS finaux
<a name="configuration-sets-event-destinations"></a>

La *destination d'un événement* est un lieu (tel qu'un CloudWatch groupe, un flux Amazon Data Firehose ou une rubrique Amazon SNS) vers lequel les SMS et les événements vocaux sont envoyés. Pour utiliser les destinations d'événements, vous devez d'abord créer la destination, puis l'associer à un[Ensembles de configuration dans les SMS de messagerie destinés aux utilisateurs AWS finaux](configuration-sets.md). Vous pouvez associer jusqu'à cinq destinations d'événements à un seul ensemble de configuration. Lorsque vous envoyez un message, votre appel à l'API inclut une référence au jeu de configuration. 

Les événements ou les reçus de livraison (DLR) 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.

**Conditions préalables**

Vous devez avoir déjà créé un ensemble de configuration auquel associer les destinations des événements, voir[Ensembles de configuration dans les SMS de messagerie destinés aux utilisateurs AWS finaux](configuration-sets.md).

**Topics**
+ [Types d’événements](configuration-sets-event-types.md)
+ [Exemples de données d'événements](configuration-sets-event-format.md)
+ [Configurer la destination de CloudWatch l'événement Amazon](configuration-sets-cloud-watch.md)
+ [Configurer la destination de l'événement Amazon Data Firehose](configuration-sets-kinesis.md)
+ [Configurer une destination d'événement Amazon SNS](configuration-sets-sns.md)

# Types d'événements pour les SMS, les MMS et les appels vocaux
<a name="configuration-sets-event-types"></a>

Le moyen le plus simple d’utiliser les destinations d’événements consiste à envoyer tous les SMS, les MMS et les événements vocaux vers une seule destination. Cependant, vous pouvez configurer les destinations des événements de manière à ce que des types spécifiques d'événements soient envoyés vers différentes destinations. Par exemple, vous pouvez envoyer tous les événements liés à la livraison à Firehose à des fins de stockage, et tous les événements de défaillance à une rubrique Amazon SNS afin d'être averti lorsqu'ils se produisent. Vous pouvez également envoyer des événements par SMS et des événements vocaux à différents endroits.

Vous pouvez configurer les destinations des événements pour envoyer les types d'événements suivants :

**SMS, MMS et événements vocaux**
+ **TOUT** — Envoie tous les SMS, MMS et événements vocaux vers la destination spécifiée.

**Événements SMS**
+ **TEXT\$1ALL** : envoie tous les événements SMS vers la destination spécifiée.
+ **TEXT\$1DELIVERED (Delivered)** — Envoie tous les événements de livraison de SMS à la destination spécifiée. Selon le pays de destination, les événements TEXT\$1DELIVERED et **TEXT\$1SUCCESSFUL** **peuvent être utilisés** de manière interchangeable.
+ **TEXT\$1SUCCESSFUL (Successful)** — Les événements de réussite se produisent lorsque le message est accepté par le transporteur du destinataire. Selon le pays de destination, les événements TEXT\$1DELIVERED et **TEXT\$1SUCCESSFUL** **peuvent être utilisés** de manière interchangeable.
+ **TEXT\$1QUEUED (Queued)** — Les événements de file d'attente se produisent lorsque le message est en attente de livraison, mais qu'il n'est pas encore livré.
+ **TEXT\$1PENDING (En attente)** — Les événements en attente se produisent lorsqu'un message est en cours de livraison, mais qu'il n'a pas encore été livré (ou n'a pas encore été livré).
+ **TEXT\$1BLOCKED (Blocked)** — Les événements bloqués se produisent lorsque l'appareil ou l'opérateur du destinataire bloque les messages destinés à ce destinataire.
+ **TEXT\$1TTL\$1EXPIRED (TTL expiré)** — 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.
+ **TEXT\$1CARRIER\$1UNREACHABLE (Transporteur inatteignable)** — Les événements Carrier Unreachable se produisent lorsqu'une erreur transitoire se produit sur le réseau de l'opérateur du destinataire du message.
+ **TEXT\$1INVALID (SMS non valide)** — Des événements non valides se produisent lorsque le numéro de téléphone de destination n'est pas valide.
+ **TEXT\$1INVALID\$1MESSAGE (Message non valide)** — Des événements de message non valides se produisent lorsque le corps du message SMS n'est pas valide et ne peut pas être délivré.
+ **TEXT\$1CARRIER\$1BLOCKED (Transporteur bloqué)** — Les événements de blocage du transporteur se produisent lorsque le transporteur du destinataire bloque la livraison du message. Cela se produit généralement lorsque l'opérateur identifie le message comme malveillant (par exemple, s'il contient des informations relatives à une escroquerie par hameçonnage) ou abusif (par exemple, si le message est soupçonné d'être un contenu non sollicité ou interdit).
+ **TEXT\$1UNREACHABLE (Unreachable)** — Des événements inaccessibles se produisent lorsque l'appareil du destinataire n'est pas disponible. Cela peut se produire si l'appareil n'est pas connecté à un réseau mobile ou s'il est éteint.
+ **TEXT\$1SPAM (Spam)** — Les événements de spam se produisent lorsque le transporteur du destinataire identifie le message comme contenant du contenu commercial non sollicité et bloque la livraison du message.
+ **TEXT\$1UNKNOWN (Unknown)** — Des événements inconnus se produisent lorsqu'un message ne parvient pas à être remis pour une raison qui n'est pas couverte par l'un des autres types d'événements. Les erreurs inconnues peuvent être transitoires ou permanentes.
+ **TEXT\$1PROTECT\$1BLOCKED (Protection bloquée) — Message bloqué par** la configuration de protection.

**Événements vocaux**
+ **VOICE\$1ALL** : envoie tous les événements vocaux vers la destination spécifiée.
+ **VOICE\$1COMPLETED (Completed)** — 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.
+ **VOICE\$1ANSWERED (Répondu)** — Les événements avec réponse se produisent lorsque le destinataire répond au téléphone. 
+ **VOICE\$1INITIATED (Initiated)** — Envoie des événements à la destination spécifiée chaque fois qu'un message vocal est lancé.
+ **VOICE\$1TTL\$1EXPIRED (TTL expiré)** — 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.
+ **VOICE\$1BUSY (Busy)** — Les événements d'affluence se produisent lorsque la ligne téléphonique du destinataire est occupée.
+ **VOICE\$1NO\$1ANSWER (Aucune réponse)** — 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.
+ **VOICE\$1RINGING (Sonnerie) — Les événements de sonnerie** se produisent une fois que l'appel a été passé, mais avant que le destinataire ne réponde.
+ **VOICE\$1FAILED (Failed)** — Des événements d'échec se produisent lorsque le message ne parvient pas à être remis.

**Événements MMS**
+ **MEDIA\$1ALL** — Envoie tous les événements MMS vers la destination spécifiée.
+ **MEDIA\$1PENDING (En attente)** — Les événements en attente se produisent lorsqu'un message est en cours de livraison, mais qu'il n'a pas encore été livré (ou n'a pas encore été livré).
+ **MEDIA\$1QUEUED (Queue) — Les événements de file d'attente** se produisent lorsque le message est en attente de livraison, mais qu'il n'est pas encore livré.
+ **MEDIA\$1SUCCESSFUL (Successful)** — Les événements de réussite se produisent lorsque le message est accepté par le transporteur du destinataire.
+ **MEDIA\$1DELIVERED (Delivered)** — Envoie tous les événements de diffusion de MMS vers la destination spécifiée.
+ **MEDIA\$1INVALID (MMS non valide)** — Des événements non valides se produisent lorsque le numéro de téléphone de destination n'est pas valide.
+ **MEDIA\$1INVALID\$1MESSAGE (Message non valide)** — Des événements de message non valides se produisent lorsque le corps du message MMS n'est pas valide et ne peut pas être délivré.
+ **MEDIA\$1UNREACHABLE (Unreachable)** — Des événements inaccessibles se produisent lorsque l'appareil du destinataire n'est pas disponible. Cela peut se produire si l'appareil n'est pas connecté à un réseau mobile ou s'il est éteint.
+ **MEDIA\$1CARRIER\$1UNREACHABLE (Transporteur inatteignable)** — Les événements Carrier Unreachable se produisent lorsqu'une erreur transitoire se produit sur le réseau de l'opérateur du destinataire du message.
+ **MEDIA\$1BLOCKED (Bloqué)** — Les événements bloqués se produisent lorsque l'appareil ou l'opérateur du destinataire bloque les messages destinés à ce destinataire.
+ **MEDIA\$1CARRIER\$1BLOCKED (Transporteur bloqué)** — Les événements de blocage du transporteur se produisent lorsque le transporteur du destinataire bloque la livraison du message. Cela se produit généralement lorsque l'opérateur identifie le message comme malveillant (par exemple, s'il contient des informations relatives à une escroquerie par hameçonnage) ou abusif (par exemple, si le message est soupçonné d'être un contenu non sollicité ou interdit).
+ **MEDIA\$1SPAM (Spam)** — Les événements de spam se produisent lorsque le transporteur du destinataire identifie le message comme contenant du contenu commercial non sollicité et bloque la livraison du message.
+ **MEDIA\$1UNKNOWN (Inconnu)** — Des événements inconnus se produisent lorsqu'un message ne parvient pas à être remis pour une raison qui n'est pas couverte par l'un des autres types d'événements. Les erreurs inconnues peuvent être transitoires ou permanentes.
+ **MEDIA\$1TTL\$1EXPIRED (TTL expiré)** — 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.
+ **MEDIA\$1FILE\$1TYPE\$1UNSUPPORTED (Type de fichier non pris en charge) — Des événements de type de fichier non pris en charge** se produisent lorsqu'un fichier multimédia n'est pas dans un format pris en charge. Pour obtenir la liste des types de fichiers pris en charge, voir [Types de fichiers MMS, taille et limites de caractères](mms-limitations-character.md)
+ **MEDIA\$1FILE\$1SIZE\$1EXCEDED (taille du fichier) — Un** événement de dépassement de taille de fichier se produit lorsque la taille du fichier multimédia est supérieure à 600 Ko.
+ **MEDIA\$1FILE\$1INACCESSIBLE (Fichier inaccessible)** — Des événements d'inaccessibilité de fichier se produisent lorsque l'utilisateur AWS final n'est pas autorisé à accéder au fichier par SMS.

# Exemple de données d'événement de messagerie SMS destinées à un utilisateur AWS final
<a name="configuration-sets-event-format"></a>

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 aucun événement final de AWS la part d'un opérateur n'a été envoyé par SMS, le service renvoie automatiquement un message `UNKNOWN` `messageStatus` car nous ne savons pas ce qu'il est advenu de ce message.

**Topics**
+ [Exemple de journal de SMS](#configuration-sets-event-format-sms-example)
+ [Exemple de journal SMS Protect](#configuration-sets-event-format-sms-protect-example)
+ [Exemple de journal d'événements vocaux](#configuration-sets-event-format-voice-example)
+ [Exemple de journal MMS](#configuration-sets-event-format-mms-example)

## Exemple de journal de SMS
<a name="configuration-sets-event-format-sms-example"></a>

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](configuration-sets-event-types.md)  | 
| 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. | 
| 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, consultez[Limites de caractères des SMS](sms-limitations-character.md). | 
| messageType | Type du message. Les valeurs possibles sont Promotional et Transactional. | 
| messageStatus |  État du message. Les valeurs possibles sont : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sms-voice/latest/userguide/configuration-sets-event-format.html)  | 
| 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, voir[Quelles sont les limites du nombre de parties de message par seconde (MPS) ?](sms-limitations-mps.md).  | 
| 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 \$1). | 
| totalCarrierFee | Le coût total des frais du transporteur pour un message. | 

## Exemple de journal SMS Protect
<a name="configuration-sets-event-format-sms-protect-example"></a>

L'objet JSON d'un événement SMS lors de l'utilisation de [SMS Protect](protect.md) 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](configuration-sets-event-types.md)  | 
| 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, consultez[Limites de caractères des SMS](sms-limitations-character.md). | 
| messageType | Type du message. Les valeurs possibles sont Promotional et Transactional. | 
| messageStatus |  État du message. Les valeurs possibles sont : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sms-voice/latest/userguide/configuration-sets-event-format.html)  | 
| 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, voir[Quelles sont les limites du nombre de parties de message par seconde (MPS) ?](sms-limitations-mps.md).  | 
| 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 \$1). | 
| 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](protect.md). | 
| 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
<a name="configuration-sets-event-format-voice-example"></a>

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](configuration-sets-event-types.md)  | 
| 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 : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sms-voice/latest/userguide/configuration-sets-event-format.html)  | 
| 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
<a name="configuration-sets-event-format-mms-example"></a>

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](configuration-sets-event-types.md)  | 
| 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 : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sms-voice/latest/userguide/configuration-sets-event-format.html)  | 
| 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, voir[Quelles sont les limites du nombre de parties de message par seconde (MPS) ?](sms-limitations-mps.md).   | 
| 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 \$1). | 
| totalCarrierFee | Le coût total des frais du transporteur pour un message. | 

# Configurer une destination d' CloudWatch événement Amazon dans un SMS de messagerie à l'utilisateur AWS final
<a name="configuration-sets-cloud-watch"></a>

Amazon CloudWatch Logs est un AWS service que vous pouvez utiliser pour surveiller, stocker et accéder aux fichiers journaux. Lorsque vous créez une destination d' CloudWatch événement, AWS la messagerie SMS destinée à l'utilisateur final envoie à un CloudWatch groupe les types d'événements que vous avez spécifiés dans la destination de l'événement. Pour en savoir plus CloudWatch, consultez le [guide de l'utilisateur d'Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/).

**Conditions préalables**

1. Avant de créer une destination d' CloudWatch événement, vous devez d'abord créer un CloudWatch groupe. Pour plus d'informations sur la création de groupes de journaux, consultez la section [Utilisation des groupes de journaux et des flux](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) de * CloudWatch journaux dans le guide de l'utilisateur Amazon Logs*.
**Important**  
Vous aurez besoin du nom de ressource Amazon (ARN) du CloudWatch groupe pour créer la destination de l'événement.

1. Vous devez créer un [rôle IAM](configuration-sets-cloud-watch-creating-role.md#configuration-sets-cloud-watch-creating-role.title) qui autorise les messages SMS de l'utilisateur AWS final à écrire dans le groupe de journaux.
**Important**  
Vous aurez besoin du nom de ressource Amazon (ARN) du rôle IAM pour créer la destination de l'événement.

1. Vous avez également configuré un ensemble de configuration pour associer les destinations des événements, voir[Création d'un ensemble de configuration dans le SMS de messagerie à l'utilisateur AWS final](configuration-set-create.md).

# Politique IAM pour Amazon CloudWatch
<a name="configuration-sets-cloud-watch-creating-role"></a>

Utilisez l'exemple suivant pour créer une politique d'envoi d'événements à un CloudWatch groupe.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogStream",
                "logs:DescribeLogStreams",
                "logs:PutLogEvents"
            ],
            "Resource": [
                "arn:aws:logs:us-east-1:111122223333:log-group:log-group-name:*"
            ]
        }
    ]    
}
```

------

Pour des informations sur les politiques IAM, consultez [Politiques et autorisations dans IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) dans le *Guide de l'utilisateur IAM*.

L'exemple d'instruction suivant utilise les `SourceArn` conditions facultatives mais recommandées pour vérifier que seul le compte propriétaire de la messagerie SMS de l'utilisateur AWS final a accès au jeu de configuration. `SourceAccount` Dans cet exemple, remplacez-le *accountId* par votre identifiant de AWS compte, *region* par le Région AWS nom et *ConfigSetName* par le nom du jeu de configuration.

Après avoir créé la politique, créez un nouveau rôle IAM, puis associez-y la politique. Lorsque vous créez le rôle, ajoutez-y également la politique de confiance suivante :

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": {
        "Effect": "Allow",
        "Principal": {
            "Service": "sms-voice.amazonaws.com"
        },
        "Action": "sts:AssumeRole",
        "Condition": {
            "StringEquals": {
                "aws:SourceAccount": "111122223333"
            },
            "ArnLike": {
                "aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
            }
        }
    }
}
```

------

Pour plus d'informations sur la création de rôles IAM, consultez [Création de rôles IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) dans le *Guide de l'utilisateur IAM*.

# Création d'une destination d' CloudWatch événement Amazon dans un SMS destiné aux utilisateurs AWS finaux
<a name="configuration-sets-cloud-watch-add"></a>

Après avoir créé le rôle IAM et le CloudWatch groupe, vous pouvez créer la destination de l'événement.

------
#### [ Create event destination (Console) ]

Pour créer une destination d'événement à l'aide de la console SMS de messagerie utilisateur AWS final, procédez comme suit :

1. Ouvrez la console SMS de messagerie utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Dans le volet de navigation, sous **Configurations**, sélectionnez **Ensembles de configuration**.

1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration auquel ajouter une destination d'événement. 

1. Sur la page des **détails du jeu de configuration**, choisissez **Ajouter un événement de destination**.

1. Dans la section **Détails de l'événement**, entrez un nom convivial pour le nom de **destination de l'événement**.

1. Dans le menu déroulant **Type de destination**, sélectionnez Amazon CloudWatch.

1. Pour le **rôle IAM arn**, entrez l'ARN du rôle IAM. Pour plus d'informations sur le rôle IAM arn, consultez[Politique IAM pour Amazon CloudWatch](configuration-sets-cloud-watch-creating-role.md).

1. Pour **Log group arn**, entrez l'ARN du groupe de CloudWatch journaux Amazon auquel transmettre les événements. 

1. Activez la **publication d'événements**.

1. Sous **Types d'événements**, sélectionnez :
   + **Tous les événements SMS (recommandé)** — Choisissez cette option pour envoyer tous les événements SMS répertoriés sur Amazon CloudWatch. [Types d’événements](configuration-sets-event-types.md)
   + **Événements SMS personnalisés** : choisissez des événements SMS spécifiques auxquels envoyer CloudWatch. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements SMS**. Sur **Modifier la sélection des événements par SMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon CloudWatch. Choisissez **Enregistrer la sélection**.
   + **Tous les événements vocaux (recommandé)** — Choisissez cette option pour envoyer tous les événements [Types d’événements](configuration-sets-event-types.md) vocaux répertoriés sur Amazon CloudWatch.
   + **Événements vocaux personnalisés** : choisissez des événements vocaux spécifiques auxquels envoyer CloudWatch. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements vocaux**. Sur **Modifier la sélection des événements vocaux**, cochez uniquement les événements que vous souhaitez envoyer à Amazon CloudWatch. Choisissez **Enregistrer la sélection**.
   + **Tous les événements MMS (recommandé)** — Choisissez cette option pour envoyer tous les événements MMS répertoriés [Types d’événements](configuration-sets-event-types.md) sur Amazon. CloudWatch
   + Événements **MMS personnalisés — Choisissez des événements** MMS spécifiques auxquels envoyer. CloudWatch Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements MMS**. Lors de la **sélection des événements Edit MMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon CloudWatch. Choisissez **Enregistrer la sélection**.

1. Choisissez **Create event (Créer un événement)**.

------
#### [ Create event destination (AWS CLI) ]

Vous pouvez utiliser la [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)commande pour créer une destination d'événement.

Dans la ligne de commande, exécutez la commande suivante :

```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup
```

Dans l’exemple précédent, apportez les modifications suivantes :
+ *eventDestinationName*Remplacez-le par un nom décrivant la destination de l'événement.
+ *configurationSet*Remplacez-le par le nom du jeu de configuration auquel vous souhaitez associer la destination de l'événement.
+ Remplacez *eventTypes* par un ou plusieurs des types d'événements répertoriés dans[Types d'événements pour les SMS, les MMS et les appels vocaux](configuration-sets-event-types.md). 
+ Remplacez la valeur de `IamRoleArn` par l'Amazon Resource Name (ARN) d'un rôle IAM dont les politiques sont décrites dans [Politique IAM pour Amazon CloudWatch](configuration-sets-cloud-watch-creating-role.md).
+ Remplacez la valeur `LogGroupArn` de par l'ARN du CloudWatch groupe auquel vous souhaitez envoyer des événements. 

------

# Modifier la destination d'un CloudWatch événement Amazon dans un SMS destiné aux utilisateurs AWS finaux
<a name="configuration-sets-cloud-watch-edit"></a>

Utilisez la console SMS de messagerie utilisateur AWS final ou AWS CLI pour modifier la destination d'un CloudWatch événement.

------
#### [ Update event destination (Console) ]

Pour mettre à jour la destination d'un événement à l'aide de la console SMS de messagerie utilisateur AWS final, procédez comme suit :

1. Ouvrez la console SMS de messagerie de l'utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Dans le volet de navigation, sous **Configurations**, sélectionnez **Ensembles de configuration**.

1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration à modifier. 

1. Dans l'onglet **Paramètres de l'événement**, choisissez une destination d' CloudWatchévénement Amazon, puis **Modifier**.

1. Dans le **champ ARN du rôle IAM**, entrez l'ARN du rôle IAM. Pour plus d'informations sur le rôle IAM arn, consultez[Politique IAM pour Amazon CloudWatch](configuration-sets-cloud-watch-creating-role.md).

1. Pour **Log group arn**, entrez l'ARN du groupe de CloudWatch journaux Amazon auquel transmettre les événements. 

1. Sous **Types d'événements**, sélectionnez :
   + **Tous les événements SMS (recommandé)** — Choisissez cette option pour envoyer tous les événements SMS répertoriés sur Amazon CloudWatch. [Types d’événements](configuration-sets-event-types.md)
   + **Événements SMS personnalisés** — Choisissez cette option pour sélectionner les événements SMS spécifiques auxquels envoyer CloudWatch. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements SMS**. Sur **Modifier la sélection des événements par SMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon CloudWatch. Choisissez **Enregistrer la sélection**.
   + **Tous les événements vocaux (recommandé)** — Choisissez cette option pour envoyer tous les événements [Types d’événements](configuration-sets-event-types.md) vocaux répertoriés sur Amazon CloudWatch.
   + **Événements vocaux personnalisés** : choisissez cette option pour sélectionner les événements vocaux spécifiques auxquels envoyer CloudWatch. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements vocaux**. Sur **Modifier la sélection des événements vocaux**, cochez uniquement les événements que vous souhaitez envoyer à Amazon CloudWatch. Choisissez **Enregistrer la sélection**.
   + **Tous les événements MMS (recommandé)** — Choisissez cette option pour envoyer tous les événements MMS répertoriés [Types d’événements](configuration-sets-event-types.md) sur Amazon. CloudWatch
   + **Événements MMS personnalisés** — Choisissez cette option pour sélectionner les événements MMS spécifiques auxquels vous souhaitez les envoyer. CloudWatch Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements MMS**. Lors de la **sélection des événements Edit MMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon CloudWatch. Choisissez **Enregistrer la sélection**.

1. Choisissez **Modifier l'événement**.

------
#### [ Update event destination AWS CLI) ]

Vous pouvez utiliser la [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)commande pour mettre à jour la destination d'un événement.

La procédure de mise à jour d'une destination d' CloudWatch événement est similaire au processus de création d'une destination d'événement. Dans la ligne de commande, exécutez la commande suivante :

```
$ aws pinpoint-sms-voice-v2 update-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event types eventTypes \
> --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup
```

Dans l’exemple précédent, apportez les modifications suivantes :
+ *eventDestinationName*Remplacez-le par le nom de la destination de l'événement que vous souhaitez modifier.
+ *configurationSet*Remplacez-le par le nom du jeu de configuration auquel vous souhaitez associer la destination de l'événement. Vous pouvez associer la destination de l'événement à un autre jeu de configuration.
+ *eventTypes*Remplacez-le par l'un des types d'événements répertoriés dans[Types d'événements pour les SMS, les MMS et les appels vocaux](configuration-sets-event-types.md).
+ Remplacez la valeur de `IamRoleArn` par l'Amazon Resource Name (ARN) d'un rôle IAM dont les politiques sont décrites dans [Types d'événements pour les SMS, les MMS et les appels vocaux](configuration-sets-event-types.md).
+ Remplacez la valeur `LogGroupArn` de par l'ARN du CloudWatch groupe auquel vous souhaitez envoyer des événements. 

------

# Supprimer une destination d' CloudWatch événement Amazon dans un SMS de messagerie à l'utilisateur AWS final
<a name="configuration-sets-cloud-watch-delete"></a>

Utilisez la console SMS de messagerie utilisateur AWS final ou AWS CLI pour supprimer une destination d' CloudWatch événement.

------
#### [ Delete an CloudWatch event destination (Console) ]

Le processus de suppression d'une destination d'événement est le même quel que soit le type de destination d'événement que vous souhaitez supprimer.

**Pour supprimer une destination d' CloudWatch événement dans la console**

1. Ouvrez la console SMS de messagerie de l'utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Dans le volet de navigation, sous **Configurations**, sélectionnez **Ensembles de configuration**.

1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration dont vous souhaitez supprimer une destination d'événement. 

1. Dans la section **Toutes les destinations**, choisissez une destination d'événement, puis cliquez **sur Supprimer**.

------
#### [ Delete an CloudWatch event destination (AWS CLI) ]

Vous pouvez utiliser la [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)commande pour supprimer la destination d'un événement.

Le processus de suppression d'une destination d'événement est le même quel que soit le type de destination d'événement que vous souhaitez supprimer.

**Pour supprimer une destination d' CloudWatch événement dans AWS CLI**
+ Dans la ligne de commande, exécutez la commande suivante :

  ```
  $ aws pinpoint-sms-voice-v2 delete-event-destination \
  > --event-destination-name eventDestinationName \
  > --configuration-set-name configurationSetName
  ```

  Dans l’exemple précédent, apportez les modifications suivantes :
  + *eventDestinationName*Remplacez-le par le nom ou le Amazon Resource Name (ARN) de la destination de l'événement que vous souhaitez supprimer.
  + Remplacez *configurationSetName* par le nom ou l'ARN du jeu de configuration auquel la destination de l'événement est associée.

------

# Configurer la destination d'un événement Amazon Data Firehose dans un SMS destiné aux utilisateurs AWS finaux
<a name="configuration-sets-kinesis"></a>

Amazon Data Firehose est un service entièrement géré qui fournit des données de streaming en temps réel vers plusieurs types de destinations. Amazon Data Firehose fait partie de la plateforme de données de streaming Kinesis. Pour en savoir plus sur Amazon Data Firehose, consultez le manuel du développeur [Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/).

Certains des exemples présentés dans cette section supposent que vous avez déjà installé et configuré le AWS Command Line Interface. Pour plus d'informations sur la configuration du AWS CLI, consultez le [guide de AWS Command Line Interface l'utilisateur](https://docs.aws.amazon.com/cli/latest/userguide/).

**Conditions préalables**

1. Avant de créer une destination d'événement Amazon Data Firehose, vous devez d'abord créer un flux de diffusion Amazon Data Firehose. Pour plus d'informations sur la création de flux, consultez la section [Création d'un flux de livraison Amazon Data Firehose dans le manuel](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) *Amazon Data Firehose* Developer Guide.
**Important**  
Vous aurez besoin du nom de ressource Amazon (ARN) du flux de diffusion Amazon Data Firehose pour créer la destination de l'événement.

1. Vous devez créer un rôle IAM qui permet aux SMS de messagerie de l'utilisateur AWS final d'écrire dans le flux de diffusion, voir[Politique IAM pour Amazon Data Firehose](configuration-sets-kinesis-creating-role.md). 
**Important**  
Vous aurez besoin du nom de ressource Amazon (ARN) du rôle IAM pour créer la destination de l'événement.

1. Vous avez également configuré un ensemble de configuration pour associer les destinations des événements, voir[Création d'un ensemble de configuration dans le SMS de messagerie à l'utilisateur AWS final](configuration-set-create.md).

**Topics**
+ [Politique IAM pour Amazon Data Firehose](configuration-sets-kinesis-creating-role.md)
+ [Création d'une destination d'événement Amazon Data Firehose](configuration-set-kinesis-add.md)
+ [Modifier la destination d'un événement Amazon Data Firehose](configuration-set-kinesis-edit.md)
+ [Supprimer la destination d'un événement Amazon Data Firehose](configuration-set-kinesis-delete.md)

# Politique IAM pour Amazon Data Firehose
<a name="configuration-sets-kinesis-creating-role"></a>

Utilisez l'exemple suivant pour créer une politique d'envoi d'événements vers un flux Amazon Data Firehose.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "firehose:PutRecord",
            "Resource": "arn:aws:firehose:us-east-1:111122223333:deliverystream/DeliveryStreamName"
        }
    ]
}
```

------

Pour des informations sur les politiques IAM, consultez [Politiques et autorisations dans IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) dans le *Guide de l'utilisateur IAM*.

L'exemple d'instruction suivant utilise les `SourceArn` conditions facultatives mais recommandées pour vérifier que seul le compte propriétaire de la messagerie SMS de l'utilisateur AWS final a accès au jeu de configuration. `SourceAccount` Dans cet exemple, remplacez-le *accountId* par votre identifiant de AWS compte, *region* par le Région AWS nom et *ConfigSetName* par le nom du jeu de configuration.

Après avoir créé la politique, créez un nouveau rôle IAM, puis associez-y la politique. Lorsque vous créez le rôle, ajoutez-y également la politique de confiance suivante :

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": {
        "Effect": "Allow",
        "Principal": {
            "Service": "sms-voice.amazonaws.com"
        },
        "Action": "sts:AssumeRole",
        "Condition": {
            "StringEquals": {
            "aws:SourceAccount": "111122223333"
            },
            "ArnLike": {
            "aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
            }
        }
    }
}
```

------

Pour plus d'informations sur la création de rôles IAM, consultez [Création de rôles IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) dans le *Guide de l'utilisateur IAM*.

# Création d'une destination d'événement Amazon Data Firehose dans un SMS destiné aux utilisateurs AWS finaux
<a name="configuration-set-kinesis-add"></a>

Avant de créer une destination d'événement Amazon Data Firehose, vous devez d'abord créer un flux Amazon Data Firehose. Pour plus d'informations sur la création de groupes de journaux, consultez [Creating an Amazon Data Firehose Delivery](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) Stream dans le manuel *Amazon Data Firehose* Developer Guide.

Vous devez créer un rôle IAM qui permet à l'API AWS End User Messaging SMS and Voice v2 d'envoyer des données au flux. La section suivante contient des informations sur les exigences relatives à ce rôle.

Vous avez également déjà configuré un jeu de configuration auquel associer les destinations des événements, consultez [Ensembles de configuration dans les SMS de messagerie destinés aux utilisateurs AWS finaux](configuration-sets.md).

------
#### [ Create Amazon Data Firehose event destination (Console) ]

Pour créer une destination d'événement Amazon Data Firehose à l'aide de la console SMS de messagerie utilisateur AWS final, procédez comme suit :

1. Ouvrez la console SMS de messagerie de l'utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Dans le volet de navigation, sous **Configurations**, sélectionnez **Ensembles de configuration**.

1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration auquel ajouter une destination d'événement. 

1. Sur la page des **détails du jeu de configuration**, choisissez **Ajouter un événement de destination**.

1. Dans la section **Détails de l'événement**, entrez un nom convivial pour le nom de **destination de l'événement**.

1. Dans le menu déroulant **Type de destination**, sélectionnez Amazon Data Firehose.

1. Pour le **rôle IAM arn**, entrez l'ARN du rôle IAM. Pour plus d'informations sur le rôle IAM arn, consultez[Politique IAM pour Amazon Data Firehose](configuration-sets-kinesis-creating-role.md).

1. Pour **Delivery stream arn**, entrez l'ARN du groupe de journaux Amazon Data Firehose auquel transmettre les événements. 

1. Activez la **publication d'événements**.

1. Sous **Types d'événements**, sélectionnez :
   + **Tous les événements SMS (recommandé)** — Choisissez cette option pour envoyer tous les événements SMS répertoriés dans [Types d’événements](configuration-sets-event-types.md) Amazon Data Firehose.
   + **Événements SMS personnalisés** : choisissez des événements SMS spécifiques à envoyer à Amazon Data Firehose. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements SMS**. Lors de la **sélection des événements Edit SMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon Data Firehose. Choisissez **Enregistrer la sélection**.
   + **Tous les événements vocaux (recommandé)** — Choisissez cette option pour envoyer tous les événements [Types d’événements](configuration-sets-event-types.md) vocaux répertoriés dans Amazon Data Firehose.
   + **Événements vocaux personnalisés** : choisissez des événements vocaux spécifiques à envoyer à Amazon Data Firehose. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements vocaux**. Sur **Modifier la sélection des événements vocaux**, cochez uniquement les événements que vous souhaitez envoyer à Amazon Data Firehose. Choisissez **Enregistrer la sélection**.
   + **Tous les événements MMS (recommandé)** — Choisissez cette option pour envoyer tous les événements MMS répertoriés dans [Types d’événements](configuration-sets-event-types.md) Amazon Data Firehose.
   + Événements **MMS personnalisés : choisissez des événements** MMS spécifiques à envoyer à Amazon Data Firehose. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements MMS**. Lors de la **sélection des événements Edit MMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon Data Firehose. Choisissez **Enregistrer la sélection**.

1. Choisissez **Create event (Créer un événement)**.

------
#### [ Create Amazon Data Firehose event destination (AWS CLI) ]

Après avoir créé le rôle IAM et le flux de diffusion Amazon Data Firehose, vous pouvez créer la destination de l'événement.

Vous pouvez utiliser la [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)commande pour créer une destination d'événement.

```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream
```

Dans l’exemple précédent, apportez les modifications suivantes :
+ *eventDestinationName*Remplacez-le par un nom décrivant la destination de l'événement.
+ *configurationSet*Remplacez-le par le nom du jeu de configuration auquel vous souhaitez associer la destination de l'événement.
+ Remplacez *eventTypes* par un ou plusieurs des types d'événements répertoriés dans[Types d'événements pour les SMS, les MMS et les appels vocaux](configuration-sets-event-types.md).
+ Remplacez la valeur de `IamRoleArn` par l'Amazon Resource Name (ARN) d'un rôle IAM dont les politiques sont décrites dans [Politique IAM pour Amazon Data Firehose](configuration-sets-kinesis-creating-role.md).
+ Remplacez la valeur `DeliveryStreamArn` de par l'ARN du flux Amazon Data Firehose auquel vous souhaitez envoyer des événements. 

------

# Modifier la destination d'un événement Amazon Data Firehose dans un SMS destiné aux utilisateurs AWS finaux
<a name="configuration-set-kinesis-edit"></a>

Utilisez la console SMS de messagerie utilisateur AWS final ou AWS CLI pour modifier la destination d'un événement Amazon Data Firehose.

------
#### [ Update Amazon Data Firehose event destination (Console) ]

Pour mettre à jour la destination d'un événement Amazon Data Firehose à l'aide de la console SMS de messagerie utilisateur AWS final, procédez comme suit :

1. Ouvrez la console SMS de messagerie utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Dans le volet de navigation, sous **Configurations**, sélectionnez **Ensembles de configuration**.

1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration auquel ajouter une destination d'événement. 

1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration à modifier. 

1. **Sur la page des **détails de l'ensemble de configuration**, choisissez une destination d'événement Amazon Data Firehose, puis modifiez.**

1. Pour le **rôle IAM arn**, entrez l'ARN du rôle IAM. Pour plus d'informations sur le rôle IAM arn, consultez[Politique IAM pour Amazon Data Firehose](configuration-sets-kinesis-creating-role.md).

1. Pour **Delivery stream arn**, entrez l'ARN du groupe de journaux Amazon Data Firehose auquel transmettre les événements. 

1. Sous **Types d'événements**, sélectionnez :
   + **Tous les événements SMS (recommandé)** — Choisissez cette option pour envoyer tous les événements SMS répertoriés dans [Types d’événements](configuration-sets-event-types.md) Amazon Data Firehose.
   + **Événements SMS personnalisés** — Choisissez cette option pour sélectionner les événements SMS spécifiques auxquels envoyer CloudWatch. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements SMS**. Lors de la **sélection des événements Edit SMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon Data Firehose. Choisissez **Enregistrer la sélection**.
   + **Tous les événements vocaux (recommandé)** — Choisissez cette option pour envoyer tous les événements [Types d’événements](configuration-sets-event-types.md) vocaux répertoriés dans Amazon Data Firehose.
   + **Événements vocaux personnalisés** : choisissez cette option pour sélectionner des événements vocaux spécifiques à envoyer à Amazon Data Firehose. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements vocaux**. Sur **Modifier la sélection des événements vocaux**, cochez uniquement les événements que vous souhaitez envoyer à Amazon Data Firehose. Choisissez **Enregistrer la sélection**.
   + **Tous les événements MMS (recommandé)** — Choisissez cette option pour envoyer tous les événements MMS répertoriés dans [Types d’événements](configuration-sets-event-types.md) Amazon Data Firehose.
   + **Événements MMS personnalisés** — Choisissez cette option pour sélectionner les événements MMS spécifiques auxquels envoyer. CloudWatch Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements MMS**. Lors de la **sélection des événements Edit MMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon Data Firehose. Choisissez **Enregistrer la sélection**.

1. Choisissez **Modifier l'événement**.

------
#### [ Update Amazon Data Firehose event destination (AWS CLI) ]

Vous pouvez utiliser la [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)commande pour mettre à jour la destination d'un événement.

La procédure de mise à jour d'une destination d'événement Amazon Data Firehose est similaire au processus de création d'une destination d'événement.

```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --kinesis-firehose-destination IamRoleArn=arn:aws:iam::111122223333:role/AKFSMSRole,DeliveryStreamArn=arn:aws:firehose:us-east-1:111122223333:deliverystream/MyDeliveryStream
```

Dans l’exemple précédent, apportez les modifications suivantes :
+ *eventDestinationName*Remplacez-le par le nom de la destination de l'événement que vous souhaitez modifier.
+ *configurationSet*Remplacez-le par le nom du jeu de configuration auquel vous souhaitez associer la destination de l'événement. Vous pouvez associer la destination de l'événement à un autre jeu de configuration.
+ *eventTypes*Remplacez-le par l'un des types d'événements répertoriés dans[Types d'événements pour les SMS, les MMS et les appels vocaux](configuration-sets-event-types.md).
+ Remplacez la valeur de `IamRoleArn` par l'Amazon Resource Name (ARN) d'un rôle IAM dont les politiques sont décrites dans [Politique IAM pour Amazon Data Firehose](configuration-sets-kinesis-creating-role.md).
+ Remplacez la valeur `DeliveryStreamArn` de par l'ARN du flux Amazon Data Firehose auquel vous souhaitez envoyer des événements. 

------

# Supprimer la destination d'un événement Amazon Data Firehose dans un SMS destiné aux utilisateurs AWS finaux
<a name="configuration-set-kinesis-delete"></a>

Utilisez la console SMS de messagerie utilisateur AWS final ou AWS CLI pour supprimer une destination d'événement Amazon Data Firehose.

------
#### [ Delete an Amazon Data Firehose event destination (Console) ]

Le processus de suppression d'une destination d'événement est le même quel que soit le type de destination d'événement que vous souhaitez supprimer.

**Pour supprimer la destination d'un événement Amazon Data Firehose dans la console**

1. Ouvrez la console SMS de messagerie utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Dans le volet de navigation, sous **Configurations**, sélectionnez **Ensembles de configuration**.

1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration dont vous souhaitez supprimer une destination d'événement. 

1. Dans la section **Toutes les destinations**, choisissez une destination d'événement, puis cliquez **sur Supprimer**.

------
#### [ Delete an Amazon Data Firehose event destination (AWS CLI) ]

Vous pouvez utiliser la [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)commande pour supprimer la destination d'un événement.

Le processus de suppression d'une destination d'événement est le même quel que soit le type de destination d'événement que vous souhaitez supprimer.

**Pour supprimer la destination d'un événement Amazon Data Firehose dans le AWS CLI**
+ Dans la ligne de commande, exécutez la commande suivante :

  ```
  $ aws pinpoint-sms-voice-v2 delete-event-destination \
  > --event-destination-name eventDestinationName \
  > --configuration-set-name configurationSetName
  ```

  Dans l’exemple précédent, apportez les modifications suivantes :
  + *eventDestinationName*Remplacez-le par le nom ou le Amazon Resource Name (ARN) de la destination de l'événement que vous souhaitez supprimer.
  + Remplacez *configurationSetName* par le nom ou l'ARN du jeu de configuration auquel la destination de l'événement est associée.

------

# Configuration d'une destination d'événement Amazon SNS dans les SMS de messagerie destinés aux utilisateurs AWS finaux
<a name="configuration-sets-sns"></a>

Amazon Simple Notification Service (Amazon SNS) est un service web qui permet aux applications, utilisateurs finaux et appareils d’envoyer et de recevoir instantanément des notifications. Pour en savoir plus sur Amazon SNS, consultez le [Guide du développeur d'Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/).

Certains des exemples présentés dans cette section supposent que vous avez déjà installé et configuré le AWS Command Line Interface. Pour plus d'informations sur la configuration du AWS CLI, consultez le [guide de AWS Command Line Interface l'utilisateur](https://docs.aws.amazon.com/cli/latest/userguide/).

**Topics**
+ [Politique d'accès Amazon SNS](configuration-sets-sns-creating-role.md)
+ [Création d'une destination d'événement Amazon SNS](configuration-sets-sns-add.md)
+ [Modifier la destination d'un événement Amazon SNS](configuration-sets-sns-edit.md)
+ [Supprimer la destination d'un événement Amazon SNS](configuration-sets-sns-delete.md)

# Politique d'accès Amazon SNS
<a name="configuration-sets-sns-creating-role"></a>

*L'accès à une rubrique Amazon SNS est contrôlé par une *politique de ressources* attachée à la rubrique Amazon SNS, également appelée politique d'accès.* Pour plus d'informations sur les *politiques d'accès* Amazon SNS, consultez la section [Gestion des identités et des accès](https://docs.aws.amazon.com/sns/latest/dg/security-iam.html) dans le manuel *Amazon SNS Developer Guide*. 

**Note**  
Si le chiffrement côté serveur est activé dans votre rubrique Amazon SNS, AWS Key Management Service ajoutez également la politique à la clé de chiffrement [symétrique](#configuration-sets-sns-creating-role-encrypted) gérée par le client associée.

Mettez à jour la *politique d'accès* avec la déclaration suivante pour autoriser AWS la publication de SMS destinés aux utilisateurs finaux sur la rubrique Amazon SNS.
+ *111122223333*Remplacez-le par l'identifiant unique de votre AWS compte.
+ Remplacez *TopicName* par le nom de la rubrique Amazon SNS.
+ *Region*Remplacez-le par le Région AWS qui contient le sujet Amazon SNS et le jeu de configuration.
+ Remplacez *ConfigSetName* par le nom du jeu de configuration.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": "sns:Publish",
            "Resource": "arn:aws:sns:us-east-1:111122223333:TopicName",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "accountId"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
                }
            }
        }
    ]
}
```

------

## Politique d'accès aux rubriques Amazon SNS chiffrées
<a name="configuration-sets-sns-creating-role-encrypted"></a>

Si le chiffrement côté serveur est activé dans votre rubrique Amazon SNS AWS Key Management Service, ajoutez la politique suivante à la clé de chiffrement symétrique gérée par le client associée. Vous devez ajouter la politique à une clé gérée par le client car vous ne pouvez pas modifier la clé AWS gérée pour Amazon SNS. 

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Id": "example-ID",
    "Statement": [
        {
            "Sid": "example-statement-ID",
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": [
                "kms:GenerateDataKey",
                "kms:Decrypt"
            ],
            "Resource": "*"
        }
    ]
}
```

------

# Création d'une destination d'événement Amazon SNS dans les SMS de messagerie destinés aux utilisateurs AWS finaux
<a name="configuration-sets-sns-add"></a>

Avant de créer une destination d'événement Amazon SNS, vous devez d'abord créer une rubrique Amazon SNS. Pour plus d'informations sur la création de rubriques Amazon SNS, consultez la section [Création d'une rubrique](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) dans le manuel *Amazon Simple Notification Service Developer Guide*.

Vous devez également avoir déjà configuré un ensemble de configuration auquel associer les destinations des événements, voir[Ensembles de configuration dans les SMS de messagerie destinés aux utilisateurs AWS finaux](configuration-sets.md).

------
#### [ Create an Amazon SNS event destination (Console) ]

Pour créer une destination d'événement Amazon SNS à l'aide de la console SMS de messagerie utilisateur AWS final, procédez comme suit :

1. Ouvrez la console SMS de messagerie de l'utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Dans le volet de navigation, sous **Configurations**, sélectionnez **Ensembles de configuration**.

1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration auquel ajouter une destination d'événement. 

1. Sur la page des **détails du jeu de configuration**, choisissez **Ajouter un événement de destination**.

1. Dans la section **Détails de l'événement**, entrez un nom.

1. Dans le menu déroulant **Type de destination**, sélectionnez Amazon SNS.

   1. **Nouvelle rubrique Amazon SNS** — Choisissez cette option pour que l'utilisateur AWS final envoie des SMS afin de créer un sujet dans votre compte. La rubrique est automatiquement créée avec toutes les autorisations requises. Pour plus d'informations sur les sujets relatifs à Amazon SNS, consultez la [section Configuration d'Amazon SNS dans le manuel Amazon](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) [Simple Notification](https://docs.aws.amazon.com/sns/latest/dg/) Service Developer Guide.

   1. **Rubrique Amazon SNS existante** : choisissez cette option si vous avez déjà une rubrique Amazon SNS dans **le** menu déroulant Rubrique.

1. Sous **Types d'événements**, sélectionnez :
   + **Tous les événements SMS (recommandé)** — Choisissez cette option pour envoyer tous les événements SMS répertoriés sur Amazon SNS. [Types d’événements](configuration-sets-event-types.md)
   + **Événements SMS personnalisés** : choisissez des événements SMS spécifiques à envoyer à Amazon SNS. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements SMS**. Lors de la **sélection des événements Edit SMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon SNS. Choisissez **Enregistrer la sélection**.
   + **Tous les événements vocaux (recommandé)** : choisissez cette option pour envoyer tous les événements [Types d’événements](configuration-sets-event-types.md) vocaux répertoriés sur Amazon SNS.
   + **Événements vocaux personnalisés** : choisissez parmi les événements vocaux spécifiques à envoyer à Amazon SNS. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements vocaux**. Sur **Modifier la sélection des événements vocaux**, cochez uniquement les événements que vous souhaitez envoyer à Amazon SNS. Choisissez **Enregistrer la sélection**.
   + **Tous les événements MMS (recommandé)** : choisissez cette option pour envoyer tous les événements MMS répertoriés sur Amazon SNS. [Types d’événements](configuration-sets-event-types.md)
   + Événements **MMS personnalisés : choisissez des événements** MMS spécifiques à envoyer à Amazon SNS. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements MMS**. Lors de la **sélection des événements Edit MMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon SNS. Choisissez **Enregistrer la sélection**.

1. Choisissez **Create event (Créer un événement)**.

------
#### [ Create an Amazon SNS event destination (AWS CLI) ]

Vous pouvez utiliser la [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)commande pour créer une destination d'événement.

```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic
```

Dans l’exemple précédent, apportez les modifications suivantes :
+ *eventDestinationName*Remplacez-le par un nom descriptif pour la destination de l'événement.
+ *configurationSet*Remplacez-le par le nom du jeu de configuration auquel vous souhaitez associer la destination de l'événement.
+ *eventTypes*Remplacez-le par l'un des types d'événements répertoriés dans[Types d'événements pour les SMS, les MMS et les appels vocaux](configuration-sets-event-types.md).
+ Remplacez la valeur de `TopicArn` par l'Amazon Resource Name (ARN) de la rubrique Amazon SNS à laquelle vous souhaitez envoyer des événements.

------

# Modifier la destination d'un événement Amazon SNS dans un SMS de messagerie à l'utilisateur AWS final
<a name="configuration-sets-sns-edit"></a>

Utilisez la console SMS de messagerie utilisateur AWS final ou AWS CLI pour modifier la destination d'un événement Amazon SNS.

------
#### [ Update an Amazon SNS event destination (Console) ]

Pour mettre à jour AWS la destination d'un événement de messagerie SMS à l'utilisateur AWS final à l'aide de la console SMS de messagerie utilisateur final, procédez comme suit :

1. Ouvrez la console SMS de messagerie utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Dans le volet de navigation, sous **Configurations**, sélectionnez **Ensembles de configuration**.

1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration auquel ajouter une destination d'événement. 

1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration à modifier. 

1. **Sur la page des **détails de l'ensemble de configuration**, choisissez une destination d'événement Amazon SNS, puis Modifier.**

1. Dans le menu déroulant **Type de destination**, sélectionnez Amazon SNS.

   1. **Nouvelle rubrique Amazon SNS** — Choisissez cette option, les SMS destinés aux utilisateurs AWS finaux créent un sujet dans votre compte. La rubrique est automatiquement créée avec toutes les autorisations requises. Pour plus d'informations sur les sujets relatifs à Amazon SNS, consultez la [section Configuration d'Amazon SNS dans le manuel Amazon](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) [Simple Notification](https://docs.aws.amazon.com/sns/latest/dg/) Service Developer Guide.

   1. **Rubrique Amazon SNS existante** : choisissez cette option si vous avez déjà une rubrique Amazon SNS dans **le** menu déroulant Rubrique.

1. Sous **Types d'événements**, sélectionnez :
   + **Tous les événements SMS (recommandé)** — Choisissez cette option pour envoyer tous les événements SMS répertoriés sur Amazon SNS. [Types d’événements](configuration-sets-event-types.md)
   + **Événements SMS personnalisés** : choisissez cette option pour sélectionner des événements SMS spécifiques à envoyer à Amazon SNS. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements SMS**. Lors de la **sélection des événements Edit SMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon SNS. Choisissez **Enregistrer la sélection**.
   + **Tous les événements vocaux (recommandé)** : choisissez cette option pour envoyer tous les événements [Types d’événements](configuration-sets-event-types.md) vocaux répertoriés sur Amazon SNS.
   + **Événements vocaux personnalisés** : choisissez cette option pour sélectionner des événements vocaux spécifiques à envoyer à Amazon SNS. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements vocaux**. Sur **Modifier la sélection des événements vocaux**, cochez uniquement les événements que vous souhaitez envoyer à Amazon SNS. Choisissez **Enregistrer la sélection**.
   + **Tous les événements MMS (recommandé)** : choisissez cette option pour envoyer tous les événements MMS répertoriés sur Amazon SNS. [Types d’événements](configuration-sets-event-types.md)
   + **Événements MMS personnalisés** : choisissez cette option pour sélectionner des événements MMS spécifiques à envoyer à Amazon SNS. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements MMS**. Lors de la **sélection des événements Edit MMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon SNS. Choisissez **Enregistrer la sélection**.

1. Choisissez **Modifier l'événement**.

------
#### [ Update an Amazon SNS event destination (AWS CLI) ]

Vous pouvez utiliser la [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)commande pour mettre à jour la destination d'un événement.

La procédure de mise à jour d'une destination d'événement Amazon SNS est similaire au processus de création d'une destination d'événement.

**Pour mettre à jour la destination d'un événement Amazon SNS dans le AWS CLI**
+ Dans la ligne de commande, exécutez la commande suivante :

  ```
  $ aws pinpoint-sms-voice-v2 update-event-destination \
  > --event-destination-name eventDestinationName \
  > --configuration-set-name configurationSet \
  > --matching-event types eventTypes \
  > --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic
  ```

  Dans l’exemple précédent, apportez les modifications suivantes :
  + *eventDestinationName*Remplacez-le par le nom de la destination de l'événement que vous souhaitez modifier.
  + *configurationSet*Remplacez-le par le nom du jeu de configuration auquel vous souhaitez associer la destination de l'événement. Vous pouvez associer la destination de l'événement à un autre jeu de configuration.
  + Remplacez *eventTypes* par un ou plusieurs des types d'événements répertoriés dans[Types d'événements pour les SMS, les MMS et les appels vocaux](configuration-sets-event-types.md).
  + Remplacez la valeur de `TopicArn` par l'Amazon Resource Name (ARN) de la rubrique Amazon SNS à laquelle vous souhaitez envoyer des événements.

------

# Supprimer la destination d'un événement Amazon SNS dans un SMS de messagerie à l'utilisateur AWS final
<a name="configuration-sets-sns-delete"></a>

Utilisez la console SMS de messagerie utilisateur AWS final ou AWS CLI pour supprimer une rubrique Amazon SNS.

------
#### [ Delete an Amazon SNS event destination (Console) ]

Le processus de suppression d'une destination d'événement est le même quel que soit le type de destination d'événement que vous souhaitez supprimer.

**Pour supprimer la destination d'un événement Amazon SNS dans la console**

1. Ouvrez la console SMS de messagerie de l'utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Dans le volet de navigation, sous **Configurations**, sélectionnez **Ensembles de configuration**.

1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration dont vous souhaitez supprimer une destination d'événement. 

1. Dans la section **Toutes les destinations**, choisissez une destination d'événement, puis cliquez **sur Supprimer**.

------
#### [ Delete an Amazon SNS event destination (AWS CLI) ]

Vous pouvez utiliser la [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)commande pour supprimer la destination d'un événement.

Le processus de suppression d'une destination d'événement est le même quel que soit le type de destination d'événement que vous souhaitez supprimer.

**Pour supprimer la destination d'un événement Amazon SNS dans AWS CLI**
+ Dans la ligne de commande, exécutez la commande suivante :

  ```
  $ aws pinpoint-sms-voice-v2 delete-event-destination \
  > --event-destination-name eventDestinationName \
  > --configuration-set-name configurationSetName
  ```

  Dans l’exemple précédent, apportez les modifications suivantes :
  + *eventDestinationName*Remplacez-le par le nom ou le Amazon Resource Name (ARN) de la destination de l'événement que vous souhaitez supprimer.
  + Remplacez *configurationSetName* par le nom ou l'ARN du jeu de configuration auquel la destination de l'événement est associée.

------