Your AI Connector Docs

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, email e LinkedIn.
  • Volte in cui l’IA non ha risposto, e perché: nessun agente impostato per rispondere, crediti esauriti, limite raggiunto, orario di lavoro chiuso.
  • Problemi del 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 vuoto, limite contatti raggiunto.
  • Importazioni della knowledge base fallite.
  • Broadcast e campagne messi in pausa automaticamente.
  • Esecuzioni di automazione interrotte con un errore.
  • Webhook che falliscono 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.

Quando contattare l’assistenza

Most entries tell you exactly what to change, and you can do it yourself. When an entry says to get in touch, or the same code keeps coming back after you’ve followed the fix, contact support and include the code and the time it happened (copy them straight from the row). That’s usually enough for us to find it without any back and forth.

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)

Code What it means What to do
TW-63005 WhatsApp rejected the message content. WhatsApp rejected the content of this message. Check the message text, any media, and the template’s header and variables, then send again.
TW-63007 Sender number is not connected. This message was sent from a number that is not connected as a WhatsApp sender. Reconnect the number under Settings → Channels, then try again.
TW-63012 Temporary WhatsApp problem. WhatsApp had a temporary problem on their side. Try sending again in a few minutes.
TW-63016 24-hour reply window closed. The 24-hour reply window with this contact has closed, so a free-form message cannot be delivered. Send an approved template to reopen the conversation.
TW-63021 Content not accepted by WhatsApp. The content did not pass WhatsApp’s checks: an unsupported message type, media that is too large or not publicly reachable, or a header or button text over the length limit. Check that media links open in a private browser window, shorten button labels, and keep template bodies under 1,024 characters.
TW-63024 Number cannot receive WhatsApp messages. This number cannot receive WhatsApp messages. It may not be on WhatsApp, or the person has not accepted WhatsApp’s latest terms. Confirm the number with the contact, or reach them by SMS or email.
TW-63027 Template not available in this language. The template does not exist in the language it was sent in. Pick a template approved in the contact’s language, or create one in that language under Templates.
TW-63032 Blocked by a Meta experiment. WhatsApp will not deliver to this number because Meta has included it in a platform experiment. There is nothing to fix on your side. Reach the contact on another channel if it is urgent.
TW-63049 Marketing template blocked by Meta. Meta blocked this marketing template. Marketing templates can no longer be delivered to US numbers. Elsewhere this is usually a temporary cap on how many marketing messages that person can receive. For US contacts use SMS or email. For other countries, try again later.
TW-63050 Contact opted out of marketing. This person opted out of marketing messages from your business on WhatsApp. They will not receive marketing templates again until they opt back in. Utility and service messages still work.
TW-63051 WhatsApp sender locked by Meta. This WhatsApp sender is locked by Meta. This usually happens after 30 days with no messages sent. Contact support to get it re-registered.
TW-63058 Country not allowed for business messaging. WhatsApp does not allow business messaging to recipients in this country. Reach the contact by SMS or email.
TW-21211 Invalid phone number. The contact’s phone number is not a valid number: a missing country code, a typo, or extra digits. Open the contact and correct the number in international format, for example +14155551234.
TW-21212 No approved sender on this account. The number this message was sent from is not an approved WhatsApp sender, so the provider refused it. Open Settings → Channels and check your WhatsApp Business number is connected and approved. If it shows as connected, contact support and quote this code.
TW-21408 Destination country not enabled. Sending to the contact’s country is switched off on the sending account. For SMS with your own Twilio account, enable the country under Messaging → Settings → Geo Permissions in the Twilio Console. For WhatsApp, contact support.
TW-21602 Empty message. The message had no text, so it could not be sent. Add text to the message and send again.
TW-21610 Contact replied STOP. This person texted STOP to your number, so carriers block further texts to them. Remove them from your lists. They can text START to your number to opt back in.
TW-21656 Template variables do not match. The values filled into the template did not match its placeholders: a missing or empty value, or a value with line breaks. Check every variable has a value and no line breaks, then resend.
TW-21703 No sender available for this destination. The account has no sender that can reach this contact’s country with this type of message. Check the number under Settings → Channels. If it is connected and approved, contact support and quote this code.

SMS (Twilio)

Codice Significato Cosa fare
TW-30003 Telefono non raggiungibile. Il telefono del contatto era spento, fuori copertura o non può ricevere messaggi di testo. Riprova più tardi. Se continua a fallire, verifica che il numero sia un numero di cellulare.
TW-30004 Messaggio bloccato. L’operatore o il destinatario ha bloccato questo messaggio. La persona potrebbe aver bloccato il tuo numero, aver rifiutato il consenso o il contenuto potrebbe essere stato filtrato. Se hanno rifiutato il consenso, devono inviare START al tuo numero. Altrimenti, prova con una formulazione più breve e semplice.
TW-30005 Numero sconosciuto o non più esistente. L’operatore non riconosce questo numero. Potrebbe essere disconnesso o digitato male. Verifica il numero con il contatto.
TW-30006 Linea fissa o operatore non raggiungibile. Questo numero è una linea fissa o appartiene a un operatore che non può ricevere messaggi di testo. Usa un numero di cellulare o raggiungi il contatto su un altro canale.
TW-30007 Messaggio filtrato come spam. Il filtro antispam dell’operatore ha bloccato questo messaggio. Evita accorciatori di link, TUTTO MAIUSCOLO e messaggi identici ripetuti. Per i numeri statunitensi, assicurati che la tua registrazione Twilio A2P 10DLC sia completa.
TW-30008 Consegna fallita per un motivo sconosciuto. L’operatore ha segnalato un errore senza una causa specifica. Riprova. Se il problema persiste per questo numero, contatta la persona in un altro modo.
TW-30024 Mittente non registrato presso l’operatore. Il numero da cui stai inviando non è ancora registrato o verificato presso l’operatore di destinazione. Nel tuo account Twilio, completa la registrazione del numero (A2P 10DLC o verifica toll-free) e attendi che risulti verificato.
TW-30034 Numero statunitense non registrato per A2P 10DLC. Gli operatori statunitensi bloccano i messaggi da numeri non collegati a una campagna A2P 10DLC approvata. Completa la registrazione del brand e della campagna nella tua console Twilio e aggiungi il numero al servizio di messaggistica della campagna.

WhatsApp Business (Meta)

Code What it means What to do
META-131026 Message undeliverable. WhatsApp could not deliver this message. The number may not be on WhatsApp, the person may not have accepted the latest terms, or their app is very out of date. Confirm the number with the contact, or reach them another way.
META-131047 24-hour reply window closed. More than 24 hours have passed since the contact last messaged you, so a free-form message cannot be delivered. Send an approved template to reopen the conversation.
META-131049 Marketing message held back by Meta. Meta did not deliver this marketing message to keep engagement healthy. The contact has hit their limit of marketing messages for now. Wait at least 24 hours before sending marketing templates to this contact again.
META-131053 Media could not be uploaded. The media attached to this message could not be uploaded to WhatsApp. Check the file type is supported and the link opens publicly, then resend.
META-131056 Too many messages to this contact. Too many messages were sent to this contact in a short period. Wait a little before messaging this contact again.
META-132000 Template variables do not match. The number of values filled into the template did not match the template’s placeholders. Check every placeholder has a value, then resend.
META-132001 Template not found or not approved. The template does not exist in this language or has not been approved yet. Pick an approved template in the contact’s language under Templates.
META-132015 Template paused for low quality. Meta paused this template because of low quality ratings. Edit the template to improve it and resubmit; use another approved template in the meantime.
META-130472 Blocked by a Meta experiment. Meta did not send this message as part of a platform experiment. There is nothing to fix on your side.
META-133010 Number not registered with WhatsApp Business. The sending number is not registered on the WhatsApp Business Platform. Reconnect the number under Settings → Channels. If it stays like this, contact support.

Messenger e Instagram

Code What it means What to do
APP-1901 Facebook page automation conflict. Facebook would not let this reply through because another app or Facebook’s own automated responses currently control this conversation. In your Facebook Page settings, turn off Facebook’s automated responses and, under Advanced Messaging → Handover Protocol, make the connected app the primary receiver. Then reply again.
APP-1902 Meta 24-hour window closed. Instagram and Messenger only allow replies within 24 hours of the contact’s last message. This contact went quiet more than a day ago, so Meta blocked the message. Wait for the contact to message again. Templates do not exist on these channels; reach them by WhatsApp, SMS or email if it cannot wait.
APP-1903 Comment already has a private reply. Meta allows one private reply per comment, and this comment already got one. Nothing to fix. Continue in the contact’s DM thread instead.
APP-1904 Comment no longer available. The comment was deleted or is too old for a private reply (Instagram allows private replies for 7 days). Nothing to fix.
APP-1905 Missing Facebook or Instagram permission. Meta refused the message because the connection is missing a permission. Reconnect the account under Settings → Channels and accept every permission. For Instagram, also check the account is a professional account linked to your Facebook Page and that “Allow access to messages” is on in the Instagram app.
APP-1906 Facebook or Instagram login expired. The login token for this Page or Instagram account has expired or was revoked, so nothing can be sent. Reconnect the account under Settings → Channels.
APP-1907 Contact no longer reachable. Meta no longer finds this conversation or person. They may have blocked you, deleted their account, or removed the conversation. Nothing to fix.
APP-1908 Temporary Meta error. Meta had a temporary problem. Try again in a few minutes.
APP-1909 Meta rejected this message. Meta refused this message for the reason shown in the expanded row. Read the detail; if it is not clear, contact support and quote this code.

WhatsApp Web

Code What it means What to do
WAW-463 WhatsApp is limiting messages to this contact. They may have blocked this number, or it is a new conversation WhatsApp will not allow from this account yet. Wait and try later, or reach the contact another way. New numbers should warm up gradually.
WAW-479 Temporary WhatsApp connection issue. Try sending again.
APP-1101 WhatsApp Web is not connected. The message could not go out because the WhatsApp Web connection was down at the time. Open Settings → Channels and click Reconnect, then scan the QR code with the phone. Resend the message afterwards.
APP-1102 No WhatsApp number connected. This account has no connected WhatsApp number, so the message had nowhere to go. Connect a number under Settings → Channels.
APP-1103 Sent on the wrong WhatsApp connection. This conversation lives on your WhatsApp Web number, but the message was sent through WhatsApp Business. Reply from the chat itself so it uses the conversation’s own channel.
APP-1104 WhatsApp Business sender not set up. The account tried to send through WhatsApp Business, but no WhatsApp Business number is set up. Connect a WhatsApp Business number under Settings → Channels, or switch the contact to a channel you have connected. If a number is connected, contact support and quote this code.
APP-1201 Invalid phone number. The contact’s phone number could not be validated. Open the contact and correct the number in international format.
APP-1301 Daily new-contact limit reached. (warning) This WhatsApp Web number has reached today’s limit for messaging people who have never messaged it. The limit exists to protect the number from being banned. Wait until tomorrow. The limit grows as the number warms up. See Scaling WhatsApp outreach safely.
APP-1401 No approved template attached. A template message was sent without an approved template. Pick an approved template under Templates and resend.

Altri canali

Code What it means What to do
APP-1501 Email address rejected. The recipient’s mail server rejected the address. Check the contact’s email address for typos.
APP-1502 No email inbox connected. This account has no connected email inbox to send from. Connect one under Settings → Channels → Email.
APP-1503 Email could not be sent. The email could not be sent for the reason shown in the expanded row. Check your email provider settings under Settings → Custom Email Provider.
APP-1601 Telegram session expired. The Telegram login for this account was ended, usually from the Telegram app’s active sessions. Reconnect Telegram under Settings → Channels.
APP-1602 Blocked on Telegram. One side has blocked the other on Telegram, so the message cannot be delivered. Nothing to fix from here.
APP-1603 Telegram message failed. Telegram did not accept this message. Try again; if it repeats, reconnect Telegram under Settings → Channels.
APP-1701 SMS not set up. This account has no SMS sender connected. Connect your Twilio account or Android phone under Settings → SMS Provider.
APP-1801 LinkedIn conversation not linked. The message could not be matched to a LinkedIn conversation. Open the conversation from the LinkedIn page and reply from there. If it repeats, contact support.
APP-2001 Sending paused: billing. Outbound messages are paused because of an unpaid invoice or a blocked subscription. Settle the payment under Settings → Billing; sending resumes automatically.
APP-9001 Delivery failed. The message could not be delivered. The provider’s reason, when there was one, is shown in the expanded row. Try again; if it keeps happening, contact support and quote this code and the time.

AI

Codice Cosa significa Cosa fare
APP-3001 Nessun agente AI ha risposto a un nuovo messaggio. È arrivato un messaggio ma nessun agente AI attivo era impostato per rispondere su quel canale, quindi nessuno ha risposto. Il messaggio è nella tua casella di posta. Apri Agenti AI e attiva un agente o assegnalo al punto di ingresso di quel canale.
APP-3002 AI in pausa: crediti esauriti. L’AI non ha risposto perché l’account ha esaurito i crediti. Ricarica o abilita la ricarica automatica in Impostazioni → Fatturazione.
APP-3003 AI in pausa: fatturazione. L’AI non ha risposto perché l’abbonamento è bloccato per motivi di fatturazione. Regola il pagamento in Impostazioni → Fatturazione.
APP-3004 La tua chiave AI ha fallito e il fallback è disattivato. La chiave del tuo provider AI ha restituito un errore e il fallback all’AI della piattaforma è disattivato, quindi non è stata generata alcuna risposta. Correggi la chiave in Impostazioni → Modello AI o attiva il fallback.
APP-3101 La chiave del tuo provider AI ha un problema. La chiave del tuo provider AI è stata rifiutata. I tuoi bot continuano a lavorare sull’AI della piattaforma nel frattempo. Controlla la chiave e la fatturazione del provider in Impostazioni → Modello AI.
APP-3201 Bot fermato: raggiunto il limite di messaggi per questo contatto. (avviso) L’AI ha raggiunto il numero massimo di messaggi consentiti per questo contatto e si è fermata. Prendi in carico la chat o aumenta il limite di messaggi per contatto nelle impostazioni dell’agente.
APP-3301 AI saltata: fuori dagli orari attivi. (solo informazione) Il messaggio è arrivato al di fuori dell’orario di disponibilità del bot. Regola la pianificazione in Disponibilità dell’agente se avrebbe dovuto rispondere.
APP-3302 AI saltata: trigger parola chiave. (solo informazione) Il messaggio del contatto corrispondeva a una parola chiave che mette in pausa l’AI. Rivedi le parole chiave di pausa nelle impostazioni dell’agente.
APP-3303 AI saltata: il contatto ha rifiutato. (solo informazione) Questo contatto è escluso dall’AI. Rimuovi l’esclusione sul contatto se non era intenzionale.
APP-3304 AI saltata: risposta alla storia di Instagram. (solo informazione) Le risposte alle storie di Instagram sono disattivate per questo agente. Attiva le risposte alle storie nelle impostazioni Instagram dell’agente se vuoi che vengano gestite.

Canali

Codice Cosa significa Cosa fare
APP-1111 WhatsApp Web disconnesso. Il numero WhatsApp Web ha perso la connessione e richiede una nuova scansione QR. I messaggi in coda mentre è giù non vengono inviati. Apri Impostazioni → Canali e fai clic su Ricollega, quindi scansiona il codice QR.
APP-1112 Problema di connessione a WhatsApp Business. Meta ha segnalato un problema con la tua connessione WhatsApp Business; i dettagli sono mostrati nella riga espansa. Segui i dettagli; se menziona un token o un’autorizzazione, ricollega in Impostazioni → Canali.
APP-1113 Conflitto di trasferimento Instagram. Un’altra app detiene il controllo delle conversazioni Instagram per questo account, quindi le risposte possono essere bloccate. In Meta Business Suite, imposta l’app collegata come ricevitore principale per i messaggi Instagram.
APP-1114 Raggiunto il limite di invio di WhatsApp Web. (avviso) Il numero ha raggiunto il suo limite di invio per ora. Attendi; il limite si azzera quotidianamente e cresce man mano che il numero si riscalda.

Fatturazione e limiti

Codice Cosa significa Cosa fare
APP-2002 Pagamento scaduto. L’ultimo pagamento dell’abbonamento non è riuscito. Il servizio viene interrotto se rimane non pagato. Aggiorna il metodo di pagamento in Impostazioni → Fatturazione.
APP-2003 Invio in uscita in pausa. La messaggistica in uscita è stata messa in pausa a causa di un problema di fatturazione irrisolto. Regola il pagamento in Impostazioni → Fatturazione.
APP-2004 Crediti esauriti. Il saldo dei crediti ha raggiunto lo zero, quindi le risposte AI e i messaggi a pagamento si fermano. Ricarica o abilita la ricarica automatica in Impostazioni → Fatturazione.
APP-2101 Raggiunto il limite di contatti. Il limite di contatti del piano è raggiunto, quindi la messaggistica AI è in pausa per i nuovi contatti. Aggiorna il piano o rimuovi i contatti inutilizzati.

Knowledge Base

Codice Cosa significa Cosa fare
APP-4001 Importazione knowledge base fallita. Non è stato possibile leggere le pagine da un’importazione. Verifica che il sito web sia raggiungibile pubblicamente (nessun login richiesto) e riprova l’importazione in Knowledge Base.

Broadcast e campagne

Codice Cosa significa Cosa fare
APP-5101 Campagna messa in pausa automaticamente. La campagna è stata messa in pausa perché troppi messaggi sono falliti di seguito. Leggi i fallimenti sopra di essa in questo registro, correggi la causa, quindi riprendi la campagna.
APP-5102 La protezione invio ha fermato una trasmissione. La trasmissione è stata fermata perché sembrava destinata a persone che non ti hanno mai scritto, il che mette a rischio il numero. Rivedi il pubblico, quindi riprendi dalla pagina della trasmissione.
APP-5103 Avviso protezione invio. (avviso) Una trasmissione sta inviando messaggi a molte persone che non ti hanno mai scritto. Mantieni il pubblico caldo e il volume graduale. Vedi Scaling WhatsApp outreach safely.
APP-5104 Trasmissione messa in pausa automaticamente. La trasmissione è stata messa in pausa dopo ripetuti fallimenti. Correggi 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 sollevato un avviso che richiede un intervento umano. Apri la chat o l’automazione collegata.
APP-5201 Esecuzione automazione fallita. Un’esecuzione di questa automazione si è fermata con un errore; il messaggio del passaggio è mostrato nella riga espansa. Apri l’esecuzione per vedere quale passaggio è fallito, correggi le sue impostazioni e riproduci l’esecuzione.

Integrazioni

Codice Cosa significa Cosa fare
APP-6001 Consegna webhook fallita. Il tuo endpoint webhook sta rifiutando o andando in timeout sulle consegne; l’ultima risposta è mostrata nella riga espansa. Verifica che l’endpoint sia attivo e restituisca rapidamente uno stato 2xx.
APP-6002 Webhook disabilitato dopo ripetuti fallimenti. Il webhook è stato disattivato perché continuava a fallire. Gli eventi non vengono consegnati ad esso. Correggi l’endpoint, quindi riabilita il webhook in Impostazioni → Webhook.
}

Appuntamenti

Codice Cosa significa Cosa fare
APP-7001 Impossibile leggere il calendario della stanza. Non è stato possibile leggere il Google Calendar collegato a una stanza, quindi la disponibilità per quella stanza potrebbe essere errata. Condividi nuovamente il calendario con l’account Google connesso o riconnetti Google Calendar.

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.