

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.

# Répondre à un message dans AWS End User Messaging Social
<a name="whatsapp-receive-message"></a>

Avant de pouvoir recevoir un SMS ou un message multimédia, vous devez avoir configuré votre compte WhatsApp professionnel (WABA) et une destination pour l'événement. Lorsque vous recevez un message entrant, un événement est enregistré dans la rubrique Amazon SNS de destination de l'événement. Pour recevoir une notification, vous devez vous abonner au point de terminaison des rubriques Amazon SNS.

Pour un exemple d'événement lié à la réception d'un message multimédia, voir[Exemple de WhatsApp JSON pour recevoir un message multimédia](managing-event-destination-dlrs.md#managing-event-destination-dlrs-example-receive-media). Pour plus d'informations sur la configuration du AWS CLI, voir [Configurer le AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) dans le *[guide de AWS Command Line Interface l'utilisateur](https://docs.aws.amazon.com/cli/latest/userguide/)*. Pour obtenir la liste des types de fichiers multimédia pris en charge, consultez[Types et tailles de fichiers multimédia pris en charge dans WhatsAppTypes de fichiers multimédia pris en charge](supported-media-types.md).

**Important**  
Pour recevoir des messages entrants, vous devez activer les [destinations d'événements](managing-event-destinations-add.md) pour la WABA. Pour de plus amples informations, veuillez consulter [Ajouter un message et une destination d'événement à AWS End User Messaging Social](managing-event-destinations-add.md).

# Exemple de modification du statut d'un message pour qu'il soit lu dans AWS End User Messaging Social
<a name="receive-message-status"></a>

Vous pouvez définir le [statut du message de manière](managing-event-destinations-status.md) `read` à ce que l'utilisateur final affiche deux coches bleues sur son écran. 

```
aws socialmessaging send-whatsapp-message --message '{"messaging_product":"whatsapp","message_id":"'{MESSAGE_ID}'","status":"read"}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0    
```

Dans la commande précédente, procédez comme suit :
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Remplacez-le par l'identifiant de votre numéro de téléphone.
+ Remplacez *\$1MESSAGE\$1ID\$1* par l'identifiant unique du message. Utilisez la valeur du `id` champ dans l'objet du message de la rubrique Amazon SNS.

# Exemple de réponse à un message avec réaction dans AWS End User Messaging Social
<a name="receive-message-emoji"></a>

Vous pouvez ajouter une réaction au message, comme un pouce levé. 

```
aws socialmessaging send-whatsapp-message --message '{"messaging_product":"whatsapp","recipient_type":"individual","to":"'{PHONE_NUMBER}'","type": "reaction","reaction": {"message_id": "'{MESSAGE_ID}'","emoji":"\uD83D\uDC4D"}}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0
```

Dans la commande précédente, procédez comme suit :
+ Remplacez *\$1PHONE\$1NUMBER\$1* par le numéro de téléphone de votre client.
+ Remplacez *\$1MESSAGE\$1ID\$1* par l'identifiant unique du message. Utilisez la valeur du `id` champ dans l'objet du message de la rubrique Amazon SNS.
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Remplacez-le par l'identifiant de votre numéro de téléphone.

# Télécharger un fichier multimédia depuis WhatsApp Amazon S3
<a name="receive-message-image"></a>

Pour récupérer un fichier multimédia et l'enregistrer dans un compartiment Amazon S3, utilisez la [get-whatsapp-message-media](https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/get-whatsapp-message-media.html)commande.

```
aws socialmessaging get-whatsapp-message-media --media-id {MEDIA_ID} --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --destination-s3-file bucketName={BUCKET},key=inbound_
{
    "mimeType": "image/jpeg",
    "fileSize": 78144
}
```

Dans la commande précédente, procédez comme suit :
+ Remplacez *\$1BUCKET\$1* par le nom du compartiment Amazon S3.
+ Remplacez *\$1MEDIA\$1ID\$1* par la valeur du `id` champ de l'événement reçu. Pour un exemple d'événement multimédia entrant, voir[Exemple de WhatsApp JSON pour recevoir un message multimédia](managing-event-destination-dlrs.md#managing-event-destination-dlrs-example-receive-media).
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Remplacez-le par l'identifiant de votre numéro de téléphone.

Pour récupérer le contenu multimédia du compartiment Amazon S3, utilisez la commande suivante :

```
aws s3 cp s3://{BUCKET}/inbound_{MEDIA_ID}.jpeg
```

Dans la commande précédente, procédez comme suit :
+ Remplacez *\$1BUCKET\$1* par le nom du compartiment Amazon S3.
+ Remplacez *\$1MEDIA\$1ID\$1* par le MEDIA\$1ID renvoyé à l'étape précédente. 

# Exemple de réponse à un message avec accusé de lecture et réaction
<a name="example-response"></a>

Dans cet exemple, votre client, Diego, vous a envoyé un message disant « Bonjour » et vous lui répondez avec un accusé de réception et un emoji. 

## Conditions préalables
<a name="example-response_prerequisite"></a>

Pour recevoir une notification indiquant que Diego a envoyé un message, vous devez avoir configuré une rubrique Amazon SNS destinée à l'événement et vous être abonné à un point de terminaison de rubrique.

## Répondant
<a name="example-response_steps"></a>

1. Lorsque le message de Diego est reçu, un événement est publié sur les points de terminaison du sujet. Ce qui suit est un extrait de ce que le sujet publie.
**Note**  
Comme Diego a lancé la conversation, cela n'est pas pris en compte dans le quota de conversations initiées par votre entreprise.  
`whatsAppWebhookEntry`Dans cet exemple, il est présenté en notation JSON. Pour un exemple de conversion de la `whatsAppWebhookEntry` chaîne from JSON en JSON, consultez[Exemple de WhatsApp JSON pour recevoir un message](managing-event-destination-dlrs.md#managing-event-destination-dlrs-example-receive-text).

   ```
   {
     "context": {
       "MetaWabaIds": [
         {
           "wabaId": "1234567890abcde",
           "arn": "arn:aws:social-messaging:us-east-1:123456789012:waba/fb2594b8a7974770b128a409e2example"
         }
       ],
       "MetaPhoneNumberIds": [
         {
           "metaPhoneNumberId": "abcde1234567890",
           "arn": "arn:aws:social-messaging:us-east-1:123456789012:phone-number-id/976c72a700aac43eaf573ae050example"
         }
       ]
     },
     "whatsAppWebhookEntry": "{\"...JSON STRING....",
     "aws_account_id": "123456789012",
     "message_timestamp": "2025-01-08T23:30:43.271279391Z"
   }
   //Decoding the contents of whatsAppWebhookEntry
   {
     "id": "365731266123456",
     "changes": [
       {
         "value": {
           "messaging_product": "whatsapp",
           "metadata": {
             "display_phone_number": "12065550100",
             "phone_number_id": "321010217712345"
           },
           "contacts": [
             {
               "profile": {
                 "name": "Diego"
               },
               "wa_id": "12065550102"
             }
           ],
           "messages": [
             {
               "from": "14255550150",
               "id": "wamid.HBgLMTQyNTY5ODgzMDIVAgASGCBDNzBDRjM5MDU2ODEwMDkwREY4ODBDRDE0RjVGRkexample",
               "timestamp": "1723506035",
               "text": {
                 "body": "Hi"
               },
               "type": "text"
             }
           ]
         },
         "field": "messages"
       }
     ]
   }
   ```

1. Pour montrer à Diego que vous avez reçu le message, réglez le statut sur`read`. Diego verra deux coches bleues à côté du message sur son appareil.
**Note**  
Vous devez spécifier le codage base64 lorsque vous utilisez la AWS CLI version 2. Cela peut être fait en ajoutant le AWS CLI paramètre `--cli-binary-format raw-in-base64-out` ou en modifiant le fichier de configuration AWS CLI global. Pour plus d'informations, consultez le *Guide [https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-settings](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-settings)de l'utilisateur de l'interface de ligne de AWS commande pour la version 2*.

   ```
   aws socialmessaging send-whatsapp-message --message '{"messaging_product":"whatsapp","message_id":"'{MESSAGE_ID}'","status":"read"}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0    
   ```

   Dans la commande précédente, procédez comme suit :
   + Remplacez *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1* par le numéro de téléphone auquel Diego a envoyé son message`phone-number-id-976c72a700aac43eaf573ae050example`.
   + Remplacez *\$1MESSAGE\$1ID\$1* par l'identifiant unique du message. Il s'agit de la même valeur que celle du `id` champ dans le message reçu`wamid.HBgLMTQyNTY5ODgzMDIVAgASGCBDNzBDRjM5MDU2ODEwMDkwREY4ODBDRDE0RjVGRkexample`.

1. Tu peux envoyer une réaction de la main à Diego.

   ```
   aws socialmessaging send-whatsapp-message --message '{"messaging_product":"whatsapp","recipient_type":"individual","to":"'{PHONE_NUMBER}'","type": "reaction","reaction": {"message_id": "'{MESSAGE_ID}'","emoji":"\uD83D\uDC4B"}}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0
   ```

   Dans la commande précédente, procédez comme suit :
   + Remplacer *\$1PHONE\$1NUMBER\$1* par le numéro de téléphone de Diego,`14255550150`.
   + Remplacez *\$1MESSAGE\$1ID\$1* par l'identifiant unique du message. Il s'agit de la même valeur que celle du `id` champ dans le message reçu`wamid.HBgLMTQyNTY5ODgzMDIVAgASGCBDNzBDRjM5MDU2ODEwMDkwREY4ODBDRDE0RjVGRkexample`.
   + Remplacez *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1* par le numéro de téléphone auquel Diego a envoyé son message :`phone-number-id-976c72a700aac43eaf573ae050example`.

## Ressources supplémentaires
<a name="example-response_additional_resources"></a>
+ Activez les [destinations des événements](managing-event-destinations.md) pour enregistrer les événements et recevoir les messages entrants.
+ Pour obtenir la liste des objets de WhatsApp message, consultez la section [Messages](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/messages#message-object) dans le manuel de *référence de l'API WhatsApp Business Platform Cloud*.