Your AI Connector Docs

Registro de erros

O Registro de erros é uma lista cronológica de tudo na sua conta que não funcionou: uma mensagem que não pôde ser entregue, uma resposta de IA que nunca foi enviada, um canal que perdeu a conexão, uma importação que falhou no meio do caminho.

Cada entrada contém um código curto, uma explicação em linguagem simples e o que fazer a respeito — assim, quando algo parecer errado, você mesmo pode ver o motivo e corrigi-lo, em vez de escrever para o suporte e esperar por uma resposta. É também a maneira mais rápida de distinguir um problema real de algo que se comportou exatamente como deveria (um contato que optou por sair, uma janela de resposta que se fechou).

Onde encontrar

No menu principal, no lado esquerdo da tela, bem na parte inferior, clique em Registro de erros — ele fica logo acima de Ajuda. (Em um celular, toque primeiro no ícone de menu ☰ e, em seguida, em Registro de erros.)

Lendo uma linha

Cada linha representa algo que falhou, com o mais recente primeiro.

Parte da linha O que ela informa
Hora Há quanto tempo aconteceu. Passe o mouse sobre ela para ver a data e a hora exatas.
Código O código curto para esse tipo de falha, por exemplo TW-63016. Clique nele para copiar. Todos os códigos são explicados abaixo.
Categoria e canal A qual área pertence (entrega, IA, canal, faturamento, etc.) e em qual canal aconteceu.
O que aconteceu A falha em uma linha, com um link para o contato, quando houver um.
O que fazer A correção, em uma linha.

Clique em uma linha para expandi-la. A linha expandida adiciona a explicação completa, a própria mensagem do provedor quando houver uma, o código numérico do provedor e botões que levam você diretamente ao local onde fará a correção — Abrir chat, Ir para Canais e similares. Sobre este código abre esta página na entrada daquele código.

Filtros

Acima da lista, você pode filtrar os resultados:

  • Intervalo de tempo — 24 horas, 7 dias ou 30 dias. Ele abre em 7 dias e lembra o intervalo que você escolher.
  • Chips de categoria — um chip por categoria, cada um com o número de entradas no intervalo. Clique para mostrar apenas essa categoria.
  • Canal — limite a lista a um canal, por exemplo, WhatsApp ou Instagram.
  • Apenas erros — oculta avisos e entradas apenas informativas, deixando apenas o que realmente falhou.
  • Pesquisar — digite o nome ou número de um contato, ou um código, para encontrar uma entrada específica.

O que o registro cobre

  • Mensagens que não puderam ser entregues, em todos os canais — WhatsApp Business, WhatsApp Web, SMS, Instagram, Messenger, Telegram, e-mail e LinkedIn.
  • Vezes em que a IA não respondeu, e o motivo — nenhum agente foi definido para responder, os créditos acabaram, um limite foi atingido, o horário estava fechado.
  • Problemas de canal — uma sessão do WhatsApp Web que foi desconectada, um login expirado, um limite de envio atingido.
  • Faturamento e limites — um pagamento em atraso, envio pausado, saldo de crédito vazio, limite de contatos atingido.
  • Importações da base de conhecimento que falharam.
  • Transmissões e campanhas que foram pausadas automaticamente.
  • Execuções de automação que pararam com um erro.
  • Webhooks que estão falhando ou foram desligados após falhas repetidas.
  • Calendários de salas que não puderam ser lidos.

O que ele não cobre

  • Qualquer coisa que funcionou. O registro lista apenas falhas, portanto, uma página vazia é um bom sinal.
  • Interrupções em toda a plataforma. Se várias coisas não relacionadas estiverem falhando ao mesmo tempo, verifique primeiro o Status do sistema.
  • Resultados por destinatário de uma transmissão. Para saber como um envio se saiu no geral, abra a própria transmissão — veja Transmissões.

Quando entrar em contato com o suporte

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.

Todos os Códigos de Erro

A primeira parte de um código indica a origem da falha:

  • TW — Twilio, o provedor por trás do WhatsApp Business e SMS. O número após ele é o código de erro da própria Twilio.
  • META — WhatsApp Business através da Meta. O número é o código de erro da própria Meta.
  • WAW — WhatsApp Web.
  • APP — Códigos da própria Your AI Connector, usados para tudo o que um provedor não forneceu um número.

Cada código abaixo possui seu próprio link, portanto, Sobre este código no aplicativo leva você diretamente à entrada exata.

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)

Código O que significa O que fazer
TW-30003 Telefone inalcançável. O telefone do contato estava desligado, fora de cobertura ou não pode receber mensagens de texto. Tente novamente mais tarde. Se continuar falhando, verifique se o número é um número de celular.
TW-30004 Texto bloqueado. A operadora ou o destinatário bloqueou este texto. A pessoa pode ter bloqueado seu número, optado por não receber ou o conteúdo foi filtrado. Se ela optou por não receber, ela precisa enviar START para o seu número. Caso contrário, tente uma redação mais curta e simples.
TW-30005 Número desconhecido ou que não existe mais. A operadora não reconhece este número. Ele pode estar desconectado ou digitado incorretamente. Verifique o número com o contato.
TW-30006 Telefone fixo ou operadora inalcançável. Este número é um telefone fixo ou pertence a uma operadora que não pode receber textos. Use um número de celular ou entre em contato com o destinatário por outro canal.
TW-30007 Texto filtrado como spam. O filtro de spam da operadora bloqueou este texto. Evite encurtadores de link, TUDO EM MAIÚSCULAS e textos idênticos repetidos. Para números dos EUA, certifique-se de que seu registro A2P 10DLC da Twilio esteja completo.
TW-30008 Falha na entrega por um motivo desconhecido. A operadora relatou uma falha sem uma causa específica. Tente novamente. Se repetir para este número, entre em contato com a pessoa de outra forma.
TW-30024 Remetente não registrado na operadora. O número do qual você está enviando ainda não está registrado ou verificado com a operadora de destino. Em sua conta Twilio, conclua o registro do número (A2P 10DLC ou verificação de número gratuito) e aguarde até que ele apareça como verificado.
TW-30034 Número dos EUA não registrado para A2P 10DLC. As operadoras dos EUA bloqueiam textos de números que não estão vinculados a uma campanha A2P 10DLC aprovada. Conclua o registro da marca e da campanha no seu Console Twilio e adicione o número ao serviço de mensagens da campanha.

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.

Outros Canais

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.

IA

Código O que significa O que fazer
APP-3001 Nenhum agente de IA respondeu a uma nova mensagem. Uma mensagem chegou, mas nenhum agente de IA ativo foi configurado para responder naquele canal, então ninguém respondeu. A mensagem está na sua caixa de entrada. Abra Agentes de IA e ative um agente, ou atribua um ao ponto de entrada daquele canal.
APP-3002 IA pausada: sem créditos. A IA não respondeu porque a conta ficou sem créditos. Adicione créditos ou ative a recarga automática em Configurações → Faturamento.
APP-3003 IA pausada: faturamento. A IA não respondeu porque a assinatura está bloqueada por faturamento. Efetue o pagamento em Configurações → Faturamento.
APP-3004 Sua chave de IA falhou e o fallback está desativado. Sua própria chave de provedor de IA retornou um erro e o fallback para a IA da plataforma está desativado, portanto, nenhuma resposta foi gerada. Corrija a chave em Configurações → Modelo de IA ou ative o fallback.
APP-3101 Sua chave de provedor de IA tem um problema. Sua própria chave de provedor de IA foi rejeitada. Seus bots continuam funcionando na IA da plataforma enquanto isso. Verifique a chave e o faturamento do provedor em Configurações → Modelo de IA.
APP-3201 Bot parado: limite de mensagens atingido para este contato. (aviso) A IA atingiu o número máximo de mensagens permitidas para este contato e parou. Assuma o chat ou aumente o limite de mensagens por contato nas configurações do agente.
APP-3301 IA ignorada: fora do horário ativo. (apenas informação) A mensagem chegou fora do cronograma de disponibilidade do bot. Ajuste o cronograma em Disponibilidade do agente se ele deveria ter respondido.
APP-3302 IA ignorada: gatilho de palavra-chave. (apenas informação) A mensagem do contato correspondeu a uma palavra-chave que pausa a IA. Revise as palavras-chave de pausa nas configurações do agente.
APP-3303 IA ignorada: contato optou por não participar. (apenas informação) Este contato está excluído da IA. Remova a exclusão no contato se isso não foi intencional.
APP-3304 IA ignorada: resposta a story do Instagram. (apenas informação) As respostas aos stories do Instagram estão desativadas para este agente. Ative as respostas a stories nas configurações de Instagram do agente se quiser que sejam respondidas.

Canais

Código O que significa O que fazer
APP-1111 WhatsApp Web desconectado. O número do WhatsApp Web perdeu a conexão e precisa de um novo escaneamento de QR. Mensagens na fila enquanto ele está inativo não são enviadas. Abra Configurações → Canais e clique em Reconectar, depois escaneie o código QR.
APP-1112 Problema de conexão com o WhatsApp Business. A Meta relatou um problema com sua conexão do WhatsApp Business; os detalhes são mostrados na linha expandida. Siga os detalhes; se mencionar um token ou permissão, reconecte em Configurações → Canais.
APP-1113 Conflito de transferência do Instagram. Outro aplicativo detém o controle das conversas do Instagram para esta conta, portanto, as respostas podem ser bloqueadas. No Meta Business Suite, defina o aplicativo conectado como o receptor principal para mensagens do Instagram.
APP-1114 Limite de envio do WhatsApp Web atingido. (aviso) O número atingiu seu limite de envio por enquanto. Aguarde; o limite é redefinido diariamente e cresce à medida que o número aquece.

Faturamento e Limites

Código O que significa O que fazer
APP-2002 Pagamento em atraso. O último pagamento da assinatura falhou. O serviço é interrompido se permanecer não pago. Atualize o método de pagamento em Configurações → Faturamento.
APP-2003 Envio de saída pausado. O envio de mensagens de saída foi pausado devido a um problema de faturamento não resolvido. Efetue o pagamento em Configurações → Faturamento.
APP-2004 Sem créditos. O saldo de créditos chegou a zero, portanto, as respostas da IA e as mensagens pagas param. Adicione créditos ou ative a recarga automática em Configurações → Faturamento.
APP-2101 Limite de contatos atingido. O limite de contatos do plano foi atingido, portanto, as mensagens de IA estão pausadas para novos contatos. Faça upgrade do plano ou remova contatos não utilizados.

Base de Conhecimento

Código O que significa O que fazer
APP-4001 Falha na importação da base de conhecimento. Páginas de uma importação não puderam ser lidas. Verifique se o site é acessível publicamente (sem bloqueio de login) e tente novamente a importação em Base de Conhecimento.

Transmissões e Campanhas

Código O que significa O que fazer
APP-5101 Campanha pausada automaticamente. A campanha foi pausada porque muitas mensagens falharam seguidamente. Leia as falhas acima dela neste registro, corrija a causa e retome a campanha.
APP-5102 O protetor de envio parou uma transmissão. A transmissão foi interrompida porque parecia estar indo para pessoas que nunca enviaram mensagens para você, o que coloca o número em risco. Revise o público e retome a partir da página de transmissão.
APP-5103 Aviso do protetor de envio. (aviso) Uma transmissão está enviando mensagens para muitas pessoas que nunca enviaram mensagens para você. Mantenha o público aquecido e o volume gradual. Veja Escalando o alcance do WhatsApp com segurança.
APP-5104 Transmissão pausada automaticamente. A transmissão foi pausada após falhas repetidas. Corrija a causa mostrada nas falhas de entrega e retome.

Automações

Código O que significa O que fazer
APP-5001 A automação precisa da sua atenção. Uma automação gerou um alerta que precisa de um humano. Abra o chat ou automação vinculada.
APP-5201 Falha na execução da automação. Uma execução desta automação parou com um erro; a mensagem da etapa é mostrada na linha expandida. Abra a execução para ver qual etapa falhou, corrija suas configurações e repita a execução.

Integrações

Código O que significa O que fazer
APP-6001 Falha na entrega do Webhook. Seu endpoint de webhook está rejeitando ou excedendo o tempo limite nas entregas; a última resposta é mostrada na linha expandida. Verifique se o endpoint está ativo e retorna um status 2xx rapidamente.
APP-6002 Webhook desativado após falhas repetidas. O webhook foi desligado porque continuou falhando. Os eventos não estão sendo entregues a ele. Corrija o endpoint e reative o webhook em Configurações → Webhooks.

Agendamentos

Código O que significa O que fazer
APP-7001 O calendário da sala não pode ser lido. O Google Calendar vinculado a uma sala não pôde ser lido, portanto, a disponibilidade para essa sala pode estar incorreta. Compartilhe novamente o calendário com a conta do Google conectada ou reconecte o Google Calendar.

Próximos passos

  • Status do sistema — verifique se há algum problema do nosso lado.
  • Notificações — escolha quais falhas também devem chegar até você por e-mail, push ou pelo sino.
  • Webhooks — envie eventos para seus próprios sistemas.