

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à.

# Invio di messaggi WhatsApp tramite AWS End User Messaging Social
<a name="whatsapp-send-message"></a>

Prima di inviare un messaggio, devi configurare il tuo account WhatsApp aziendale (WABA) e l'utente deve attivare la ricezione di messaggi da te. Per ulteriori informazioni, consulta [Acquisizione dell’autorizzazione](whatsapp-best-practices.md#best-practices-whatsapp-obtain-permission). 

Quando un utente ti invia un messaggio, si avvia o si aggiorna un timer di 24 ore chiamato finestra del servizio clienti. Tutti i tipi di messaggi, ad eccezione dei messaggi modello, possono essere inviati solo quando è aperta una finestra del servizio clienti tra te e l'utente. I messaggi modello possono essere inviati in qualsiasi momento, purché l'utente abbia scelto di ricevere messaggi da te.

Per ogni messaggio inviato o ricevuto, viene generato uno stato del messaggio che viene inviato alla destinazione dell'evento. Se il cliente non si è registrato WhatsApp, viene generato un evento con lo stato del messaggio pari a`fail`. È necessario attivare un [messaggio e la destinazione dell'evento](managing-event-destinations.md) per ricevere lo [stato del messaggio](managing-event-destinations-status.md).

Per un elenco dei tipi di [messaggi, consulta Messages](https://developers.facebook.com/docs/whatsapp/conversation-types/) in the *WhatsApp Business Platform Cloud API Reference*. 

**Importante**  
L'utilizzo della WhatsApp Business Solution è soggetto ai termini e alle condizioni dei Termini di [servizio WhatsApp aziendali, dei Termini della WhatsApp](https://www.whatsapp.com/legal/business-terms) [Business Solution](https://www.whatsapp.com/legal/business-solution-terms), della [Politica sulla messaggistica WhatsApp aziendale](https://business.whatsapp.com/policy), delle [Linee guida sulla WhatsApp messaggistica](https://www.whatsapp.com/legal/messaging-guidelines) e a tutti gli altri termini, politiche o linee guida ivi inclusi come riferimento. Questi potrebbero essere aggiornati di tanto in tanto. 
Meta or WhatsApp può vietare in qualsiasi momento l'uso della WhatsApp Business Solution.
In relazione all'utilizzo della WhatsApp Business Solution, l'utente non invierà alcun contenuto, informazione o dato soggetto a salvaguardia o limitazioni alla distribuzione ai sensi delle leggi o dei regolamenti applicabili.

**Topics**
+ [Esempio di invio di un messaggio modello in AWS End User Messaging Social](send-message-text.md)
+ [Esempio di invio di un messaggio multimediale in AWS End User Messaging Social](send-message-media.md)

# Esempio di invio di un messaggio modello in AWS End User Messaging Social
<a name="send-message-text"></a>

Per ulteriori informazioni sui tipi di modelli di messaggio che possono essere inviati, consulta [Modello di messaggio nel documento WhatsApp ](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates) *Business Platform Cloud API Reference*. Per un elenco dei tipi di messaggi che possono essere inviati, consulta [Messaggi](https://developers.facebook.com/docs/whatsapp/conversation-types/) nel *riferimento all'API di WhatsApp Business Platform Cloud*. 

L'esempio seguente mostra come utilizzare un modello per [inviare un messaggio](https://docs.aws.amazon.com//social-messaging/latest/APIReference/API_SendWhatsAppMessage.html) al cliente utilizzando il AWS CLI. Per ulteriori informazioni sulla configurazione di AWS CLI, vedere [Configure 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/).

**Nota**  
È necessario specificare la codifica base64 quando si utilizza la versione 2. AWS CLI 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","to":"'{PHONE_NUMBER}'","type":"template","template":{"name":"statement","language":{"code":"en_US"},"components":[{"type":"body","parameters":[{"type":"text","text":"1000"}]}]}}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0
```

Nel comando precedente, procedi come segue.
+ Sostituiscilo *\$1PHONE\$1NUMBER\$1* con il numero di telefono del cliente.
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sostituiscilo con l'ID del tuo numero di telefono.

L'esempio seguente mostra come inviare un messaggio modello che non contiene alcun componente.

```
aws socialmessaging send-whatsapp-message --message '{"messaging_product": "whatsapp","to": "'{PHONE_NUMBER}'","type": "template","template": {"name":"simple_template","language": {"code": "en_US"}}}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0
```
+ Sostituiscilo *\$1PHONE\$1NUMBER\$1* con il numero di telefono del cliente.
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sostituiscilo con l'ID del tuo numero di telefono.

# Esempio di invio di un messaggio multimediale in AWS End User Messaging Social
<a name="send-message-media"></a>

L'esempio seguente mostra come inviare un messaggio multimediale al cliente utilizzando il AWS CLI. Per ulteriori informazioni sulla configurazione di AWS CLI, vedere [Configure 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).

**Nota**  
WhatsApp archivia i file multimediali per 30 giorni prima di eliminarli, consulta [Upload Media](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#upload-media) nel *WhatsApp Business Platform Cloud API Reference*.

1. Carica il file multimediale in un bucket Amazon S3. Per ulteriori informazioni, consulta [Caricamento di file multimediali da inviare con WhatsApp](managing-media-files-s3.md).

1. Carica il file multimediale WhatsApp utilizzando il [post-whatsapp-message-media](https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/post-whatsapp-message-media.html)comando. Una volta completato con successo, il comando restituirà il*\$1MEDIA\$1ID\$1*, necessario per l'invio del messaggio multimediale.

   ```
   aws socialmessaging post-whatsapp-message-media --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID}  --source-s3-file bucketName={BUCKET},key={MEDIA_FILE}
   ```

   Nel comando precedente, procedi come segue.
   + *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sostituiscilo con l'ID del tuo numero di telefono.
   + Sostituisci *\$1BUCKET\$1* con il nome del bucket Amazon S3.
   + Sostituisci *\$1MEDIA\$1FILE\$1* con il nome del file multimediale. 

   Puoi anche caricare utilizzando un [URL predefinito utilizzando](managing-media-files-s3.md#managing-media-files-s3.title) `--source-s3-presigned-url` instead of`--source-s3-file`. Devi aggiungere `Content-Type` nel `headers` campo. Se si utilizzano entrambi, `InvalidParameterException` viene restituito un.

   ```
   --source-s3-presigned-url headers={"Name":"Value"},url=https://BUCKET.s3.REGION/MEDIA_FILE
   ```

1. Usa il [send-whatsapp-message](https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/send-whatsapp-message.html)comando per inviare il messaggio multimediale.

   ```
   aws socialmessaging send-whatsapp-message --message '{"messaging_product":"whatsapp","to":"'{PHONE_NUMBER}'","type":"image","image":{"id":"'{MEDIA_ID}'"}}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0
   ```
**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","to":"'{PHONE_NUMBER}'","type":"image","image":{"id":"'{MEDIA_ID}'"}}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0 --cli-binary-format raw-in-base64-out
   ```

   Nel comando precedente, procedi come segue.
   + Sostituiscilo *\$1PHONE\$1NUMBER\$1* con il numero di telefono del cliente.
   + *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sostituiscilo con l'ID del tuo numero di telefono.
   + Sostituisci *\$1MEDIA\$1ID\$1* con l'ID multimediale restituito dal passaggio precedente. 

1. Quando non è più necessario il file multimediale, è possibile eliminarlo WhatsApp utilizzando il [delete-whatsapp-message-media](https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/delete-whatsapp-media-message.html)comando. Questa operazione rimuove solo il file multimediale WhatsApp e non il bucket Amazon S3.

   ```
   aws socialmessaging delete-whatsapp-message-media --media-id {MEDIA_ID} --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID}
   ```

   Nel comando precedente, procedi come segue.
   + *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sostituiscilo con l'ID del tuo numero di telefono.
   + Sostituisci *\$1MEDIA\$1ID\$1* con l'ID multimediale. 