Registro errori
Il Registro errori è un elenco cronologico di tutto ciò che non ha funzionato nel tuo account: un messaggio che non è stato possibile consegnare, una risposta dell’IA mai inviata, un canale che ha perso la connessione, un’importazione fallita a metà.
Ogni voce contiene un breve codice, una spiegazione in parole semplici e cosa fare al riguardo: così, quando qualcosa sembra non funzionare, puoi vedere tu stesso il motivo e risolverlo, invece di scrivere all’assistenza e aspettare una risposta. È anche il modo più rapido per distinguere un vero problema da qualcosa che si è comportato esattamente come previsto (un contatto che ha scelto di non ricevere messaggi, una finestra di risposta chiusa).
Dove trovarla
Nel menu principale sul lato sinistro dello schermo, in fondo, fai clic su Registro errori: si trova appena sopra Aiuto. (Su un telefono, tocca prima l’icona del menu ☰, quindi Registro errori.)
Leggere una riga
Ogni riga rappresenta un elemento che non è riuscito, dal più recente al meno recente.
| Parte della riga | Cosa ti dice |
|---|---|
| Ora | Quanto tempo fa è successo. Passaci sopra con il mouse per vedere data e ora esatte. |
| Codice | Il breve codice per questo tipo di errore, ad esempio TW-63016. Fai clic per copiarlo. Ogni codice è spiegato di seguito. |
| Categoria e canale | L’area di appartenenza (consegna, IA, canale, fatturazione, ecc.) e il canale su cui si è verificato. |
| Cosa è successo | L’errore in una riga, con un link al contatto quando disponibile. |
| Cosa fare | La soluzione, in una riga. |
Fai clic su una riga per espanderla. La riga espansa aggiunge la spiegazione completa, il messaggio del provider (se presente), il codice numerico del provider e pulsanti che ti portano direttamente al punto in cui puoi risolvere il problema: Apri chat, Vai ai canali e simili. Informazioni su questo codice apre questa pagina in corrispondenza della voce relativa a quel codice.
Filtri
Sopra l’elenco puoi restringere il campo:
- Intervallo di tempo — 24 ore, 7 giorni o 30 giorni. Si apre su 7 giorni e ricorda l’intervallo scelto.
- Chip di categoria — un chip per categoria, ognuno con il numero di voci nell’intervallo. Fai clic per mostrare solo quella categoria.
- Canale — limita l’elenco a un canale, ad esempio WhatsApp o Instagram.
- Solo errori — nasconde avvisi e voci puramente informative, lasciando solo ciò che ha effettivamente fallito.
- Cerca — digita il nome o il numero di un contatto, o un codice, per trovare una voce specifica.
Cosa copre il registro
- Messaggi che non è stato possibile consegnare, su ogni canale: WhatsApp Business, WhatsApp Web, SMS, Instagram, Messenger, Telegram ed email. L’avviso via email per un invio fallito indica il contatto e il relativo numero, il nome dell’account in cui si è verificato l’errore (se ne gestisci diversi) e include un pulsante Apri conversazione che ti porta direttamente nella chat.
- Volte in cui l’IA non ha risposto, e perché: nessun agente era impostato per rispondere, i crediti erano esauriti, è stato raggiunto un limite, l’orario era chiuso o l’IA non è riuscita a generare una risposta nemmeno dopo aver riprovato.
- Problemi di canale: una sessione WhatsApp Web disconnessa, un accesso scaduto, un limite di invio raggiunto.
- Fatturazione e limiti: un pagamento scaduto, invio in pausa, saldo crediti esaurito, limite di contatti raggiunto.
- Importazioni della knowledge base fallite.
- Broadcast (incluse le voci delle campagne classiche) messi in pausa automaticamente.
- Esecuzioni di automazioni interrotte con un errore.
- Webhook che non funzionano o che sono stati disattivati dopo ripetuti errori.
- Calendari delle stanze che non è stato possibile leggere.
Cosa non copre
- Tutto ciò che ha funzionato. Il registro elenca solo i fallimenti, quindi una pagina vuota è una buona notizia.
- Interruzioni dell’intera piattaforma. Se diverse cose non correlate falliscono contemporaneamente, controlla prima lo Stato del sistema.
- Risultati per destinatario di un broadcast. Per sapere come ha performato un invio nel complesso, apri il broadcast stesso: vedi Broadcast.
Lettura del registro tramite API
Le stesse voci sono disponibili tramite API all’indirizzo GET /v1/error-log e per gli assistenti IA collegati tramite il server MCP come strumento list_error_log_entries.
Quando contattare l’assistenza
La maggior parte delle voci indica esattamente cosa modificare e puoi farlo autonomamente. Quando una voce suggerisce di mettersi in contatto, o se lo stesso codice continua a comparire dopo aver applicato la correzione, contatta l’assistenza includendo il codice e l’orario in cui si è verificato (copiali direttamente dalla riga). Di solito è sufficiente per permetterci di individuare il problema senza ulteriori scambi.
Tutti i codici di errore
La prima parte di un codice indica l’origine dell’errore:
- TW — Twilio, il provider dietro WhatsApp Business e SMS. Il numero che segue è il codice di errore di Twilio.
- META — WhatsApp Business tramite Meta. Il numero è il codice di errore di Meta.
- WAW — WhatsApp Web.
- APP — Codici propri di Your AI Connector, usati per tutto ciò per cui un provider non ha fornito un numero.
Ogni codice qui sotto ha il proprio link, quindi Informazioni su questo codice nell’app rimanda alla voce esatta.
WhatsApp Business (Twilio)
| Codice | Significato | Cosa fare |
|---|---|---|
TW-63005 |
WhatsApp ha rifiutato il contenuto del messaggio. WhatsApp ha rifiutato il contenuto di questo messaggio. | Controlla il testo del messaggio, eventuali file multimediali e l’intestazione e le variabili del modello, quindi invia di nuovo. |
TW-63007 |
Numero mittente non connesso. Questo messaggio è stato inviato da un numero non connesso come mittente WhatsApp. | Riconnetti il numero in Impostazioni → Canali, quindi riprova. |
TW-63012 |
Problema temporaneo di WhatsApp. WhatsApp ha riscontrato un problema temporaneo. | Riprova a inviare tra qualche minuto. |
TW-63016 |
Finestra di risposta di 24 ore chiusa. La finestra di risposta di 24 ore con questo contatto è chiusa, pertanto non è possibile consegnare un messaggio a formato libero. | Invia un modello approvato per riaprire la conversazione. |
TW-63021 |
Contenuto non accettato da WhatsApp. Il contenuto non ha superato i controlli di WhatsApp: tipo di messaggio non supportato, file multimediale troppo grande o non accessibile pubblicamente, oppure intestazione o testo del pulsante oltre il limite di caratteri. | Verifica che i link ai file multimediali si aprano in una finestra del browser in incognito, accorcia le etichette dei pulsanti e mantieni il corpo del modello sotto i 1.024 caratteri. |
TW-63024 |
Il numero non può ricevere messaggi WhatsApp. Questo numero non può ricevere messaggi WhatsApp. Potrebbe non essere su WhatsApp o la persona non ha accettato gli ultimi termini di WhatsApp. | Conferma il numero con il contatto o raggiungilo tramite SMS o email. |
TW-63027 |
Modello non disponibile in questa lingua. Il modello non esiste nella lingua in cui è stato inviato. | Scegli un modello approvato nella lingua del contatto o creane uno in quella lingua in Modelli. |
TW-63032 |
Bloccato da un esperimento di Meta. WhatsApp non consegnerà il messaggio a questo numero perché Meta lo ha incluso in un esperimento della piattaforma. | Non c’è nulla da correggere da parte tua. Se è urgente, contatta il destinatario su un altro canale. |
TW-63049 |
Modello di marketing bloccato da Meta. Meta ha bloccato questo modello di marketing. I modelli di marketing non possono più essere consegnati ai numeri statunitensi. Altrove, di solito si tratta di un limite temporaneo al numero di messaggi di marketing che quella persona può ricevere. | Per i contatti negli Stati Uniti, usa SMS o email. Per altri paesi, riprova più tardi. |
TW-63050 |
Il contatto ha rifiutato i messaggi di marketing. Questa persona ha scelto di non ricevere messaggi di marketing dalla tua azienda su WhatsApp. | Non riceverà più modelli di marketing finché non darà nuovamente il consenso. I messaggi di utilità e servizio continueranno a funzionare. |
TW-63051 |
Mittente WhatsApp bloccato da Meta. Questo mittente WhatsApp è bloccato da Meta. Di solito accade dopo 30 giorni senza invio di messaggi. | Contatta l’assistenza per farlo registrare nuovamente. |
TW-63058 |
Paese non consentito per la messaggistica aziendale. WhatsApp non consente la messaggistica aziendale verso i destinatari in questo paese. | Raggiungi il contatto tramite SMS o email. |
TW-21211 |
Numero di telefono non valido. Il numero di telefono del contatto non è valido: manca il prefisso internazionale, c’è un errore di battitura o cifre in eccesso. | Apri il contatto e correggi il numero nel formato internazionale, ad esempio +14155551234. |
TW-21212 |
Nessun mittente approvato su questo account. Il numero da cui è stato inviato questo messaggio non è un mittente WhatsApp approvato, quindi il provider lo ha rifiutato. | Apri Impostazioni → Canali e verifica che il tuo numero WhatsApp Business sia connesso e approvato. Se risulta connesso, contatta l’assistenza e cita questo codice. |
TW-21408 |
Paese di destinazione non abilitato. L’invio verso il paese del contatto è disattivato sull’account mittente. | Per gli SMS con il tuo account Twilio, abilita il paese in Messaggistica → Impostazioni → Autorizzazioni geografiche nella console Twilio. Per WhatsApp, contatta l’assistenza. |
TW-21602 |
Messaggio vuoto. Il messaggio non conteneva testo, quindi non è stato possibile inviarlo. | Aggiungi del testo al messaggio e invia di nuovo. |
TW-21610 |
Il contatto ha risposto STOP. Questa persona ha inviato STOP al tuo numero, quindi gli operatori bloccano ulteriori messaggi verso di lei. | Rimuovila dalle tue liste. Può inviare START al tuo numero per dare nuovamente il consenso. |
TW-21656 |
Le variabili del modello non corrispondono. I valori inseriti nel modello non corrispondono ai suoi segnaposto: manca un valore, è vuoto o contiene interruzioni di riga. | Verifica che ogni variabile abbia un valore e nessuna interruzione di riga, quindi reinvia. |
TW-21703 |
Nessun mittente disponibile per questa destinazione. L’account non dispone di un mittente in grado di raggiungere il paese di questo contatto con questo tipo di messaggio. | Controlla il numero in Impostazioni → Canali. Se è connesso e approvato, contatta l’assistenza e cita questo codice. |
SMS (Twilio)
WhatsApp Business (Meta)
| Codice | Significato | Cosa fare |
|---|---|---|
META-131026 |
Messaggio non consegnabile. WhatsApp non è riuscito a consegnare questo messaggio. Il numero potrebbe non essere su WhatsApp, la persona potrebbe non aver accettato gli ultimi termini o la sua app è molto obsoleta. | Conferma il numero con il contatto o raggiungilo in un altro modo. |
META-131047 |
Finestra di risposta di 24 ore chiusa. Sono trascorse più di 24 ore dall’ultimo messaggio del contatto, quindi non è possibile consegnare un messaggio a formato libero. | Invia un modello approvato per riaprire la conversazione. |
META-131049 |
Messaggio di marketing bloccato da Meta. Meta non ha consegnato questo messaggio di marketing per mantenere sano il coinvolgimento. Il contatto ha raggiunto il suo limite di messaggi di marketing per il momento. | Attendi almeno 24 ore prima di inviare nuovamente modelli di marketing a questo contatto. |
META-131053 |
Impossibile caricare il file multimediale. Il file multimediale allegato a questo messaggio non è stato caricato su WhatsApp. | Verifica che il tipo di file sia supportato e che il link si apra pubblicamente, quindi reinvia. |
META-131056 |
Troppi messaggi verso questo contatto. Sono stati inviati troppi messaggi a questo contatto in un breve periodo. | Attendi un po’ prima di inviare nuovamente messaggi a questo contatto. |
META-132000 |
Le variabili del modello non corrispondono. Il numero di valori inseriti nel modello non corrisponde ai segnaposto del modello. | Verifica che ogni segnaposto abbia un valore, quindi reinvia. |
META-132001 |
Modello non trovato o non approvato. Il modello non esiste in questa lingua o non è ancora stato approvato. | Scegli un modello approvato nella lingua del contatto in Modelli. |
META-132015 |
Modello sospeso per bassa qualità. Meta ha sospeso questo modello a causa di valutazioni di bassa qualità. | Modifica il modello per migliorarlo e invialo nuovamente; nel frattempo usa un altro modello approvato. |
META-130472 |
Bloccato da un esperimento di Meta. Meta non ha inviato questo messaggio come parte di un esperimento della piattaforma. | Non c’è nulla da correggere da parte tua. |
META-133010 |
Numero non registrato con WhatsApp Business. Il numero mittente non è registrato sulla piattaforma WhatsApp Business. | Riconnetti il numero in Impostazioni → Canali. Se il problema persiste, contatta l’assistenza. |
Messenger e Instagram
| Codice | Cosa significa | Cosa fare |
|---|---|---|
APP-1901 |
Conflitto di automazione della pagina Facebook. Facebook non ha consentito l’invio di questa risposta perché un’altra app o le risposte automatiche di Facebook controllano attualmente questa conversazione. | Nelle impostazioni della tua Pagina Facebook, disattiva le risposte automatiche di Facebook, quindi apri Impostazioni pagina → Messaggistica avanzata → Protocollo di trasferimento e fai clic su Configura accanto a Ricevitore Messenger (o Ricevitore Instagram) per rendere l’app collegata il ricevitore principale. Quindi riprova a rispondere. |
APP-1902 |
Finestra di 24 ore di Meta chiusa. Instagram e Messenger consentono risposte solo entro 24 ore dall’ultimo messaggio del contatto. Questo contatto non risponde da più di un giorno, quindi Meta ha bloccato il messaggio. | Attendi che il contatto scriva di nuovo. I modelli non esistono su questi canali; contatta l’utente tramite WhatsApp, SMS o email se la questione è urgente. |
APP-1903 |
Il commento ha già una risposta privata. Meta consente una risposta privata per commento e questo commento ne ha già ricevuta una. | Nulla da correggere. Continua nella conversazione DM del contatto. |
APP-1904 |
Commento non più disponibile. Il commento è stato eliminato o è troppo vecchio per una risposta privata (Instagram consente risposte private per 7 giorni). | Nulla da correggere. |
APP-1905 |
Autorizzazione Facebook o Instagram mancante. Meta ha rifiutato il messaggio perché alla connessione manca un’autorizzazione. | Riconnetti l’account in Impostazioni → Canali e accetta tutte le autorizzazioni. Per Instagram, verifica anche che l’account sia un account professionale collegato alla tua Pagina Facebook e che “Consenti l’accesso ai messaggi” sia attivo nell’app Instagram. |
APP-1906 |
Accesso a Facebook o Instagram scaduto. Il token di accesso per questa Pagina o account Instagram è scaduto o è stato revocato, quindi non è possibile inviare nulla. | Riconnetti l’account in Impostazioni → Canali. |
APP-1907 |
Contatto non più raggiungibile. Meta non trova più questa conversazione o persona. Potrebbero averti bloccato, aver eliminato il loro account o rimosso la conversazione. | Nulla da correggere. |
APP-1908 |
Errore temporaneo di Meta. Meta ha riscontrato un problema temporaneo. | Riprova tra qualche minuto. |
APP-1909 |
Meta ha rifiutato questo messaggio. Meta ha rifiutato questo messaggio per il motivo mostrato nella riga espansa. | Leggi i dettagli; se non sono chiari, contatta l’assistenza e cita questo codice. |
WhatsApp Web
| Codice | Cosa significa | Cosa fare |
|---|---|---|
WAW-463 |
WhatsApp sta limitando i messaggi a questo contatto. Potrebbe aver bloccato questo numero, oppure si tratta di una nuova conversazione che WhatsApp non consente ancora da questo account. | Attendi e riprova più tardi, oppure contatta l’utente in un altro modo. I nuovi numeri dovrebbero essere utilizzati gradualmente. |
WAW-479 |
Problema temporaneo di connessione a WhatsApp. | Prova a inviare di nuovo. |
APP-1101 |
WhatsApp Web non è connesso. Il messaggio non è stato inviato perché la connessione a WhatsApp Web era interrotta in quel momento. | Apri Impostazioni → Canali e fai clic su Riconnetti, quindi scansiona il codice QR con il telefono. In seguito, invia nuovamente il messaggio. |
APP-1102 |
Nessun numero WhatsApp connesso. Questo account non ha alcun numero WhatsApp connesso, quindi il messaggio non aveva un destinatario. | Connetti un numero in Impostazioni → Canali. |
APP-1103 |
Inviato tramite la connessione WhatsApp errata. Questa conversazione è associata al tuo numero WhatsApp Web, ma il messaggio è stato inviato tramite WhatsApp Business. | Rispondi direttamente dalla chat in modo che utilizzi il canale specifico della conversazione. |
APP-1104 |
Mittente WhatsApp Business non configurato. L’account ha tentato l’invio tramite WhatsApp Business, ma non è configurato alcun numero WhatsApp Business. | Connetti un numero WhatsApp Business in Impostazioni → Canali, oppure sposta il contatto su un canale che hai connesso. Se un numero è connesso, contatta l’assistenza e cita questo codice. |
APP-1105 |
WhatsApp non ha confermato il messaggio. Il messaggio è stato inoltrato a WhatsApp Web, ma WhatsApp non ne ha mai confermato la ricezione, quindi molto probabilmente non ha raggiunto il contatto. Di solito significa che la connessione a WhatsApp Web è caduta per un momento durante l’invio. | Verifica che il numero WhatsApp Web risulti connesso in Impostazioni → Canali, quindi invia nuovamente il messaggio. |
APP-1201 |
Numero di telefono non valido. Non è stato possibile convalidare il numero di telefono del contatto. | Apri il contatto e correggi il numero nel formato internazionale. |
APP-1301 |
Raggiunto il limite giornaliero di nuovi contatti. (avviso) Questo numero WhatsApp Web ha raggiunto il limite odierno per l’invio di messaggi a persone che non lo hanno mai contattato. Il limite esiste per proteggere il numero dal ban. | Attendi fino a domani. Il limite aumenta man mano che il numero viene utilizzato. Consulta Scaling WhatsApp outreach safely. |
APP-1401 |
Nessun modello approvato allegato. È stato inviato un messaggio modello senza un modello approvato. | Seleziona un modello approvato in Modelli e invia di nuovo. |
Altri canali
| Codice | Cosa significa | Cosa fare |
|---|---|---|
APP-1501 |
Indirizzo email rifiutato. Il server di posta del destinatario ha rifiutato l’indirizzo. | Controlla che non ci siano errori di battitura nell’indirizzo email del contatto. |
APP-1502 |
Nessuna casella email collegata. Questo account non ha una casella email collegata da cui inviare. | Collegane una in Impostazioni → Canali → Email. |
APP-1503 |
Impossibile inviare l’email. L’email non è stata inviata per il motivo indicato nella riga espansa. | Controlla le impostazioni del tuo provider email in Impostazioni → Provider email personalizzato. |
APP-1601 |
Sessione Telegram scaduta. L’accesso a Telegram per questo account è terminato, solitamente dalle sessioni attive dell’app Telegram. | Ricollega Telegram in Impostazioni → Canali. |
APP-1602 |
Bloccato su Telegram. Una delle due parti ha bloccato l’altra su Telegram, quindi il messaggio non può essere consegnato. | Non c’è nulla da correggere da qui. |
APP-1603 |
Messaggio Telegram non riuscito. Telegram non ha accettato questo messaggio. | Riprova; se il problema persiste, ricollega Telegram in Impostazioni → Canali. |
APP-1701 |
SMS non configurato. Questo account non ha un mittente SMS collegato. | Collega il tuo account Twilio o il telefono Android in Impostazioni → Provider SMS. |
APP-2001 |
Invio in pausa: fatturazione. I messaggi in uscita sono in pausa a causa di una fattura non pagata o di un abbonamento bloccato. | Regolarizza il pagamento in Impostazioni → Fatturazione; l’invio riprenderà automaticamente. |
APP-9001 |
Consegna non riuscita. Il messaggio non è stato consegnato. Il motivo fornito dal provider, quando disponibile, è mostrato nella riga espansa. | Riprova; se continua a succedere, contatta l’assistenza citando questo codice e l’orario. |
AI
Quando l’IA non fornisce alcuna risposta, riprova automaticamente un paio di volte. Se continua a non rispondere, la conversazione mostra una nota e il registro degli errori riceve una voce APP-3306. Una chat che l’agente ha passato a una persona (ha avvisato un collega o ha concluso la chat) non conta: l’IA in quel caso rimane in silenzio di proposito, quindi non viene mostrata alcuna nota né viene aggiunta alcuna voce APP-3306.
Canali
Fatturazione e limiti
Knowledge Base
Broadcast e campagne
| Codice | Cosa significa | Cosa fare |
|---|---|---|
APP-5101 |
Agente messo in pausa automaticamente. L’agente ha smesso di inviare messaggi a nuove persone perché troppo poche hanno risposto, il che mette a rischio il numero. | Controlla chi sta contattando l’agente e il suo messaggio di apertura, quindi riattiva l’agente dalla sua pagina. |
APP-5102 |
Il sistema di protezione invii ha interrotto un broadcast. Il broadcast è stato interrotto perché sembrava rivolto a persone che non ti hanno mai scritto, il che mette a rischio il numero. | Rivedi il pubblico, quindi riprendi dalla pagina del broadcast. |
APP-5103 |
Avviso del sistema di protezione invii. (avviso) Un broadcast sta inviando messaggi a molte persone che non ti hanno mai scritto. | Mantieni il pubblico attivo e il volume graduale. Vedi Scaling WhatsApp outreach safely. |
APP-5104 |
Broadcast messo in pausa automaticamente. Il broadcast è stato messo in pausa dopo ripetuti errori. | Risolvi la causa mostrata nei fallimenti di consegna, quindi riprendi. |
Automazioni
| Codice | Cosa significa | Cosa fare |
|---|---|---|
APP-5001 |
L’automazione richiede la tua attenzione. Un’automazione ha generato un avviso che richiede l’intervento umano. | Apri la chat o l’automazione collegata. |
APP-5201 |
Esecuzione dell’automazione non riuscita. Un’esecuzione di questa automazione si è interrotta con un errore; il messaggio del passaggio viene mostrato nella riga espansa. | Apri l’esecuzione per vedere quale passaggio non è riuscito, correggi le sue impostazioni e riavvia l’esecuzione. Attiva Automazione non riuscita in Notifiche per ricevere un avviso quando ciò accade. |
Integrazioni
Appuntamenti
Prossimi passi
- Stato del sistema — controlla se il problema dipende da noi.
- Notifiche — scegli quali errori ricevere anche via email, push o tramite la notifica a campanella.
- Webhook — invia eventi ai tuoi sistemi.