Integrazione con WhatsApp

Prima di iniziare

Per integrare Whatsapp con il vostro assistente, dovete avere accesso a Twilio e almeno un ruolo di sviluppatore. Per ulteriori informazioni, consulta la guida sui ruoli di Twilio.

1. Vai al sito web di Twilio.

2. Crea un account.

3. Dalla scheda Sviluppo, fare clic su Numeri di telefono.

4. Seguire le istruzioni per ottenere un numero di telefono.

Quando si ottiene un numero di telefono Twilio, questo supporta automaticamente voce, SMS e MMS. Il nuovo numero di telefono è elencato come numero attivo.

Tenete aperta la pagina web di Twilio in una scheda del browser per poterla consultare in seguito.

Chiedete WhatsApp il permesso di abilitare il vostro numero Twilio per WhatsApp

WhatsApp ha un processo rigoroso che utilizza per esaminare tutte le aziende che vogliono interagire con i clienti attraverso la sua rete. WhatsApp, che è di proprietà di Facebook, richiede la registrazione della propria attività nell'elenco delle aziende di Facebook.

1. Per registrarti, vai sul sito web di Facebook Business Manager e clicca su «Crea account ». Seguire le istruzioni per creare un account.

2. Ottenete l'ID del vostro Facebook Business Manager. In Impostazioni, fai clic sulla scheda Informazioni aziendali. L'ID del Facebook Business Manager si trova nella parte superiore della pagina.

3. Invia la richiesta per abilitare i tuoi numeri Twilio per l' WhatsApp azione tramite il modulo disponibile sulla pagina web "Twilio API for WhatsApp ".

Suggerimenti per specificare i seguenti valori:

• Numero di telefono: Specificare il numero di telefono Twilio creato in precedenza.

Considerate la possibilità di fornire più di un numero di telefono e di ottenere l'autorizzazione per i numeri in parallelo. Se il vostro numero è stato utilizzato in precedenza da un'altra azienda (ad esempio perché Twilio vi ha assegnato un numero già utilizzato in precedenza), WhatsApp lo rifiuterà.

• State lavorando con un ISV: Selezionare No.

• SID dell'account Twilio: dal sito Twilio, fare clic sull'icona della home per andare alla dashboard del progetto e trovare il SID.

• ID di Facebook Business Manager: Aggiungete l'ID dell'account creato nel passaggio precedente.

1. Fare clic su Richiedi ora.

Date a WhatsApp il tempo di valutare e approvare la vostra richiesta. L'approvazione della richiesta può richiedere fino a 7 giorni.

Impostare l'integrazione

Per impostare l'integrazione, completare i seguenti passaggi:

1. Vai alla pagina "Integrazioni " cliccando sull'icona delle integrazioni () nel menu a sinistra.

2. Fate clic su Aggiungi nella casella WhatsApp con Twilio.

3. Fare clic su Conferma.

4. Dal sito di Twilio, fate clic sul nome del vostro account nel menu in alto a sinistra per accedere alla dashboard del vostro account.

Copiate i seguenti valori e memorizzateli temporaneamente, in modo da poterli incollare nella pagina di configurazione dell'integrazione WhatsApp con Twilio nei prossimi passi.

• SID account

• Token di autenticazione

1. Tornate alla pagina di impostazione dell'integrazione di WhatsApp con Twilio. Cliccate su Avanti per passare alla fase 1 della configurazione dell'integrazione di WhatsApp con Twilio.

2. Immettere le informazioni relative al " SID del conto. Fate clic su Avanti per passare alla fase 2 della configurazione dell'integrazione di WhatsApp con Twilio.

3. Inserire le informazioni sul token di autorizzazione. Cliccate su Avanti per passare alla fase 3 della configurazione dell'integrazione di WhatsApp con Twilio.

4. Copiare il valore dal campo Webhook URI.

È possibile utilizzare questo URI webhook per testare l'integrazione nella sezione seguente.

1. Fare clic su Fine.

Se un campo richiesto per l'autenticazione viene modificato, tutte le voci dei campi correlati devono essere nuovamente compilate e convalidate.

Test dell'integrazione

Mentre aspettate che WhatsApp approvi la vostra richiesta, potete testare l'integrazione utilizzando la sandbox di Twilio. Con la sandbox, è possibile inviare e ricevere messaggi modello preapprovati ai numeri che si uniscono alla sandbox, utilizzando un numero di prova Twilio condiviso.

Non utilizzare la sandbox di Twilio in produzione. Le sessioni Sandbox scadono dopo 3 giorni.

1. Per creare una sandbox, vai alla pagina web Twilio Try WhatsApp. Viene visualizzato il messaggio Attiva la sandbox. Accettare la creazione di una sandbox e confermare la scelta.

2. Seguire le istruzioni per creare la sandbox.

3. Collegatevi alla sandbox inviando un messaggio WhatsApp dal vostro dispositivo al numero di telefono della sandbox.

4. Nella scheda Sviluppo, fare clic su Messaggistica > Impostazioni > Impostazioni sandbox WhatsApp.

5. Nella sezione Configurazione Sandbox, incollare l'URI del webhook copiato in precedenza nel campo Quando arriva un messaggio. Fare clic su Salva.

6. È possibile testare l'integrazione inviando un messaggio da WhatsApp al numero di telefono condiviso assegnato alla sandbox Twilio.

Completare l'integrazione del prodotto

Dopo che WhatsApp ha concesso l'autorizzazione al numero di telefono o al numero Twilio per accedere alla rete WhatsApp, aggiornate l'integrazione per utilizzare il vostro numero di telefono Twilio dedicato invece del numero sandbox.

1. Dalla pagina di impostazione dell'integrazione di WhatsApp con Twilio, scorrere fino alla sezione Webhook della scheda Impostazione di base. Copiare il valore dal campo " webhook WhatsApp .

2. Andate alla pagina web del vostro account Twilio e aggiungete il webhook che avete copiato alla configurazione di Twilio per completare la connessione all'integrazione di WhatsApp in Twilio.

Offrite ai clienti un accesso rapido al vostro assistente

Potete aggiungere alla vostra pagina web un'icona che i clienti possono cliccare per avviare una conversazione su WhatsApp con il vostro assistente.

Per aggiungere un'icona alla vostra pagina web, completate i seguenti passaggi:

1. Nella pagina di impostazione dell'integrazione di WhatsApp con Twilio, fare clic sulla scheda Clicca per chattare.

2. Nel campo Messaggio precompilato, aggiungete il testo che volete che WhatsApp invii al vostro assistente per conto del cliente per iniziare la conversazione.

Specificate un messaggio a cui sapete che il vostro assistente può rispondere in modo utile.

1. Copiare il link Embed e aggiungerlo alla propria pagina web. Considerate la possibilità di aggiungere un testo davanti all'icona che ne spieghi la funzione. Ad esempio, si potrebbe aggiungere un tag HTML '<span> davanti all'elemento '<span> dell'icona che dice 'Have a question? Ask AI assistant for help.

Quando un utente fa clic sull'icona nella vostra pagina web, si apre una sessione di messaggistica WhatsApp connessa al vostro assistente e si aggiunge il testo da voi specificato nel campo di testo dell'utente, pronto per essere inviato.

Considerazioni sull'azione

Per una migliore esperienza del cliente, progettate le vostre azioni tenendo conto delle capacità dell'integrazione di WhatsApp:

• Una risposta di testo che contiene più di 1.600 caratteri viene suddivisa in più risposte.

• Non includete elementi HTML nelle risposte testuali.

• L'integrazione di WhatsApp con Twilio non supporta i trasferimenti di chat avviati con il tipo di risposta Connetti all'agente.

• Se si utilizza la sintassi Markdown, vedere la tabella Sintassi Markdown supportata.

• Per includere un collegamento ipertestuale in una risposta di testo, specificare direttamente l' URL. Non utilizzare la sintassi markdown per i link. Per esempio, specificare Contact us at https://www.ibm.com.