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à.
# Configurare la messaggistica WhatsApp aziendale
Gli argomenti di questa sezione spiegano come configurare e testare la messaggistica WhatsApp aziendale per Amazon Connect. Usi [AWS End User Messaging Social](https://docs.aws.amazon.com/social-messaging/latest/userguide/what-is-service.html) per collegare un account WhatsApp aziendale e un numero di telefono a un'istanza Amazon Connect, quindi importare il numero di telefono collegato in Amazon Connect. I clienti possono quindi WhatsApp utilizzarlo per inviare messaggi al tuo call center.
Puoi anche utilizzare Amazon Lex per automatizzare le risposte alle domande dei clienti. Ciò consente agli agenti di risparmiare tempo e fatica. Per ulteriori informazioni, consulta [Nozioni di base su Amazon Lex](https://docs.aws.amazon.com/lexv2/latest/dg/getting-started.html) nella *Guida per gli sviluppatori di Amazon Lex*.
**Topics**
+ [Prerequisiti](#whatsapp-prerequisites)
+ [Fase 1: abilitare Amazon Connect come destinazione dell’evento](#enable-connect-destination)
+ [Fase 2: configurare un flusso di contatti in entrata sul numero di telefono](#inbound-contact-flow)
+ [Fase 3: inviare e ricevere messaggi di prova](#send-receive-test-messages)
+ [Prossime fasi: preparati a trasmettere in diretta](#whatsapp-next-steps)
+ [Risoluzione di problemi comuni.](#whatsapp-troubleshooting)
+ [WhatsApp Funzionalità e limitazioni della messaggistica aziendale con Amazon Connect](whatsapp-messaging-capabilities.md)
## Prerequisiti
Prima di poter effettuare WhatsApp l'integrazione con Amazon Connect, devi disporre dei seguenti elementi:
+ Un account WhatsApp aziendale.
+ Un numero di WhatsApp telefono. Il numero deve essere in grado di ricevere una chiamata vocale o un messaggio di testo SMS per completare il processo di verifica del numero di telefono di Meta per la messaggistica WhatsApp aziendale. Puoi utilizzare un numero vocale Amazon Connect o un AWS End User Messaging SMS numero per il numero di WhatsApp telefono. Puoi anche utilizzare un numero di telefono che non possiedi AWS.
Quando utilizzi un numero vocale o AWS End User Messaging SMS un numero Amazon Connect, ti consigliamo di richiedere un nuovo numero che non venga utilizzato con il traffico vocale o SMS in diretta per evitare potenziali interruzioni del servizio.
Puoi utilizzare la console AWS End User Messaging Social [https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/)all'indirizzo per creare l'account WhatsApp aziendale e il numero di telefono. Per ulteriori informazioni, consulta la sezione [Registrazione WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/getting-started.html#getting-started-embedded) nella *AWS End User Messaging Social User Guide*.
**Importante**
WhatsApp dispone di un processo di verifica aziendale automatizzato che può richiedere fino a 2 settimane per essere completato. Ti consigliamo di iniziare questa procedura in anticipo. WhatsApp può disabilitare gli account WhatsApp aziendali se la politica WhatsApp aziendale viene violata o l'identità aziendale non può essere verificata.
Inoltre, consigliamo vivamente di esaminare [le best practice per AWS End User Messaging Social](https://docs.aws.amazon.com/social-messaging/latest/userguide/best-practices.html) e [le WhatsApp Best Practices](https://business.whatsapp.com/policy#best_practices) prima di creare e collegare WhatsApp risorse.
Dopo aver creato l’account e il numero di telefono, completa la procedura nelle seguenti sezioni nell’ordine elencato.
## Fase 1: abilitare Amazon Connect come destinazione dell’evento
I passaggi seguenti spiegano come utilizzare AWS End User Messaging Social per abilitare Amazon Connect come destinazione dell'evento per il tuo account WhatsApp aziendale collegato. Ciò consente al sistema di importare il tuo numero di WhatsApp telefono.
È possibile utilizzare la [console AWS End User Messaging Social](https://console.aws.amazon.com/social-messaging/) o AWS CLI completare questa attività. Per utilizzarlo AWS CLI, [https://docs.aws.amazon.com/connect/latest/APIReference/API_ImportPhoneNumber.html](https://docs.aws.amazon.com/connect/latest/APIReference/API_ImportPhoneNumber.html)consulta il *riferimento all'API Amazon Connect* e il *riferimento [https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PutWhatsAppBusinessAccountEventDestinations.html](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PutWhatsAppBusinessAccountEventDestinations.html)all'API social di messaggistica AWS finale*.
Nel seguente argomento viene descritto come utilizzare la console.
**Per utilizzare la console**
1. Accedi alla console AWS End User Messaging Social all'indirizzo [https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/).
1. Nel pannello di navigazione, scegli **Account WhatsApp aziendali**, quindi scegli l'account desiderato.
1. Nella scheda **Destinazione dell’evento**, scegli **Modifica destinazione**.
1. Alla voce **Tipo di destinazione** scegli **Amazon Connect**.
1. Per **Istanza Connect**, scegli la tua istanza Amazon Connect nell’elenco a discesa.
1. Per **Ruolo ARN**, scegli un ruolo IAM che conceda l’autorizzazione a recapitare messaggi ed eventi e a importare numeri di telefono. Ad esempio policy IAM, consulta [Aggiunta di una destinazione di messaggi ed eventi a AWS End User Messaging Social](https://docs.aws.amazon.com/social-messaging/latest/userguide/managing-event-destinations-add.html#managing-event-destinations-amazon-connect-policies) nella *Guida per l’utente di AWS End User Messaging Social*.
1. Scegli **Save changes** (Salva modifiche).
Questo avvia il processo di importazione del numero di telefono in Amazon Connect.
Al termine dell’operazione, il numero viene visualizzato nel sito web di amministrazione di Amazon Connect.
**Per visualizzare il numero**
+ Nel menu di navigazione scegli **Canali**, quindi **Numeri di telefono**.
La colonna **Canali attivi** viene visualizzata **WhatsApp**per tutti i WhatsApp numeri.
## Fase 2: configurare un flusso di contatti in entrata sul numero di telefono
Puoi creare un flusso di contatti in entrata da utilizzare con il tuo numero di WhatsApp telefono oppure puoi riutilizzare un flusso esistente. Se riutilizzi un flusso, puoi aggiungere un blocco `CheckContactAttribute` e abilitare la ramificazione per il flusso. Il blocco consente di inviare WhatsApp i contatti a una coda specifica o di eseguire un'altra azione.
Per ulteriori informazioni sulla creazione del flusso di contatti, inclusi messaggi interattivi e anteprime di link avanzati, consulta [WhatsApp Funzionalità e limitazioni della messaggistica aziendale con Amazon Connect](whatsapp-messaging-capabilities.md) più avanti in questa sezione.
La serie di passaggi riportata di seguito spiega come configurare un flusso di contatti in entrata e aggiungere un blocco `CheckContactAttribute` al flusso.
**Per configurare un flusso**
1. Avvia la console Amazon Connect all'indirizzo [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)
1. Nel menu di navigazione scegli **Canali**, quindi **Numeri di telefono**.
1. Scegli il WhatsApp numero, quindi scegli **Modifica**.
1. In **Flusso di contatti/IVR**, seleziona il flusso che hai aggiornato.
1. Scegli **Save** (Salva).
**Per aggiungere il blocco CheckContactAttribute**
1. Segui i passaggi da 1 a 4 presenti [nella sezione precedente](#enable-connect-destination).
1. Apri la pagina **Proprietà** del flusso.
1. Nella sezione **Attributo da verificare**, imposta **Namespace** su **Attributi segmento** e la **chiave** su **Sottotipo**. Per ulteriori informazioni sugli attributi di segmento, consulta [SegmentAttributes](ctr-data-model.md#segmentattributes), più avanti in questa guida.
1. **Nella sezione **Condizioni da verificare**, imposta la **condizione** su **Uguali** e il **valore** da connettere:. WhatsApp**
1. Scegli **Save** (Salva).
## Fase 3: inviare e ricevere messaggi di prova
In questo passaggio, utilizzi il Contact Control Panel (CCP) e un telefono cellulare per inviare e ricevere WhatsApp messaggi di prova.
**Per testare l’integrazione**
1. Nel CCP, imposta lo stato su **Disponibile**.
1. Utilizzando WhatsApp il telefono cellulare, avvia una conversazione inserendo il numero di telefono aggiunto in precedenza.
L’immagine seguente mostra un messaggio con **Opzioni** e l’elenco delle relative opzioni.
## Prossime fasi: preparati a trasmettere in diretta
Dopo aver testato l'integrazione, ti consigliamo di aggiungere le seguenti caratteristiche e funzionalità al tuo canale WhatsApp di messaggistica.
### Aggiunta delle funzionalità di Amazon Connect
I link nell’elenco seguente ti portano a informazioni sulle funzionalità di Amazon Connect che puoi aggiungere alle esperienze di clienti e agenti.
+ Ulteriori informazioni sull'[WhatsApp Funzionalità e limitazioni della messaggistica aziendale con Amazon Connect](whatsapp-messaging-capabilities.md).
+ [Consentire ai clienti di riprendere le conversazioni in chat in Amazon Connect](chat-persistence.md): i clienti possono riprendere conversazioni precedenti mantenendone il contesto, i metadati e le trascrizioni. Non devono ripetere quanto detto in precedenza, poiché gli agenti hanno accesso all'intera cronologia delle conversazioni.
+ [Creare risposte rapide da utilizzare nei contatti via chat ed e-mail in Amazon Connect](create-quick-responses.md): fornisci agli agenti risposte prescritte alle domande più comuni dei clienti, che possono utilizzare mentre chattano con i clienti. Le risposte rapide consentono agli agenti di rispondere più rapidamente ai clienti.
### Aggiunta di punti di ingresso
I link nell’elenco seguente consentono di accedere a informazioni sull’aggiunta di diversi tipi di punti di ingresso per i clienti.
+ Punti di ingresso: [5 modi per indirizzare lead e clienti verso conversazioni di messaggistica aziendale](https://business.whatsapp.com/blog/messaging-app-entry-points) (post WhatsApp sul blog)
+ Codici QR: [gestisci il codice QR della tua WhatsApp Business Platform](https://business.facebook.com/business/help/890732351439459) (articolo di aiuto di Meta)
+ Click-to-WhatsAppannunci: [crea annunci cliccabili su Ads Manager](https://business.facebook.com/business/help/447934475640650?id=371525583593535) (articolo di aiuto di Meta) WhatsApp
### Aggiunta di un nome visualizzato sul numero di telefono
Per aggiungere un nome visualizzato verificato visibile ai clienti, [visualizza il nome About WhatsApp Business](https://business.facebook.com/business/help/338047025165344) nella guida di Meta.
### Scalare il traffico
Dopo aver integrato il traffico in tempo reale nella tua WhatsApp integrazione, ti consigliamo di monitorare le seguenti quote.
**Quote di Amazon Connect**
Per ulteriori informazioni sulle quote predefinite e come aumentarle, consulta [Connect Customer quote di servizio](amazon-connect-service-limits.md).
+ Quota di [chat attive simultaneamente per ogni istanza](amazon-connect-service-limits.md#concurrent-active-chats). Per informazioni sul monitoraggio di questa quota, consulta [Monitoraggio dell'istanza Amazon Connect tramite CloudWatch](monitoring-cloudwatch.md).
+ Quota di limitazione della larghezza di banda della rete di [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html).
+ Quota di limitazione della larghezza di banda della rete di [SendChatIntegrationEvent](https://docs.aws.amazon.com/connect/latest/APIReference/API_SendChatIntegrationEvent.html).
+ Quota di limitazione della larghezza di banda della rete di `SendIntegrationEvent`. Un'API di sola autorizzazione utilizzata da AWS End User Messaging Social per pubblicare WhatsApp eventi in entrata.
**Quote di End User Messaging Social**
AWS End User Messaging Social impone limiti di velocità su una serie di messaggi APIs. Monitora quanto segue APIs per vedere se è necessario modificare una o più quote. I link portano alla *documentazione di riferimento delle API di AWS End User Messaging Social*.
+ [SendWhatsAppMessage](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_SendWhatsAppMessage.html)
+ [PostWhatsAppMessageMedia](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PostWhatsAppMessageMedia.html)
+ [GetWhatsAppMessageMedia](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_GetWhatsAppMessageMedia.html)
Per maggiori informazioni sull’aumento delle quote di AWS End User Messaging Social, consulta i seguenti argomenti nella *Guida per l’utente di AWS End User Messaging Social*:
+ [Quote per AWS End User Messaging Social](https://docs.aws.amazon.com/social-messaging/latest/userguide/quotas.html)
+ [Aumenta i limiti delle conversazioni di messaggistica in WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/increase-message-limit.html)
+ [Aumenta la velocità di trasmissione dei messaggi in WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/increase-message-throughput.html)
## Risoluzione di problemi comuni.
Utilizza le seguenti informazioni per risolvere i problemi più comuni relativi a un'integrazione. WhatsApp
**Topics**
+ [Impossibile visualizzare i numeri di telefono importati nell’istanza Amazon Connect](#no-imported-number)
+ [I messaggi in entrata dei clienti non vengono recapitati](#whatsapp-messages-not-delivered)
### Impossibile visualizzare i numeri di telefono importati nell’istanza Amazon Connect
Se il numero importato non viene visualizzato nel sito web di amministrazione di Amazon Connect, procedi nel seguente modo:
+ Assicurati che il ruolo IAM di destinazione dell’evento disponga delle autorizzazioni necessarie. Per ulteriori informazioni, consulta [Fase 1: abilitare Amazon Connect come destinazione dell’evento](#enable-connect-destination).
+ Verifica se è necessario aumentare la quota di *numeri di telefono per ogni istanza*. Per ulteriori informazioni, consulta [Connect Customer quote di servizio](amazon-connect-service-limits.md).
+ Per riassegnare un account WhatsApp aziendale collegato a un'altra istanza Amazon Connect, devi prima rilasciare i numeri di telefono importati dall'istanza Amazon Connect originale. Dopo il rilascio dei numeri di telefono, puoi aggiornare la destinazione dell'evento sul tuo account WhatsApp aziendale collegato a un'altra istanza Amazon Connect.
**Importante**
Non rilasciare numeri che gestiscono il traffico di clienti in tempo reale. Piuttosto, [richiedi nuovi numeri di telefono](https://docs.aws.amazon.com/connect/latest/adminguide/claim-and-manage-phonenumbers.html).
+ Per aiutare a determinare la causa del problema di importazione, cerca gli `ImportPhoneNumber` eventi CloudTrail nei log e controlla i dettagli dell'errore. Se la chiamata `ImportPhoneNumber` ha esito positivo, puoi chiamare `DescribePhoneNumber` per ottenere altri dettagli sull’errore.
Se hai apportato una correzione, devi importare di nuovo i numeri di telefono. Per fare ciò, ripeti [Fase 1: abilitare Amazon Connect come destinazione dell’evento](#enable-connect-destination).
### I messaggi in entrata dei clienti non vengono recapitati
Se il recapito dei messaggi WhatsApp in entrata si interrompe, cerca nei AWS CloudTrail log i dettagli degli `SendIntegrationEvent` errori`SendChatIntegrationEvent`.
Puoi anche controllare questi scenari comuni:
+ Assicurati che il tuo account WhatsApp aziendale collegato in AWS End User Messaging Social abbia una destinazione per eventi Amazon Connect abilitata.
+ Assicurati che il ruolo IAM della destinazione degli eventi disponga delle autorizzazioni necessarie. Per ulteriori informazioni, consulta la sezione [Fase 1: abilitare Amazon Connect come destinazione dell’evento](#enable-connect-destination) descritta precedentemente in questa sezione. Hai un ruolo configurato male se CloudTrail genera `AccessDeniedException` errori dall'`SendIntegrationEvent`API.
+ Assicurati che il tuo numero di WhatsApp telefono sia stato importato correttamente nell'istanza Amazon Connect e che al numero sia associato un flusso di contatti in entrata. Per ulteriori informazioni, consulta [Fase 2: configurare un flusso di contatti in entrata sul numero di telefono](#inbound-contact-flow).
+ I messaggi in entrata sono stati eliminati perché non sono ancora supportati. Per ulteriori informazioni, consulta [WhatsApp Funzionalità e limitazioni della messaggistica aziendale con Amazon Connect](whatsapp-messaging-capabilities.md).