WhatsApp

Questa guida spiega come integrare il tuo Quickchat AI Agent con WhatsApp. La procedura si divide in 2 semplici passaggi:

• Passaggio 0: prerequisiti
• Passaggio 1: collegare WhatsApp

Se riscontri problemi con l’integrazione o hai bisogno di aiuto, vai alla sezione Risoluzione dei problemi e domande frequenti oppure contattaci.

Strumenti di configurazione facoltativi

• Verifica i prerequisiti di configurazione di WhatsApp. Confronta i dati dichiarati sul numero e sul provider con i requisiti di configurazione documentati. Lo strumento non accede a un account WhatsApp e non lo collega.

• Verifica una finestra di assistenza WhatsApp. Controlla la finestra di 24 ore usando gli orari forniti per messaggio in entrata e risposta, con i relativi scostamenti di fuso orario. Lo strumento non verifica modelli, consenso o permessi dell’account e non invia messaggi.

• Stima i costi di utilizzo. Calcola i crediti dei modelli Quickchat AI e, separatamente, il totale delle voci di costo fornite. Lo strumento non cerca le tariffe dei provider, non combina crediti e importi monetari e non controlla il tuo account.

Guarda il video

Play

Passaggio 0: prerequisiti

A. Numero di telefono aziendale

Decidi quale numero di telefono usare per WhatsApp. Puoi approfondire nella documentazione WhatsApp oppure leggere le domande frequenti qui sotto:

Quale numero si può usare nella WhatsApp Cloud API?

• Serve 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 completo di prefisso internazionale e locale.

Posso usare un numero già utilizzato in WhatsApp Messenger?

• No. Puoi continuare a usarlo per chiamate e SMS, ma non in WhatsApp Messenger.
• Se il numero è già usato in WhatsApp Messenger, eliminalo prima da lì. Non dimenticare di eseguire il backup della cronologia delle chat WhatsApp.
• I numeri bannati devono essere sbloccati prima della registrazione.

Posso usare un numero già utilizzato nell’app WhatsApp Business?

• L’attuale procedura di collegamento di Quickchat AI non offre un percorso di Coexistence verificato per un numero esistente dell’app WhatsApp Business. Meta descrive il funzionamento della coesistenza nelle integrazioni supportate nella guida all’onboarding della Business App.
• Se devi conservare il numero esistente, l’account Business App e la cronologia delle chat, scrivi a support@quickchat.ai prima di procedere. Non eliminare o scollegare l’account Business App e non migrare il numero per tentare di risolvere un problema.

Posso usare un nuovo numero di telefono?

• Sì. Se preferisci non usare il numero attuale, procurati un nuovo numero (SIM fisica o numero virtuale). Puoi acquistare un numero virtuale da servizi come Hushed.

B. Informazioni sull’attività

Prepara questi dati, che inserirai durante la procedura di integrazione Meta:

• Nome dell’attività
• Sito web dell’attività
• Categoria dell’attività
• Descrizione dell’attività

Attenzione

Anche se alcuni campi sembrano facoltativi, compilali con dati accurati. Informazioni mancanti o inesatte possono ritardare l’approvazione o causare restrizioni all’account.

Passaggio 1: collegare WhatsApp

Apri l’app Quickchat AI → External Apps → WhatsApp → fai clic su Connect WhatsApp e segui la procedura nella finestra Meta:

Puoi anche partire da ChatGPT, Claude o un’altra app AI collegata: chiedi un link per collegare questo Agent a WhatsApp. Il link è valido per 10 minuti e funziona una volta sola, esclusivamente per l’account Quickchat che lo ha richiesto. Aprilo in un browser con accesso a quell’account, segui la configurazione Meta e completa l’eventuale selezione dell’account o del numero quando Quickchat si riapre. Poi chiedi all’app AI di controllare la configurazione e invia un vero messaggio WhatsApp per verificare che arrivi la risposta AI. Se colleghi più numeri, prova ciascun numero attivo. Autorizzi l’accesso a Meta nel browser, senza condividere token nella chat.

1. Accedi al tuo account Meta (Facebook).
2. Controlla i permessi che condividerai con Quickchat AI (accesso all’account WhatsApp Business e al portfolio business) e continua.
3. Fornisci dati aziendali accurati (portfolio business, nome dell’attività, sito web, Paese, ecc.).
4. Crea o seleziona il tuo account WhatsApp Business.
5. Scegli un nome visualizzato e una categoria per WhatsApp Business.
6. Aggiungi il numero di telefono aziendale e verificalo tramite SMS o chiamata vocale come richiesto.
7. Fai clic su Confirm per concedere a Quickchat AI l’accesso necessario.
8. Quando Meta conferma che la configurazione è completa, fai clic su Finish. La finestra mostra una conferma di Quickchat AI che l’account WhatsApp è stato collegato, poi si chiude automaticamente.

Se Meta concede a Quickchat AI l’accesso a più account, il pannello WhatsApp mostra Choose your WhatsApp Business Account invece di collegarsi subito. Scegli l’account su cui l’AI Agent deve rispondere e fai clic su Use this account. Se stai riconnettendo l’integrazione, la configurazione WhatsApp attuale rimane invariata fino alla conferma.

Tornando nell’app Quickchat AI, il pannello WhatsApp mostra Finish setup finché non viene verificato uno scambio riuscito sul tuo numero aziendale. Se il pannello non si aggiorna dopo circa 30 secondi, fai clic sull’icona di aggiornamento.

Il collegamento a Meta e la ricezione di un messaggio sono solo una parte della configurazione. Il pannello indica il passaggio successivo per ogni numero abilitato:

• Waiting for your first message: da un altro telefono, invia un messaggio WhatsApp al numero indicato, poi fai clic su Refresh. Assicurati di scrivere al numero aziendale che useranno i clienti.
• Waiting for the AI reply to be delivered: Quickchat ha ricevuto il messaggio, ma WhatsApp non ha ancora confermato la consegna della risposta AI. Controlla se la risposta è arrivata sull’altro telefono. In caso contrario, verifica i crediti AI e gli eventuali avvisi nel pannello, poi invia un altro messaggio di prova.
• AI reply delivered: WhatsApp ha confermato che la risposta AI a un messaggio in entrata è stata consegnata su questo numero aziendale.
• Verification needs attention: risolvi gli avvisi di connessione, mantieni abilitato il numero desiderato e invia un nuovo messaggio di prova.
• Display name: ogni numero elencato più in basso nel pannello mostra lo stato del nome visualizzato comunicato da Meta (Approved, Pending review, Declined, Expired o No display name). Una verifica in corso non richiede interventi e di solito termina in pochi giorni. Se il nome è rifiutato, scaduto o mancante, devi inviarne uno in WhatsApp Manager.
• Meta test number: i numeri +1 555 forniti da Meta e quelli sandbox non verificano l’attivazione del tuo numero aziendale. Aggiungi un tuo numero in WhatsApp Manager, abilitalo in Quickchat e poi provalo.

Il pannello mostra Live quando ogni numero aziendale abilitato ha uno scambio verificato e i controlli di connessione non rilevano problemi. Se abiliti più numeri aziendali, provali tutti. Uno scambio riuscito con un numero di prova, l’invio di un modello o un avviso sulla quota di messaggi non completano questa verifica.

Consiglio

Mantieni abilitata l’integrazione durante le prove. Invia un messaggio da un altro telefono a ciascun numero aziendale previsto, verifica che arrivi la risposta AI e fai clic su Refresh. La conversazione dovrebbe comparire anche nell’Inbox dell’app Quickchat AI. Una connessione esistente può richiedere un nuovo scambio di prova per verificare la consegna; può continuare a ricevere messaggi e rispondere mentre completi questo passaggio.

Se restano passaggi di onboarding Meta, completali in Setup guidance in WhatsApp Manager. Quickchat AI invia anche un promemoria via email al titolare dell’account quando la configurazione Meta non è terminata.

Risoluzione dei problemi e domande frequenti

Come funzionano i prezzi della WhatsApp Business API?

• WhatsApp considera le risposte alle richieste avviate dagli utenti (in entrata) come messaggi di servizio. Questi messaggi consentono alle aziende di gestire le richieste ricevute, tramite un operatore umano o un bot basato sull’AI conversazionale.
• Quando un utente scrive a un’azienda, si apre una finestra di assistenza clienti di 24 ore durante la quale l’azienda può rispondere con messaggi di servizio senza costi. La finestra riparte a ogni messaggio dell’utente.
• Oltre le 24 ore, devi usare modelli di messaggio approvati (Marketing, Utility, Authentication, ecc.) e pagare per messaggio secondo le tariffe della WhatsApp Business Platform.
• Meta classifica e fattura le conversazioni. Assicurati che l’account WhatsApp Business abbia un metodo di pagamento valido per i messaggi avviati dall’azienda o basati su modelli.

Il pulsante Connect WhatsApp non funziona. Non vedo la finestra Meta.

• Se il browser blocca il popup, consenti i popup per l’app Quickchat AI e fai clic su Try again. Puoi anche fare clic su Continue on Meta in this tab per completare la stessa configurazione senza popup.

Quickchat couldn’t confirm the WhatsApp connection

Quickchat mostra questo messaggio di ripristino quando la finestra Meta non restituisce un risultato e Quickchat non riesce ancora a verificare la connessione. Non dimostra che Meta non abbia apportato modifiche.

1. Verifica di essere amministratore dell’azienda Meta proprietaria dell’account WhatsApp Business. In caso contrario, chiedi a un amministratore di collegarlo dal proprio accesso Facebook.
2. Fai clic su Try again. Se un blocco interferisce con la finestra Meta, usa una finestra privata con le estensioni sospese oppure fai clic su Continue on Meta in this tab.
3. Se il numero è attivo in WhatsApp Messenger, rimuovilo prima da lì oppure usa un altro numero. Se è attivo nell’app WhatsApp Business, fermati e scrivi a support@quickchat.ai prima di procedere. L’attuale procedura di Quickchat AI non offre un percorso di Coexistence verificato. Non eliminare o scollegare l’account Business App e non migrare il numero per risolvere questo messaggio.
4. Se l’account WhatsApp Business usa Aircall, Twilio, 360dialog, MessageBird o un altro provider, aggiungi Quickchat AI come partner nelle impostazioni business di Meta:
   1. Apri Meta Business Settings e vai a Accounts → WhatsApp Accounts.
   2. Seleziona l’account WhatsApp Business, apri Partners e fai clic su Add Partners.
   3. Inserisci il Business ID di Quickchat AI: 270696274483463.
   4. Concedi Manage WhatsApp accounts, torna a Quickchat AI e aggiorna lo stato.

Scollega l’altro provider solo se Meta non consente entrambi i partner su quell’account. In caso di dubbio, contatta l’assistenza prima di scollegare un provider di messaggistica in uso.

La verifica del numero non è riuscita.

• Assicurati che il numero possa ricevere SMS o chiamate vocali.
• Un messaggio generico Ineligible o il suggerimento This number can’t be shared with this app non chiarisce la causa né se siano soddisfatti i requisiti di coesistenza di Meta. Scrivi a support@quickchat.ai riportando il messaggio esatto e il passaggio in cui è comparso.
• Se il numero è usato nell’app WhatsApp Business e devi conservare l’account e la sua cronologia, contatta l’assistenza prima di procedere. Non eliminare o scollegare l’account e non migrare il numero per tentare di cancellare l’errore.

Ho collegato l’account sbagliato.

• Reconnect conserva l’account già collegato. Per spostare l’AI Agent su un altro account WhatsApp Business, fai clic su Disconnect nel pannello WhatsApp, poi di nuovo su Connect WhatsApp e scegli gli account Meta Business e WhatsApp corretti nella finestra Meta.

We could not tell which WhatsApp Business Account to connect

• Il tuo accesso Meta include più account WhatsApp Business con numeri di telefono e Quickchat non ha potuto capire quale intendevi usare. Scrivi a support@quickchat.ai indicando il numero da collegare e completeremo la configurazione per te.

I messaggi non compaiono nell’Inbox di Quickchat AI.

• Verifica che il popup abbia mostrato il messaggio finale di conferma: “WhatsApp account connected!”.
• Controlla di aver collegato l’account WhatsApp previsto e selezionato l’AI Agent corretto.
• La scheda Waiting for your first message indica il numero su cui risponde l’AI Agent. Assicurati di aver scritto proprio a quel numero e che sia attivo nel pannello, poi fai clic su Refresh.
• Se invii messaggi dopo 24 ore senza un messaggio dell’utente, usa modelli approvati e verifica che sia impostato un metodo di pagamento in WhatsApp Manager.

L’invio delle risposte WhatsApp dell’AI non riesce.

Se le risposte AI non possono essere consegnate, Quickchat AI mostra l’avviso “WhatsApp replies are failing” nel pannello WhatsApp di External Apps e una notifica sulla dashboard. Ecco le cause e le soluzioni più comuni:

• Nome visualizzato non approvato su un numero di prova Meta: Meta trattiene le risposte da un numero +1 555 fornito da Meta finché il nome non è approvato. L’avviso del pannello diventa rosso e indica il numero. Attendi la fine della verifica (di solito pochi giorni) oppure, se il nome è stato rifiutato, inviane uno nuovo in WhatsApp Manager, poi invia un messaggio di prova. Un nome ancora in verifica su un tuo numero non blocca da solo le risposte; il pannello lo segnala come nota.
• Connessione scaduta o revocata: la connessione WhatsApp non è più valida. Apri il pannello WhatsApp e fai clic su Reconnect per riprendere a inviare risposte.
• Numero soggetto a restrizioni: Meta ha limitato il numero per la valutazione di qualità o un problema con le proprie regole. Controlla lo stato in WhatsApp Manager per ripristinare l’invio.
• Account Business bloccato (errore 131031): Meta ha bloccato le risposte dall’account WhatsApp Business. L’errore di consegna nell’Inbox e il pannello WhatsApp spiegano la restrizione. Apri Business Support Home, seleziona l’account WhatsApp, scegli la violazione e fai clic su Request Review: Meta rimuove un blocco dell’account solo tramite questa verifica. Ricollegare Quickchat non rimuove la restrizione.

Gli altri avvisi scompaiono automaticamente quando una risposta viene inviata di nuovo correttamente. L’avviso di blocco dell’account rimane finché un nuovo messaggio reale di un visitatore non riceve una risposta AI effettivamente consegnata, perché Meta può accettare una risposta e poi non consegnarla. Se sono attivi solo numeri di prova Meta (+1 555), basta il successivo invio riuscito di una risposta AI per cancellare l’avviso. Anche Support AI può spiegare un errore recente di blocco dell’account registrato, ma le prove storiche non dimostrano che l’account sia ancora bloccato.

I messaggi basati su modelli o avviati dall’azienda non vengono inviati.

• Verifica che i modelli di messaggio siano approvati e che il 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 i messaggi avviati dall’azienda, consulta la guida Meta ai Messaging Limits.
• Se la consegna è limitata, controlla limiti di messaggistica e valutazione di qualità in WhatsApp Manager.

Come creo un link WhatsApp e un pulsante “Chat on WhatsApp”?

• Segui questo tutorial WhatsApp.
• Oppure scarica i design ufficiali dei pulsanti WhatsApp e usa uno di questi script da inserire nella pagina:

<!-- WhatsApp inline button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
  aria-label="Chat on WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
>
  <img
    alt="Chat on WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
    "
  />
</a>

oppure

<!-- WhatsApp floating button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
  aria-label="Chat on WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
  style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"
>
  <img
    alt="Chat on WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
      box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px;
      transition: all 0.3s ease;
    "
    onmouseover="this.style.transform = 'scale(1.05)'"
    onmouseout="this.style.transform = 'scale(1)'"
  />
</a>

Come creo un codice QR WhatsApp?

• Vai a WhatsApp Manager → Phone numbers → seleziona il numero aziendale → Message links → Create Message Link.
• In alternativa, lo trovi nell’app mobile WhatsApp Business. Segui questo tutorial WhatsApp.

Devo scollegare l’account dell’app WhatsApp Business per risolvere i problemi di configurazione?

• No. Non eliminare o scollegare l’account Business App e non migrare il suo numero per risolvere un problema. L’attuale procedura di collegamento di Quickchat AI non offre un percorso di Coexistence verificato che preservi la configurazione e la cronologia dell’app esistente.
• Scrivi a support@quickchat.ai prima di modificare un account Business App in uso. La guida Meta all’onboarding della Business App descrive la coesistenza nelle integrazioni supportate; non ne conferma la disponibilità per la tua configurazione Quickchat AI.

Quale accesso ottiene Quickchat AI al nostro account WhatsApp Business?

• Accesso API limitato, non proprietà dell’account. Il tuo account WhatsApp Business (WABA) resta nel tuo Meta Business Manager. Nel modello WABA Sharing di Meta, sei tu a possedere le risorse e Quickchat AI viene aggiunto come partner, revocabile in qualsiasi momento da Business Manager.
• Finché l’integrazione è attiva, possiamo inviare e ricevere messaggi tramite la Cloud API e ricevere eventi dei messaggi tramite webhook.
• Non possiamo chiudere, trasferire o cambiare l’identità del tuo account, modificarne la fatturazione o rimuovere gli amministratori.

Hai bisogno di aiuto?

Parla con Support AI di Quickchat su WhatsApp:
📱 +1 302-405-9992: Avvia una chat

Oppure scansiona il codice QR: