Risoluzione Problemi

Soluzioni ai problemi più comuni con la connessione WhatsApp tramite Meta

Questa guida copre i problemi più comuni della connessione WhatsApp: prima quelli che possono bloccare la procedura di collegamento, poi i casi in cui l'agente connesso non risponde.

Problemi durante la connessione

Il browser sta bloccando l'apertura della finestra Meta.

Cerca l'icona di blocco popup nella barra degli indirizzi del browser
Clicca e consenti i popup da Leader24
Riprova cliccando di nuovo su Connetti WhatsApp

Connessione interrotta

Se chiudi il popup Meta a metà procedura, lo stato va perso e devi ricominciare. Non è un problema: riparti da Connetti WhatsApp e completa i passaggi senza interruzioni.

Se invece hai chiuso il popup sull'ultima schermata, dopo la conferma finale, la connessione è probabilmente andata a buon fine: controlla lo stato sulla card dell'agente prima di rifare tutto.

Numero già connesso a un altro agente

Ogni numero WhatsApp può essere collegato a un solo agente alla volta. Se il numero che stai collegando risulta già connesso:

Vai su WhatsApp nella sidebar
Trova l'agente attualmente collegato a quel numero
Clicca su Disconnetti
Ripeti la connessione sull'agente desiderato

Connessione salvata ma da verificare

Se la card dell'agente mostra "Credenziali salvate - verifica la connessione", il collegamento esiste ma il canale di ricezione messaggi (webhook) non risulta ancora verificato: l'agente potrebbe non ricevere i messaggi.

Apri Gestisci sulla card dell'agente
Usa la funzione di Test per verificare la connessione
Se il problema persiste, disconnetti e ripeti la procedura di connessione

Stato "Errore" sulla connessione

Se la card mostra lo stato Errore, la configurazione ha un problema (ad esempio un'autorizzazione revocata lato Meta).

Apri Gestisci sulla card e verifica la connessione con il Test
Se l'errore persiste, clicca su Disconnetti e ripeti la connessione da capo
Se il numero non si ricollega, contatta il supporto

Dopo la disconnessione

Potrebbe volerci qualche minuto prima che il numero sia nuovamente disponibile per una nuova connessione su WhatsApp.

L'agente non risponde ai messaggi

Se la connessione è Attiva ma l'agente non risponde, le cause più frequenti sono queste:

L'agente è disattivato

Verifica che l'agente sia attivo nella sezione Agenti. Un agente disattivato non risponde su nessun canale.

Sono configurati orari di risposta

Se per il canale WhatsApp hai impostato orari personalizzati invece di "Risponde 24/7", fuori orario l'agente non risponde ai messaggi.

Vai su WhatsApp nella sidebar
Sulla card dell'agente, apri gli orari di risposta
Controlla le fasce orarie configurate, o attiva Sempre attivo (24/7)

La finestra di 24 ore è chiusa

WhatsApp permette di rispondere liberamente solo entro 24 ore dall'ultimo messaggio del cliente. Passate le 24 ore, si possono inviare soltanto messaggi template approvati da Meta (modelli predefiniti, usati ad esempio per promemoria e follow-up); l'agente torna a rispondere liberamente non appena il cliente scrive di nuovo.

È una regola di WhatsApp, non un malfunzionamento. Nota per chi ha collegato il numero dell'app WhatsApp Business: i messaggi che invii a mano dall'app non aprono la finestra per l'agente.

Il telefono è rimasto inattivo (numero collegato all'app WhatsApp Business)

Se hai collegato il numero della tua app WhatsApp Business e il telefono resta inattivo per circa 14 giorni, Meta scollega il numero e l'agente smette di ricevere i messaggi. Apri l'app regolarmente sul telefono; se il numero è già stato scollegato, ripeti la procedura di connessione.

I clienti vedono il numero invece del nome dell'azienda

All'inizio è normale: Meta mostra il nome dell'attività al posto del numero solo dopo aver verificato il nome visualizzato (display name), una revisione che parte automaticamente man mano che il tuo numero cresce. Non devi fare nulla: se Meta rifiuta il nome, ti chiederà di modificarlo.

Contattare il supporto

Se il problema persiste:

Annota data e ora dell'errore
Fai uno screenshot dello stato della connessione
Contatta il supporto dalla dashboard o scrivi a info@leader24.ai