

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Risposta a un messaggio in AWS End User Messaging Social
<a name="whatsapp-receive-message"></a>

Prima di poter ricevere un SMS o un messaggio multimediale, devi aver impostato il tuo account WhatsApp aziendale (WABA) e una destinazione per l'evento. Quando ricevi un messaggio in arrivo, un evento viene salvato nell'argomento Amazon SNS sulla destinazione dell'evento. Per ricevere una notifica, devi abbonarti all'endpoint per argomenti Amazon SNS.

Per un esempio di evento relativo a un messaggio multimediale ricevuto, consulta. [Esempio WhatsApp JSON per la ricezione di un messaggio multimediale](managing-event-destination-dlrs.md#managing-event-destination-dlrs-example-receive-media) Per ulteriori informazioni sulla configurazione di AWS CLI, vedere [Configurare the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) nella *[Guida per l'AWS Command Line Interface utente](https://docs.aws.amazon.com/cli/latest/userguide/)*. Per un elenco dei tipi di file multimediali supportati, vedere[Tipi e dimensioni di file multimediali supportati in WhatsAppTipi di file multimediali supportati](supported-media-types.md).

**Importante**  
Per ricevere messaggi in arrivo, è necessario che le [destinazioni degli eventi](managing-event-destinations-add.md) siano abilitate per il WABA. Per ulteriori informazioni, consulta [Aggiungi un messaggio e una destinazione di eventi a AWS End User Messaging Social](managing-event-destinations-add.md).

# Esempio di modifica dello stato di un messaggio da leggere in AWS End User Messaging Social
<a name="receive-message-status"></a>

È possibile impostare lo [stato del messaggio](managing-event-destinations-status.md) in modo da mostrare `read` all'utente finale due segni di spunta blu sullo schermo. 

```
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    
```

Nel comando precedente, procedi come segue.
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sostituiscilo con l'ID del tuo numero di telefono.
+ Sostituisci *\$1MESSAGE\$1ID\$1* con l'identificatore univoco del messaggio. Utilizza il valore del `id` campo nell'oggetto messaggio dell'argomento Amazon SNS.

# Esempio di risposta a un messaggio con una reazione in AWS End User Messaging Social
<a name="receive-message-emoji"></a>

Puoi aggiungere una reazione al messaggio, ad esempio un pollice in alto. 

```
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
```

Nel comando precedente, procedi come segue.
+ *\$1PHONE\$1NUMBER\$1*Sostituiscilo con il numero di telefono del cliente.
+ Sostituiscilo *\$1MESSAGE\$1ID\$1* con l'identificatore univoco del messaggio. Utilizza il valore del `id` campo nell'oggetto messaggio dell'argomento Amazon SNS.
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sostituiscilo con l'ID del tuo numero di telefono.

# Scarica un file multimediale WhatsApp da Amazon S3
<a name="receive-message-image"></a>

Per recuperare un file multimediale e salvarlo in un bucket Amazon S3, usa il comando. [get-whatsapp-message-media](https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/get-whatsapp-message-media.html)

```
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
}
```

Nel comando precedente, procedi come segue.
+ Sostituisci *\$1BUCKET\$1* con il nome del bucket Amazon S3.
+ Sostituisci *\$1MEDIA\$1ID\$1* con il valore del `id` campo dell'evento ricevuto. Per un esempio di evento multimediale in arrivo, vedi[Esempio WhatsApp JSON per la ricezione di un messaggio multimediale](managing-event-destination-dlrs.md#managing-event-destination-dlrs-example-receive-media).
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sostituiscilo con l'ID del tuo numero di telefono.

Per recuperare i file multimediali dal bucket Amazon S3, usa il seguente comando:

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

Nel comando precedente, procedi come segue.
+ Sostituisci *\$1BUCKET\$1* con il nome del bucket Amazon S3.
+ Sostituisci *\$1MEDIA\$1ID\$1* con il MEDIA\$1ID restituito dal passaggio precedente. 

# Esempio di risposta a un messaggio con una conferma di lettura e una reazione
<a name="example-response"></a>

In questo esempio, il tuo cliente Diego ti ha inviato un messaggio dicendo «Ciao» e tu gli rispondi con una ricevuta di lettura e un'emoji agitata con la mano. 

## Prerequisiti
<a name="example-response_prerequisite"></a>

Per ricevere una notifica relativa all'invio di un messaggio da parte di Diego, devi aver impostato un argomento Amazon SNS per la destinazione dell'evento e aver sottoscritto un endpoint di argomento.

## Rispondere
<a name="example-response_steps"></a>

1. Quando viene ricevuto il messaggio di Diego, viene pubblicato un evento nelle estremità dell'argomento. Quello che segue è un frammento di ciò che l'argomento pubblica.
**Nota**  
Poiché Diego ha avviato la conversazione, questa non viene conteggiata nella quota delle conversazioni avviate dalla tua azienda.  
`whatsAppWebhookEntry`In questo esempio è mostrato in notazione JSON. Per un esempio di conversione della stringa `whatsAppWebhookEntry` da JSON a JSON, vedi. [Esempio WhatsApp JSON per la ricezione di un messaggio](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. Per mostrare a Diego che hai ricevuto il messaggio, imposta lo stato su. `read` Diego vedrà due segni di spunta blu accanto al messaggio sul suo dispositivo.
**Nota**  
È necessario specificare la codifica base64 quando si utilizza la AWS CLI versione 2. Questo può essere fatto aggiungendo il AWS CLI parametro `--cli-binary-format raw-in-base64-out` o modificando il file di configurazione globale. AWS CLI Per ulteriori informazioni, consultate la *Guida per l'utente dell'interfaccia [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)a riga di AWS comando per la versione 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    
   ```

   Nel comando precedente, procedi come segue.
   + Sostituiscilo *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1* con il numero di telefono ID a cui Diego ha inviato il messaggio`phone-number-id-976c72a700aac43eaf573ae050example`.
   + Sostituisci *\$1MESSAGE\$1ID\$1* con l'identificatore univoco del messaggio. È lo stesso valore del `id` campo nel messaggio `wamid.HBgLMTQyNTY5ODgzMDIVAgASGCBDNzBDRjM5MDU2ODEwMDkwREY4ODBDRDE0RjVGRkexample` ricevuto.

1. Puoi inviare a Diego una reazione con la mano.

   ```
   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
   ```

   Nel comando precedente, procedi come segue.
   + Sostituisci *\$1PHONE\$1NUMBER\$1* con il numero di telefono di Diego,`14255550150`.
   + Sostituisci *\$1MESSAGE\$1ID\$1* con l'identificatore univoco del messaggio. È lo stesso valore del `id` campo nel messaggio `wamid.HBgLMTQyNTY5ODgzMDIVAgASGCBDNzBDRjM5MDU2ODEwMDkwREY4ODBDRDE0RjVGRkexample` ricevuto.
   + Sostituisci *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1* con il numero di telefono ID a cui Diego ha inviato il suo messaggio:`phone-number-id-976c72a700aac43eaf573ae050example`.

## Risorse aggiuntive
<a name="example-response_additional_resources"></a>
+ Abilita [le destinazioni degli eventi](managing-event-destinations.md) per registrare gli eventi e ricevere messaggi in arrivo.
+ Per un elenco degli oggetti dei WhatsApp [messaggi, consulta Messages](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/messages#message-object) in the *WhatsApp Business Platform Cloud API Reference.*