Questa guida mostra come integrare il tuo AI Agent di Quickchat AI con WhatsApp. Il processo è diviso in 2 semplici passaggi:
- Passaggio 0 - Prerequisiti
- Passaggio 1 - Connetti WhatsApp
Se hai problemi con l’integrazione o ti serve aiuto, vai alla sezione Risoluzione dei problemi e FAQ oppure contattaci.
Guarda il video
Passaggio 0 - Prerequisiti
A. Numero di telefono aziendale
Decidi quale numero di telefono userai per WhatsApp. Puoi leggere di più nella documentazione di WhatsApp oppure seguire le FAQ qui sotto:
Quale numero può essere usato in WhatsApp Cloud API?
- Devi usare un numero di telefono aziendale dedicato che possa ricevere SMS o chiamate vocali per la verifica.
- Il numero deve essere valido, di tua proprietà e avere un prefisso internazionale e un prefisso locale.
Posso usare un numero già usato in WhatsApp Messenger?
- No. Puoi continuare a usare questo numero per chiamate e SMS, ma non in WhatsApp Messenger.
- Se il numero è già usato in WhatsApp Messenger, eliminalo prima. Non dimenticare di eseguire il backup della cronologia delle chat di WhatsApp.
- I numeri bloccati devono essere sbloccati prima della registrazione.
Posso usare un numero già usato da WhatsApp Business App?
- Sì. Se il tuo numero è attualmente usato nella WhatsApp Business App, potresti poterlo integrare nella Cloud API senza eliminare l’account dell’app. Leggi di più sull’onboarding Coexistence nella documentazione di Meta.
Posso usare un nuovo numero di telefono?
- Sì, se preferisci non usare il tuo numero attuale, procurati un nuovo numero (SIM fisica o numero virtuale). Puoi acquistare un numero di telefono virtuale da servizi come Hushed.
B. Informazioni aziendali
Prepara questi dettagli (li inserirai durante il flusso di integrazione Meta):
- Nome dell’azienda
- Sito web dell’azienda
- Categoria dell’azienda
- Descrizione dell’azienda
Anche se alcuni campi sembrano facoltativi, compilali con precisione. Informazioni mancanti o imprecise possono ritardare l’approvazione o causare restrizioni dell’account.
Passaggio 1 - Connetti WhatsApp
Dall’ultimo aggiornamento, la connessione richiede un solo clic. Non esiste più un secondo passaggio separato: la procedura guidata Embedded Signup di Meta ti guida nella creazione di un nuovo WhatsApp Business Account e numero, oppure nella scelta di uno già esistente, e Quickchat AI completa il resto.
Apri la Quickchat AI App → External Apps → WhatsApp → fai clic sul pulsante Connect WhatsApp e segui il pop-up di Meta:
- Accedi al tuo account Meta (Facebook).
- Controlla le autorizzazioni che condividerai con Quickchat AI (accesso all’account WhatsApp Business e accesso al portfolio Business) e continua.
- Fornisci dati aziendali accurati (Business Portfolio, Business Name, Business Website, Country, ecc.).
- Crea o seleziona il tuo WhatsApp Business Account.
- Scegli un nome visualizzato e una categoria per WhatsApp Business.
- Aggiungi il tuo numero di telefono aziendale e verificalo tramite SMS/voce quando richiesto.
- Fai clic su Confirm per concedere a Quickchat AI l’accesso richiesto.
- Quando Meta conferma che la configurazione è completa, fai clic su Finish. Il pop-up mostra una conferma di Quickchat AI che il tuo account WhatsApp è stato connesso e si chiude automaticamente.
Tornando nella Quickchat AI App, il pannello WhatsApp mostra Connecting your WhatsApp account e si aggiorna a Connected entro circa 30 secondi. Se non succede, fai clic su Refresh Status nel pannello. In caso contrario, rivedi i Prerequisiti sopra per assicurarti di aver fornito correttamente il numero di telefono e le informazioni aziendali.
Connected significa che Quickchat AI può raggiungere il tuo WhatsApp Business Account. Subito sotto, il pannello mostra cosa manca ancora prima che i clienti ricevano risposte:
Il pannello Connected elenca cosa resta da fare: qui, il primo messaggio
- Waiting for your first message: invia un messaggio WhatsApp al numero mostrato da un altro telefono, poi fai clic su Refresh. Dopo l’arrivo di un messaggio, il pannello mostra Messages Received accanto a Webhook Active e Admin Assigned.
- Display name: ogni numero elencato più in basso nel pannello riporta lo stato del nome visualizzato da Meta (Approved, Pending review, Declined, Expired o No display name). Una revisione in corso non richiede azioni da parte tua e di solito si conclude entro pochi giorni. Un nome visualizzato rifiutato, scaduto o mancante richiede di inviarne uno in WhatsApp Manager.
- Meta test number: se il numero attivo è un numero +1 555 fornito da Meta, il pannello lo indica. Questi numeri servono per fare prove e non possono essere spostati su un altro account. Aggiungi il tuo numero in WhatsApp Manager per andare in produzione.
Quando il pannello mostra Messages Received, sei online. 🎉 I clienti possono inviare messaggi al tuo numero WhatsApp e il tuo AI Agent risponderà automaticamente.
Come verifica finale della tua integrazione, invia un messaggio di testo al numero WhatsApp che hai appena connesso, poi fai clic su Refresh nel pannello. Waiting for your first message diventa Messages Received, dovresti ricevere una risposta dal tuo AI Agent e la conversazione dovrebbe apparire nella Inbox della Quickchat AI App. Se lasci incompleto uno qualsiasi dei passaggi di configurazione di Meta, Quickchat AI invia anche un’email al proprietario dell’account con i passaggi rimanenti come promemoria.
Risoluzione dei problemi e FAQ
Come funziona il prezzo di WhatsApp Business API?
- Le risposte alle richieste dei clienti avviate dagli utenti (inbound) sono trattate da WhatsApp come messaggi di servizio. Questi messaggi consentono alle aziende di gestire le richieste in arrivo dei clienti, tramite un agente umano o un bot conversazionale basato su AI.
- Quando gli utenti inviano un messaggio a un’azienda, si apre una finestra di assistenza clienti di 24 ore durante la quale le aziende possono rispondere con messaggi di servizio, senza costi. Questa finestra si reimposta a ogni messaggio dell’utente.
- Al di fuori delle 24 ore, devi usare Message Templates approvati (Marketing, Utility, Authentication, ecc.) e pagare per messaggio secondo le tariffe dei messaggi di WhatsApp Business Platform.
- Le conversazioni sono categorizzate e fatturate da Meta. Assicurati che il tuo WhatsApp Business Account abbia un metodo di pagamento valido per i messaggi avviati dall’azienda o basati su template.
Il pulsante Connect WhatsApp non funziona. Non vedo il pop-up di Meta.
- Se il tuo browser blocca il pop-up, l’app mostra un messaggio che ti chiede di consentire i pop-up. Disattiva i blocchi di pop-up e tracker nel browser, aggiorna il sito e riprova. Se non aiuta, prova un altro browser.
La verifica del numero non è riuscita.
- Assicurati che il numero possa ricevere SMS/chiamate vocali e non sia bloccato da un percorso di registrazione attivo che Meta non consente di far coesistere. Se il numero è usato nella Business App, prova l’onboarding tramite Coexistence.
Meta dice che la mia configurazione non è terminata, oppure il pannello mostra un avviso.
- Leggi prima la scheda sotto Connected: indica il numero su cui risponde il tuo AI Agent e dice se Meta sta ancora verificando il suo nome visualizzato, se è un numero di test Meta o se il primo messaggio non è ancora arrivato. Ogni scheda rimanda al punto corretto in WhatsApp Manager.
- Se l’avviso riguarda la connessione stessa, fai clic su Reconnect WhatsApp nel pannello. Questo risolve la maggior parte dei casi.
- Se non funziona, il tuo numero potrebbe essere collegato a un altro provider (Meta consente un solo partner per account WhatsApp alla volta). Segui le istruzioni sullo schermo per aggiungere Quickchat AI come partner nelle impostazioni Meta Business, poi fai clic su Refresh Status.
Ho collegato l’account sbagliato.
- Reconnect mantiene l’account già collegato. Per cambiarlo, fai clic su Disconnect nel pannello WhatsApp, poi di nuovo su Connect WhatsApp e scegli l’account Meta Business e l’account WhatsApp corretti nella finestra di Meta.
I messaggi non compaiono nella Inbox di Quickchat AI.
- Conferma che il pop-up abbia mostrato la conferma finale che il tuo account WhatsApp era stato collegato.
- Ricontrolla di aver collegato il WhatsApp Account previsto e che sia selezionato l’AI Agent corretto.
- La scheda Waiting for your first message indica il numero su cui risponde il tuo AI Agent. Assicurati di aver inviato un messaggio proprio a quel numero e che sia attivato nel pannello, poi fai clic su Refresh.
- Se invii messaggi dopo 24 ore senza un messaggio dell’utente, usa template approvati e assicurati che sia impostato un metodo di pagamento in WhatsApp Manager.
L’invio delle risposte WhatsApp della mia AI non riesce.
- Quickchat AI mostra un avviso “WhatsApp replies are failing” nel pannello WhatsApp e una notifica nella tua dashboard. Correzioni comuni: completa l’approvazione del nome visualizzato in WhatsApp Manager; se la connessione è scaduta o è stata revocata, fai clic su Reconnect; se Meta ha limitato il tuo numero per qualità o policy, controlla il suo stato in WhatsApp Manager. L’avviso scompare quando una risposta viene inviata di nuovo correttamente.
I template o i messaggi avviati dall’azienda non riescono.
- Verifica che i tuoi Message Templates siano approvati e che il tuo metodo di pagamento sia attivo in WhatsApp Manager.
- I nuovi mittenti iniziano con limiti di messaggistica che aumentano in base a qualità e verifica. Se raggiungi i limiti per la messaggistica avviata dall’azienda, consulta la guida di Meta sui Messaging Limits.
- Controlla limiti di messaggistica e quality rating in WhatsApp Manager se la consegna è limitata.
Come creare il mio link WhatsApp e il pulsante “Chatta su WhatsApp”?
- Segui questo tutorial di WhatsApp.
Come creare il mio codice QR WhatsApp?
- Visita WhatsApp Manager → Phone numbers → seleziona il tuo numero di telefono aziendale → Message links → Create Message Link.
- In alternativa, puoi trovarlo nella tua app mobile WhatsApp Business. Segui questo tutorial di WhatsApp.
Hai bisogno di aiuto?
Chatta con l’AI di supporto di Quickchat su WhatsApp:
📱 +1 302-405-9992: Avvia una chat
Oppure scansiona il codice QR:
