Risoluzione dei problemi di consegna dei messaggi WhatsApp
Le istruzioni riportate di seguito sono valide solo per desktop e laptop.
Questa guida ti aiuta a risolvere i problemi più comuni relativi alla consegna dei messaggi WhatsApp nella Inbox di tawk.to. Copre le aree di troubleshooting più frequenti, tra cui:
- Indicatori di stato di consegna dei messaggi
- Stato di connessione di WhatsApp
- Finestra di messaggistica di 24 ore
- Requisiti dei template dei messaggi
- Problemi di validazione del numero di telefono
- Limiti per gli allegati
- Errori di invio e sincronizzazione dei template
- Selezione dei contatti e messaggi di errore comuni
Fai clic sulla scheda WhatsApp Numbers e controlla la colonna Status:
- Connected — il numero è pronto all’uso.
- Disconnected — i messaggi non possono essere inviati.
Come risolvere i problemi di connessione“Inbox is disconnected”
Questo significa che il numero WhatsApp non è più connesso.
Fai clic sul menu a tre puntini (⋮) accanto al numero e seleziona Connect.
Quindi completa l’autenticazione su Facebook (Meta).
Il numero rimane disconnesso dopo l’autenticazione
Disconnetti prima il numero, quindi riconnettilo e autenticalo di nuovo.
Assicurati che il tuo account Meta Business sia attivo e che tu abbia accesso da amministratore al WhatsApp Business Account (WABA).
Consulta questa guida per i passaggi su come disconnettere e riconnettere i numeri WhatsApp: Aggiornare le impostazioni di WhatsApp.
Comprendere la finestra di messaggistica di 24 ore
WhatsApp limita i momenti in cui le aziende possono inviare messaggi non strutturati (free-form) ai clienti.
Come funziona
Come riconoscere una conversazione inattiva
- Nel campo di inserimento del messaggio compare la scritta “Conversation is inactive”, oppure
- Appare un pulsante Select Template nel campo di risposta.
Come riaprire la conversazione
- Clicca Select Template.
- Scegli un WhatsApp Message Template pre-approvato.
- Compila eventuali campi richiesti e invia.
Quando il cliente risponde, la conversazione torna attiva e la finestra di 24 ore si resetta.
Risolvere gli errori di invio dei template
I template devono rispettare i requisiti di approvazione di WhatsApp prima di poter essere inviati.
Come funzionaWhatsApp consente l’invio di messaggi template solo se sono stati approvati in Meta Business Manager. Ogni template può anche includere parametri obbligatori.
Quando i template sono richiesti- Primo messaggio a un nuovo contatto: devi utilizzare un WhatsApp Message Template pre-approvato.
- Dopo che il cliente risponde: puoi inviare messaggi non strutturati entro la finestra di 24 ore.
- Il template non è approvato.
- Mancano parametri obbligatori.
- I valori dei parametri non sono validi.
- Il template è stato eliminato o è scaduto.
Vai alla pagina WhatsApp Settings e apri la scheda Templates.
Verifica che lo stato del template sia Approved.
Assicurati che tutti i parametri obbligatori siano compilati correttamente.
Se necessario, verifica il template in Meta Business Manager per accertarti che sia ancora attivo.
Risolvere problemi di sincronizzazione dei template
I template devono sincronizzarsi correttamente da Meta Business Manager per comparire in tawk.to.
Perché i template potrebbero non apparire- I template non sono approvati.
- Il WABA non dispone delle autorizzazioni necessarie.
- L’autorizzazione dell’account WhatsApp è scaduta.
Apri la pagina WhatsApp Settings e seleziona la scheda Templates.
Fai clic su Sync Templates.
Solo i template con stato “Approved” si sincronizzeranno e appariranno in tawk.to.
Questo errore di solito significa che l’account WhatsApp non è più autorizzato.
Come risolvere:Ri-autentica l’account WABA disconnettendolo e riconnettendolo nella scheda WhatsApp Numbers, quindi prova di nuovo a sincronizzare i template.
Comprendere gli indicatori di stato di consegna dei messaggiOgni messaggio WhatsApp mostra lo stato di consegna tramite icone di stato.
Cosa significano gli stati
- Sending (◯) — Il messaggio è in fase di invio.
- Sent (✓) — Il messaggio ha raggiunto i server di WhatsApp.
- Delivered (✓✓ grigio) — Il messaggio ha raggiunto il dispositivo del destinatario.
- Read (✓✓ verde) — Il destinatario ha aperto il messaggio.
- Failed (⚠️) — Il messaggio non è stato consegnato.
- Controlla lo stato di connessione di WhatsApp.
- Verifica il formato del numero di telefono.
- Conferma che il cliente non abbia bloccato la tua attività.
- Riprova a inviare il messaggio dopo aver risolto il problema.
WhatsApp richiede che i numeri di telefono seguano un formato rigoroso. Ogni contatto deve avere un numero valido abilitato a WhatsApp salvato nel formato corretto prima che tu possa inviare un messaggio.
Requisiti del formato del numero di telefonoUsa il formato E.164
Includi il prefisso internazionale con il + inizialeEsempio: +1234567890
Errori comuni e come risolverli
“Please select a phone number before sending”
Seleziona un numero di telefono dalla lista dei numeri del contatto nell’Inbox.Invalid phone number
Verifica che il numero includa il prefisso internazionale corretto e sia nel formato E.164.
Il messaggio fallisce ancora dopo la correzione
Assicurati che il numero sia attivo su WhatsApp e possa ricevere messaggi.
Limiti di allegati e formati supportatiWhatsApp applica limiti alla dimensione e al tipo di file che puoi inviare. Ogni tipo di file ha una dimensione massima e formati supportati specifici. I messaggi falliscono se il file supera il limite o usa un formato non supportato.
Tipi di file supportati e limiti
- Immagini: JPG, PNG — fino a 5 MB
- Video: MP4, 3GP — fino a 16 MB
- Documenti: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT — fino a 50 MB
- Messaggi vocali: OGG/OPUS — fino a 16 MB
- File audio: AAC, AMR, MP3, M4A, OGG — fino a 16 MB
“File size exceeded”
Comprimi il file o invia una versione più piccola.“File type not supported”
Converti il file in uno dei formati supportati e riprova.
Risolvere errori di selezione del contatto
Un contatto deve essere selezionato prima che tu possa inviare un messaggio WhatsApp.
Come funzionaOgni messaggio è collegato a un record contatto. Se non viene selezionato alcun contatto, l’invio dei messaggi è disabilitato.
Errori comuni e soluzioni“Please select a contact before sending”
Seleziona prima un contatto dal selettore contatti.Contatto senza numero di telefono
Aggiungi un numero WhatsApp valido al contatto.
Se il contatto non esiste, crea un nuovo contatto e aggiungi il numero prima di inviare il messaggio.
Risolvere errori di autenticazione e autorizzazio
neI problemi di autenticazione impediscono alle funzionalità WhatsApp di funzionare correttamente.
Errori comuni- “whatsapp provider account unauthorized”
- “Failed to sync templates… Please re-authenticate the connection.”
Vai su WhatsApp Settings > WhatsApp Numbers.
Disconnettere e riconnettere l’accountFai clic sul menu a tre puntini (⋮) accanto all’account e seleziona Disconnect.
Quindi fai clic su Connect e completa l’autenticazione su Facebook utilizzando un account con permessi admin.
Input del messaggio disabilitato — cosa significa
A volte la casella di inserimento messaggi è disabilitata e mostra un messaggio segnaposto.
- “Inbox is disconnected” — Riconnetti il numero WhatsApp.
- “Please select a phone number first” — Scegli un numero di telefono per il contatto.
- “Conversation is inactive” — Invia un template per riaprire la conversazione.
- “Select a Message Template to start the conversation” — Il primo messaggio richiede un template.
provider account not found
Verifica l’Account ID in Meta Business Manager.phone number resource not found
Conferma che il numero di telefono sia completamente registrato con l’API di WhatsApp.
phone number resource already connected
Il numero di telefono è collegato a un’altra proprietà o servizio.
invalid provider account token
Il token è scaduto. Ri-autentica la connessione WhatsApp.
whatsapp provider account unauthorized
Riconnetti il WhatsApp Business Account con permessi admin.
Best practice per evitare problemi di consegna
- Controlla regolarmente lo stato di connessione di WhatsApp.
- Mantieni i template approvati e aggiornati.
- Monitora gli stati di consegna dei messaggi e intervieni subito in caso di errori.
- Salva i numeri di telefono nel formato E.164.
- Usa i template per il primo contatto e per le conversazioni inattive.
- Comprimi i file prima di caricarli per rispettare i limiti di dimensione.
Se i problemi persistono:
- Conferma che il corretto WhatsApp Business Account sia collegato alla tua proprietà tawk.to.
- Assicurati che l’account Meta utilizzato durante l’autenticazione abbia permessi admin.
- Se un numero di telefono risulta già connesso, potrebbe essere ancora collegato a un’altra proprietà e deve essere disconnesso prima di poterlo riutilizzare.
Guide correlate:
- Aggiornare le impostazioni di WhatsApp
- Utilizzare i template di WhatsApp
- Guida di WhatsApp per l’invio e la ricezione dei messaggi
Se hai commenti su questo articolo o hai bisogno di ulteriore assistenza:
Contattaci via live chat
Prenota una chiamata con il nostro team
Visita la nostra community