WhatsApp

Le seguenti impostazioni sono relative all'app WhatsApp.

Installazione

1. Installazione dell'App: Per installare l'app, consulta la sezione di installazione delle app.

Configurazione WhatsApp Cloud API - Modalità di Sincronizzazione Automatica

• Questa funzionalità è disponibile solo nella versione cloud di Chat G Tech Group.
• Clicca su Sincronizza ora e completa la procedura.
• Per aggiungere nuovi numeri, visita Gestione numeri WhatsApp. Se aggiungi nuovi numeri dopo il processo di sincronizzazione, dovrai sincronizzarli nuovamente. Tutti i numeri saranno automaticamente sincronizzati. Se desideri disabilitare numeri specifici, puoi eliminarli da Impostazioni > WhatsApp > Numeri Cloud API.
• Se risincronizzi lo stesso numero di telefono e non ricevi l'SMS di verifica o la chiamata, puoi inserire l'ultimo PIN ricevuto e funzionerà.
• Se non ricevi i messaggi inviati al tuo numero WhatsApp in Chat G Tech Group, verifica quanto segue:
  • Clicca su Riconnetti e completa la procedura.
  • Vai su Meta Business Suite e aggiungi un metodo di pagamento.

Configurazione WhatsApp Cloud API - Modalità di Sincronizzazione Manuale

1. Creazione di un Account:

   • Crea un nuovo account su Facebook Developers o accedi con il tuo account esistente.
   • Crea una nuova app e scegli Other come tipo di app, quindi seleziona Business. Inserisci un nome per l'app e seleziona l'Account Business utilizzato per WhatsApp.

2. Configurazione dell'App:

   • In Chat G Tech Group > Impostazioni > WhatsApp > Cloud API settings > Secret key inserisci una stringa casuale, quindi vai su Facebook Developers e seleziona la tua app.
   • Clicca su Add product e aggiungi WhatsApp, quindi vai su WhatsApp > Configuration e in Webhook URL inserisci l'URL che ottieni da Chat G Tech Group > Impostazioni > WhatsApp > Cloud API > Configuration URL. In Verify token inserisci la chiave segreta precedentemente inserita in Chat G Tech Group. Clicca su Verify and save, poi su Webhook fields > Manage e abilita il campo Webhook messages.

3. Verifica dell'Integrazione:

   • Vai su Facebook Developers e seleziona la tua app. Dal menu a sinistra, clicca su WhatsApp e poi su API Setup.
   • Copia l'ID del numero di telefono e incollalo in Chat G Tech Group > Impostazioni > WhatsApp > Cloud API numbers > Phone number ID. Inserisci il numero di telefono desiderato nel campo To, ad esempio il tuo numero WhatsApp personale, e invia un messaggio di test. Controlla il tuo account WhatsApp e invia una risposta, che dovrebbe poi apparire in Chat G Tech Group.
   • Per rispondere al numero di test da Chat G Tech Group, copia il token di accesso temporaneo e incollalo in Chat G Tech Group > Impostazioni > WhatsApp > Cloud API numbers > Token.
   • Per attivare l'integrazione di WhatsApp per tutti i numeri di telefono e aggiungere un numero di telefono attivo, segui le linee guida riportate.

4. Token di Accesso Permanente:

   • In Chat G Tech Group > Impostazioni > WhatsApp > Cloud API numbers > Token inserisci il token di accesso permanente. Per ottenerlo, visita Meta Business Suite e vai su Settings > Business settings, quindi su Users > System Users per visualizzare il tuo utente di sistema amministratore o crearne uno nuovo.
   • Apri l'utente e clicca su Add Assets, quindi seleziona l'app utilizzata per l'integrazione API di WhatsApp e seleziona Develop App o Full control. L'utente di sistema deve essere un amministratore. Se non vedi l'opzione, clicca su Business settings.
   • Dal menu a sinistra, clicca su Account > Apps. Seleziona la tua app o aggiungila. Assicurati che l'utente di sistema sia presente e abbia il controllo completo. In caso contrario, clicca su Add user, seleziona l'utente di sistema, clicca su Full control e clicca su Assign.
   • Clicca su Apps e sotto Select Assets scegli la tua app, abilita Develop App o Full control e salva.
   • Da Users > System Users seleziona l'utente appena creato e clicca su Generate New Token, seleziona l'app utilizzata per l'integrazione API di WhatsApp, imposta l'espirazione del token su Never, abilita le seguenti autorizzazioni: whatsapp_business_management, whatsapp_business_messaging, business_management. Clicca su Generate Token e salva. Incolla il token in Chat G Tech Group > Impostazioni > WhatsApp > Cloud API numbers > Token.

5. Aggiunta di Numeri di Telefono Aggiuntivi:

   • Puoi farlo visitando Facebook Developers, selezionando la tua app e navigando su WhatsApp > API Setup. Per iniziare, clicca su Add phone number in fondo e segui le istruzioni. Tieni presente che se utilizzi il tuo attuale numero WhatsApp Business in Chat G Tech Group, non sarà più utilizzabile con la tua app WhatsApp Business e dovrai migrare il numero seguendo le istruzioni. Dopo aver attivato il numero, copia l'ID del numero di telefono e incollalo in Chat G Tech Group > Impostazioni > WhatsApp > Cloud API numbers > Phone number ID.

Configurazione Account 360dialog

1. Vai su 360dialog e crea un nuovo account.
2. Accedi alla dashboard e dal menu a sinistra seleziona WhatsApp Accounts e genera la chiave API. Copia e incolla la chiave in Chat G Tech Group > Impostazioni > WhatsApp > 360dialog settings.
3. Clicca su Chat G Tech Group > Impostazioni > WhatsApp > 360dialog settings > Sincronizza ora.
4. Hai finito! Chat G Tech Group dovrebbe iniziare a ricevere i messaggi WhatsApp inviati al tuo numero, e puoi rispondere a quei messaggi direttamente da Chat G Tech Group.
5. Nota che puoi anche utilizzare l'account sandbox gratuito per i test, maggiori dettagli su 360dialog Docs. L'account sandbox ha delle limitazioni e alcune funzionalità, come gli allegati multimediali, potrebbero non funzionare.

Configurazione Account Twilio

1. Vai su Twilio e crea un nuovo account.
2. Verifica il tuo numero di telefono.
3. Completa il modulo e scegli WhatsApp, Alerts & Notifications, With no code at all, 3rd party integrations.
4. Dalla console di Twilio copia ACCOUNT SID e AUTH TOKEN e incollali in Chat G Tech Group > Impostazioni > WhatsApp > Twilio settings, salva le modifiche.
5. Configura un account di prova gratuito per eseguire alcuni test e assicurarti che l'integrazione funzioni con Chat G Tech Group. Dal menu a sinistra clicca su Messaging > Settings > WhatsApp sandbox settings e inserisci in WHEN A MESSAGE COMES IN e STATUS CALLBACK URL l'URL di Chat G Tech Group, ottenuto da Chat G Tech Group > Impostazioni > WhatsApp > Twilio settings > Ottieni URL di configurazione. Ricorda che localhost non funzionerà, hai bisogno di un URL pubblico e di un server live.
6. Dal menu a sinistra clicca su Messaging > Try it out > Send a WhatsApp message. Segui le istruzioni e invia il messaggio con il codice al numero WhatsApp fornito. Clicca sui pulsanti successivi fino al completamento della configurazione.
7. Hai finito! Chat G Tech Group dovrebbe iniziare a ricevere i messaggi WhatsApp inviati all'account sandbox, e puoi rispondere a quei messaggi direttamente da Chat G Tech Group.
8. Per utilizzare pubblicamente l'integrazione WhatsApp con i tuoi clienti, devi anche completare i seguenti passaggi:
   • Aggiorna il tuo account e abilita la fatturazione, puoi farlo qui.
   • Acquista un numero Twilio, che sarà il numero di telefono del tuo account WhatsApp Business ufficiale. Maggiori dettagli qui. Non puoi utilizzare il numero di telefono del tuo account WhatsApp Business esistente, devi utilizzare un numero Twilio. Maggiori dettagli qui.
   • Dalla console Twilio vai su Messaging > Services e crea un nuovo Messaging Service. Clicca su Add Senders, seleziona WhatsApp Number come tipo di mittente e aggiungi il numero Twilio acquistato. Copia il Service SID e incollalo in Chat G Tech Group > Impostazioni > WhatsApp > Twilio settings > Sender.

WhatsApp API non Ufficiale

Chat G Tech Group supporta solo l'Official WhatsApp Cloud API, 360dialog o Twilio. Sfortunatamente, le API WhatsApp non ufficiali non sono supportate. Tuttavia, puoi comunque implementarle utilizzando l'API di Chat G Tech Group e i Webhook. Per ulteriori dettagli, visita Chat G Tech Group API e Webhook. Tieni presente che devi possedere competenze di sviluppo per procedere con questa integrazione. Inoltre, le nostre integrazioni predefinite sono dotate di funzionalità avanzate, inclusi il supporto chatbot, i messaggi automatizzati, la presa in carico umana, i messaggi ricchi di WhatsApp, gli allegati e altro ancora. Di conseguenza, sebbene l'implementazione di un'integrazione di base per l'invio e la ricezione di messaggi di testo sia relativamente semplice, garantire un funzionamento impeccabile è un processo più complesso. Se lo desideri, hai la possibilità di assumere il nostro team; tuttavia, siamo disponibili solo per sviluppare un'integrazione di base che consenta la messaggistica bidirezionale e l'invio di allegati.

Templates

Secondo la politica di WhatsApp Business, non puoi inviare messaggi di marketing e sollecitazione in uscita agli utenti finali. Gli utenti finali devono contattarti per primi. Hai 24 ore dal momento in cui l'utente finale ha inviato un messaggio su WhatsApp per rispondere al messaggio. Per comunicare con un utente che non ti ha contattato prima o che non è stato in contatto per più di 24 ore, devi optare per il fallback dei messaggi di testo o per il template dei messaggi WhatsApp.

• Templates di Messaggi WhatsApp: Un template di messaggi WhatsApp è un formato di messaggio che puoi utilizzare ripetutamente per inviare messaggi agli utenti una volta che hanno scelto di ricevere messaggi dalla tua app e ti hanno dato il permesso di inviarglieli. Non puoi inserire il messaggio originale nel template, devi utilizzarlo per notificare all'utente un nuovo messaggio e istruirlo su come visualizzarlo, ad esempio fornendo un link al tuo sito web dove viene mostrata la chat.
• WhatsApp Cloud API: Per ottenere il Nome del Template e gestire i template, visita Meta Business Suite e vai su Settings > More system settings, quindi su Accounts > WhatsApp accounts > Settings e clicca su WhatsApp Manager.
  • Nella sezione Template languages, inserisci tutti i codici linguistici supportati dal tuo template, separati da virgole. L'elenco dei codici linguistici è disponibile qui (copia solo il codice della lingua, es. it, es, en_US). Se utilizzi un template che supporta più lingue, la lingua corrispondente all'utente verrà selezionata automaticamente. In caso contrario, verrà utilizzata la lingua predefinita del template.
  • In Header variables e Body variables, inserisci i campi uniti supportati separati da virgole, es. {recipient_name}, {conversation_url_parameter}. Il numero di parametri inseriti qui deve corrispondere al numero di parametri del template. Usa questa funzione se il tuo template utilizza valori dinamici. L'ordine è importante, il primo campo unito verrà utilizzato come primo parametro del template.
  • In Button variables inserisci il link dei tuoi pulsanti personalizzati o il testo delle risposte rapide con prefisso quick_reply_, es. quick_reply_abcde. Ogni valore deve essere separato da una virgola.
  • Template fallback: Imposta il template WhatsApp inviato come fallback da Impostazioni > WhatsApp > Cloud API template fallback.
  • Invio di Messaggi Template a un Utente che non ti ha Contattato Prima: In Impostazioni > WhatsApp > Cloud API settings > Business Account ID inserisci il tuo ID account business, che puoi ottenere da Facebook Developers. Scegli la tua app e vai su Left menu > WhatsApp > API Setup.
  • Per inviare il template a utenti specifici, vai nella sezione Utenti di Chat G Tech Group e scegli i destinatari desiderati. Quindi, clicca sull'icona di WhatsApp nell'angolo in alto a destra.
  • Se utilizzi la WhatsApp Cloud API con un template che supporta più lingue, la lingua corrispondente all'utente verrà selezionata automaticamente. In caso contrario, verrà utilizzata la lingua predefinita del template.
  • Se utilizzi Twilio e hai parametri nel tuo template, inserisci i valori dei parametri separati da virgole nella sezione Body.
  • Per ulteriori dettagli, clicca qui.

WhatsApp Shop

Per visualizzare i prodotti del tuo negozio utilizza i campi uniti seguenti:

• {catalog id="123" product_id="123" body="" footer=""}: Visualizza un singolo prodotto. Sostituisci id con l'ID del catalogo e product_id con un ID prodotto. Gli attributi body e footer sono opzionali.
• {catalog id="123" product_id_1_1="123" product_id_1_2="123" product_id_2_1="123" section_1="" section_2="" header="" body="" footer=""}: Visualizza più prodotti. Sostituisci id con l'ID del catalogo. Aggiungi prodotti raggruppandoli in sezioni, tramite gli attributi product_id_[A]_[B], sostituisci [A] con l'indice della sezione, a partire da 1, sostituisci [B] con l'indice del prodotto, a partire da 1 per ogni sezione. Devi anche aggiungere l'attributo section_[A]="" per ogni sezione, sostituisci [A] con l'indice della sezione. Gli attributi header e body sono obbligatori, footer è opzionale.
• Quando l'utente invia l'ordine, le informazioni sull'ordine vengono inviate all'URL specificato in Impostazioni > WhatsApp > Order webhook. La pagina a quell'URL dovrebbe elaborare l'ordine e inviare un messaggio all'utente tramite la funzione API PHP sb_whatsapp_send_message().

Altre Informazioni

• Non puoi inviare un messaggio WhatsApp a un utente che ti ha inviato un messaggio più di 24 ore fa o che non ti ha mai inviato un messaggio prima. WhatsApp proibisce questa azione. Invece, devi usare un template WhatsApp o inviare un messaggio di testo. Se incontri un "Errore messaggio: Re-engagement," indica questa situazione.
• Se non ricevi messaggi WhatsApp, assicurati di non assegnare le conversazioni WhatsApp a un dipartimento e che il numero WhatsApp utilizzato per i test non sia un numero di telefono di un amministratore o agente di Chat G Tech Group. Assicurati anche di aver configurato correttamente l'URL del webhook di WhatsApp.
• Se non riesci a inviare messaggi, dovrebbe apparire un errore nell'area amministrativa quando provi a inviare un messaggio all'utente.
• Non possiamo fornire supporto per la configurazione di Twilio o 360dialog, inclusi tutti i problemi correlati.
• Non possiamo fornire supporto per ottenere l'approvazione del tuo account WhatsApp o del template di messaggi WhatsApp.
• Le conversazioni e i messaggi WhatsApp sono compatibili con la coda e il routing.
• Se stai testando con il sandbox e dopo 72 ore non puoi più inviare messaggi al tuo numero di telefono, devi ricollegare il tuo numero di telefono al sandbox.
• Puoi inviare messaggi ricchi a WhatsApp. Se invii chips, pulsanti o selezioni messaggi ricchi con più di 3 opzioni, puoi utilizzare l'attributo shortcode whatsapp="Your menu text" per impostare il testo del menu dei messaggi WhatsApp.
• Il messaggio di follow-up è supportato, ma viene sempre inviato, anche se un agente risponde.
• Il messaggio offline è supportato, ma il calendario non viene inviato.
• Il chatbot è supportato. Anche la funzione di human takeover è supportata. Per abilitare il supporto chatbot Dialogflow per i messaggi audio, attiva Impostazioni > Intelligenza Artificiale > OpenAI > Riconoscimento vocale.
• Le funzionalità di intelligenza artificiale supportate includono il rilevamento della lingua, la correzione ortografica, il multilinguismo tramite traduzione, la ricerca Google.