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 e-mail. O alerta de e-mail para um envio falho nomeia o contato e seu número, nomeia a conta em que isso aconteceu quando você gerencia várias, e possui um botão Abrir conversa que leva você diretamente para aquele chat.
- 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 de funcionamento estava encerrado ou a IA não conseguiu produzir uma resposta mesmo após novas tentativas.
- 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éditos vazio, um limite de contatos atingido.
- Importações de base de conhecimento que falharam.
- Transmissões (incluindo entradas de campanhas clássicas) que foram pausadas automaticamente.
- Execuções de automação que pararam com um erro.
- Webhooks que estão falhando ou foram desativados 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.
Lendo o log através da API
As mesmas entradas estão disponíveis via API em GET /v1/error-log, e para assistentes de IA conectados através do servidor MCP como a ferramenta list_error_log_entries.
Quando entrar em contato com o suporte
A maioria das entradas indica exatamente o que alterar, e você mesmo pode fazer isso. Quando uma entrada solicitar que você entre em contato, ou se o mesmo código continuar aparecendo após você ter seguido a correção, entre em contato com o suporte e inclua o código e o horário em que ocorreu (copie-os diretamente da linha). Isso geralmente é o suficiente para encontrarmos o problema sem necessidade de trocas adicionais de mensagens.
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)
| Código | O que significa | O que fazer |
|---|---|---|
TW-63005 |
O WhatsApp rejeitou o conteúdo da mensagem. O WhatsApp rejeitou o conteúdo desta mensagem. | Verifique o texto da mensagem, qualquer mídia e o cabeçalho e variáveis do modelo, depois envie novamente. |
TW-63007 |
O número do remetente não está conectado. Esta mensagem foi enviada de um número que não está conectado como um remetente do WhatsApp. | Reconecte o número em Configurações → Canais e tente novamente. |
TW-63012 |
Problema temporário no WhatsApp. O WhatsApp teve um problema temporário do lado deles. | Tente enviar novamente em alguns minutos. |
TW-63016 |
Janela de resposta de 24 horas encerrada. A janela de resposta de 24 horas com este contato foi encerrada, portanto, uma mensagem de formato livre não pode ser entregue. | Envie um modelo aprovado para reabrir a conversa. |
TW-63021 |
Conteúdo não aceito pelo WhatsApp. O conteúdo não passou nas verificações do WhatsApp: um tipo de mensagem não suportado, mídia muito grande ou não acessível publicamente, ou um cabeçalho ou texto de botão que excede o limite de caracteres. | Verifique se os links de mídia abrem em uma janela anônima do navegador, encurte os rótulos dos botões e mantenha o corpo do modelo com menos de 1.024 caracteres. |
TW-63024 |
O número não pode receber mensagens do WhatsApp. Este número não pode receber mensagens do WhatsApp. Pode ser que ele não esteja no WhatsApp ou que a pessoa não tenha aceitado os termos mais recentes do WhatsApp. | Confirme o número com o contato ou entre em contato por SMS ou e-mail. |
TW-63027 |
Modelo não disponível neste idioma. O modelo não existe no idioma em que foi enviado. | Escolha um modelo aprovado no idioma do contato ou crie um nesse idioma em Modelos. |
TW-63032 |
Bloqueado por um experimento da Meta. O WhatsApp não entregará mensagens para este número porque a Meta o incluiu em um experimento da plataforma. | Não há nada a ser corrigido do seu lado. Entre em contato com o destinatário por outro canal se for urgente. |
TW-63049 |
Modelo de marketing bloqueado pela Meta. A Meta bloqueou este modelo de marketing. Modelos de marketing não podem mais ser entregues para números dos EUA. Em outros locais, isso geralmente é um limite temporário de quantas mensagens de marketing aquela pessoa pode receber. | Para contatos nos EUA, use SMS ou e-mail. Para outros países, tente novamente mais tarde. |
TW-63050 |
O contato optou por não receber marketing. Esta pessoa optou por não receber mensagens de marketing da sua empresa no WhatsApp. | Ela não receberá modelos de marketing novamente até que aceite recebê-los novamente. Mensagens de utilidade e serviço ainda funcionam. |
TW-63051 |
Remetente do WhatsApp bloqueado pela Meta. Este remetente do WhatsApp está bloqueado pela Meta. Isso geralmente acontece após 30 dias sem mensagens enviadas. | Entre em contato com o suporte para registrá-lo novamente. |
TW-63058 |
País não permitido para mensagens comerciais. O WhatsApp não permite mensagens comerciais para destinatários neste país. | Entre em contato com o destinatário por SMS ou e-mail. |
TW-21211 |
Número de telefone inválido. O número de telefone do contato não é válido: falta o código do país, há um erro de digitação ou dígitos extras. | Abra o contato e corrija o número no formato internacional, por exemplo, +14155551234. |
TW-21212 |
Nenhum remetente aprovado nesta conta. O número do qual esta mensagem foi enviada não é um remetente aprovado do WhatsApp, portanto, o provedor a recusou. | Abra Configurações → Canais e verifique se o seu número do WhatsApp Business está conectado e aprovado. Se ele aparecer como conectado, entre em contato com o suporte e informe este código. |
TW-21408 |
País de destino não habilitado. O envio para o país do contato está desativado na conta de envio. | Para SMS com sua própria conta Twilio, habilite o país em Messaging → Settings → Geo Permissions no Console da Twilio. Para WhatsApp, entre em contato com o suporte. |
TW-21602 |
Mensagem vazia. A mensagem não continha texto, portanto não pôde ser enviada. | Adicione texto à mensagem e envie novamente. |
TW-21610 |
O contato respondeu STOP. Esta pessoa enviou STOP para o seu número, portanto, as operadoras bloqueiam mensagens futuras para ela. | Remova-a de suas listas. Ela pode enviar START para o seu número para aceitar receber mensagens novamente. |
TW-21656 |
Variáveis do modelo não correspondem. Os valores preenchidos no modelo não corresponderam aos seus espaços reservados: falta um valor, o valor está vazio ou contém quebras de linha. | Verifique se cada variável tem um valor e não contém quebras de linha, depois reenvie. |
TW-21703 |
Nenhum remetente disponível para este destino. A conta não possui um remetente que possa alcançar o país deste contato com este tipo de mensagem. | Verifique o número em Configurações → Canais. Se ele estiver conectado e aprovado, entre em contato com o suporte e informe este código. |
SMS (Twilio)
WhatsApp Business (Meta)
| Código | O que significa | O que fazer |
|---|---|---|
META-131026 |
Mensagem não entregue. O WhatsApp não conseguiu entregar esta mensagem. O número pode não estar no WhatsApp, a pessoa pode não ter aceitado os termos mais recentes ou o aplicativo dela está muito desatualizado. | Confirme o número com o contato ou entre em contato por outro meio. |
META-131047 |
Janela de resposta de 24 horas encerrada. Mais de 24 horas se passaram desde que o contato enviou uma mensagem pela última vez, portanto, uma mensagem de formato livre não pode ser entregue. | Envie um modelo aprovado para reabrir a conversa. |
META-131049 |
Mensagem de marketing retida pela Meta. A Meta não entregou esta mensagem de marketing para manter o engajamento saudável. O contato atingiu seu limite de mensagens de marketing por enquanto. | Aguarde pelo menos 24 horas antes de enviar modelos de marketing para este contato novamente. |
META-131053 |
A mídia não pôde ser carregada. A mídia anexada a esta mensagem não pôde ser carregada no WhatsApp. | Verifique se o tipo de arquivo é suportado e se o link abre publicamente, depois reenvie. |
META-131056 |
Muitas mensagens para este contato. Muitas mensagens foram enviadas para este contato em um curto período. | Aguarde um pouco antes de enviar mensagens para este contato novamente. |
META-132000 |
Variáveis do modelo não correspondem. O número de valores preenchidos no modelo não correspondeu aos espaços reservados do modelo. | Verifique se cada espaço reservado tem um valor, depois reenvie. |
META-132001 |
Modelo não encontrado ou não aprovado. O modelo não existe neste idioma ou ainda não foi aprovado. | Escolha um modelo aprovado no idioma do contato em Modelos. |
META-132015 |
Modelo pausado por baixa qualidade. A Meta pausou este modelo devido a classificações de baixa qualidade. | Edite o modelo para melhorá-lo e envie novamente; use outro modelo aprovado enquanto isso. |
META-130472 |
Bloqueado por um experimento da Meta. A Meta não enviou esta mensagem como parte de um experimento da plataforma. | Não há nada a ser corrigido do seu lado. |
META-133010 |
Número não registrado no WhatsApp Business. O número de envio não está registrado na Plataforma WhatsApp Business. | Reconecte o número em Configurações → Canais. Se o problema persistir, entre em contato com o suporte. |
Messenger e Instagram
| Código | O que significa | O que fazer |
|---|---|---|
APP-1901 |
Conflito de automação da página do Facebook. O Facebook não permitiu que esta resposta fosse enviada porque outro aplicativo ou as próprias respostas automáticas do Facebook controlam esta conversa no momento. | Nas configurações da sua Página do Facebook, desative as respostas automáticas do Facebook, depois abra Configuração da página → Mensagens avançadas → Protocolo de transferência (Handover protocol) e clique em Configurar ao lado de Receptor do Messenger (ou Receptor do Instagram) para tornar o aplicativo conectado o receptor principal. Em seguida, responda novamente. |
APP-1902 |
Janela de 24 horas da Meta encerrada. Instagram e Messenger permitem respostas apenas dentro de 24 horas após a última mensagem do contato. Este contato não envia mensagens há mais de um dia, então a Meta bloqueou a mensagem. | Aguarde o contato enviar uma nova mensagem. Modelos não existem nestes canais; contate-os via WhatsApp, SMS ou e-mail se não puder esperar. |
APP-1903 |
O comentário já possui uma resposta privada. A Meta permite uma resposta privada por comentário, e este comentário já recebeu uma. | Nada a corrigir. Continue na thread de DM do contato. |
APP-1904 |
Comentário não está mais disponível. O comentário foi excluído ou é antigo demais para uma resposta privada (o Instagram permite respostas privadas por 7 dias). | Nada a corrigir. |
APP-1905 |
Permissão do Facebook ou Instagram ausente. A Meta recusou a mensagem porque a conexão não possui uma permissão. | Reconecte a conta em Configurações → Canais e aceite todas as permissões. Para o Instagram, verifique também se a conta é uma conta profissional vinculada à sua Página do Facebook e se “Permitir acesso às mensagens” está ativado no aplicativo do Instagram. |
APP-1906 |
Login do Facebook ou Instagram expirado. O token de login para esta Página ou conta do Instagram expirou ou foi revogado, portanto, nada pode ser enviado. | Reconecte a conta em Configurações → Canais. |
APP-1907 |
Contato não está mais acessível. A Meta não encontra mais esta conversa ou pessoa. Eles podem ter bloqueado você, excluído a conta ou removido a conversa. | Nada a corrigir. |
APP-1908 |
Erro temporário da Meta. A Meta teve um problema temporário. | Tente novamente em alguns minutos. |
APP-1909 |
A Meta rejeitou esta mensagem. A Meta recusou esta mensagem pelo motivo mostrado na linha expandida. | Leia os detalhes; se não estiver claro, entre em contato com o suporte e informe este código. |
WhatsApp Web
| Código | O que significa | O que fazer |
|---|---|---|
WAW-463 |
O WhatsApp está limitando mensagens para este contato. Eles podem ter bloqueado este número, ou é uma nova conversa que o WhatsApp ainda não permite a partir desta conta. | Aguarde e tente mais tarde, ou contate o contato de outra forma. Novos números devem ser aquecidos gradualmente. |
WAW-479 |
Problema temporário de conexão com o WhatsApp. | Tente enviar novamente. |
APP-1101 |
O WhatsApp Web não está conectado. A mensagem não pôde ser enviada porque a conexão do WhatsApp Web estava fora do ar no momento. | Abra Configurações → Canais e clique em Reconectar, depois escaneie o código QR com o celular. Reenvie a mensagem após isso. |
APP-1102 |
Nenhum número do WhatsApp conectado. Esta conta não possui um número do WhatsApp conectado, então a mensagem não tinha para onde ir. | Conecte um número em Configurações → Canais. |
APP-1103 |
Enviado na conexão errada do WhatsApp. Esta conversa reside no seu número do WhatsApp Web, mas a mensagem foi enviada através do WhatsApp Business. | Responda a partir do próprio chat para que ele use o canal da conversa. |
APP-1104 |
Remetente do WhatsApp Business não configurado. A conta tentou enviar através do WhatsApp Business, mas nenhum número do WhatsApp Business está configurado. | Conecte um número do WhatsApp Business em Configurações → Canais, ou altere o contato para um canal que você tenha conectado. Se um número estiver conectado, entre em contato com o suporte e informe este código. |
APP-1105 |
O WhatsApp não confirmou a mensagem. A mensagem foi entregue ao WhatsApp Web, mas o WhatsApp nunca confirmou o recebimento, então é muito provável que não tenha chegado ao contato. Isso geralmente significa que a conexão do WhatsApp Web caiu por um momento durante o envio. | Verifique se o número do WhatsApp Web aparece como conectado em Configurações → Canais, depois envie a mensagem novamente. |
APP-1201 |
Número de telefone inválido. O número de telefone do contato não pôde ser validado. | Abra o contato e corrija o número no formato internacional. |
APP-1301 |
Limite diário de novos contatos atingido. (aviso) Este número do WhatsApp Web atingiu o limite de hoje para enviar mensagens a pessoas que nunca enviaram mensagens para ele. O limite existe para proteger o número de ser banido. | Aguarde até amanhã. O limite aumenta conforme o número é aquecido. Veja Escalando o alcance do WhatsApp com segurança. |
APP-1401 |
Nenhum modelo aprovado anexado. Uma mensagem de modelo foi enviada sem um modelo aprovado. | Escolha um modelo aprovado em Modelos e reenvie. |
Outros Canais
| Código | O que significa | O que fazer |
|---|---|---|
APP-1501 |
Endereço de e-mail rejeitado. O servidor de e-mail do destinatário rejeitou o endereço. | Verifique se há erros de digitação no endereço de e-mail do contato. |
APP-1502 |
Nenhuma caixa de entrada de e-mail conectada. Esta conta não tem uma caixa de entrada de e-mail conectada para realizar envios. | Conecte uma em Configurações → Canais → E-mail. |
APP-1503 |
O e-mail não pôde ser enviado. O e-mail não pôde ser enviado pelo motivo exibido na linha expandida. | Verifique as configurações do seu provedor de e-mail em Configurações → Provedor de E-mail Personalizado. |
APP-1601 |
Sessão do Telegram expirada. O login do Telegram para esta conta foi encerrado, geralmente a partir das sessões ativas do aplicativo Telegram. | Reconecte o Telegram em Configurações → Canais. |
APP-1602 |
Bloqueado no Telegram. Um dos lados bloqueou o outro no Telegram, portanto a mensagem não pode ser entregue. | Nada a corrigir por aqui. |
APP-1603 |
Falha na mensagem do Telegram. O Telegram não aceitou esta mensagem. | Tente novamente; se o erro persistir, reconecte o Telegram em Configurações → Canais. |
APP-1701 |
SMS não configurado. Esta conta não tem um remetente de SMS conectado. | Conecte sua conta Twilio ou telefone Android em Configurações → Provedor de SMS. |
APP-2001 |
Envio pausado: faturamento. As mensagens de saída estão pausadas devido a uma fatura não paga ou uma assinatura bloqueada. | Regularize o pagamento em Configurações → Faturamento; o envio será retomado automaticamente. |
APP-9001 |
Falha na entrega. A mensagem não pôde ser entregue. O motivo do provedor, quando disponível, é exibido na linha expandida. | Tente novamente; se o problema persistir, entre em contato com o suporte e informe este código e o horário. |
IA
Quando a IA não retorna uma resposta, ela tenta novamente de forma automática algumas vezes. Se ainda assim não conseguir responder, a conversa exibe uma nota e o log de Erros recebe uma entrada APP-3306. Um chat que o agente transferiu para uma pessoa (alertou um colega de equipe ou encerrou o chat) não conta: a IA fica em silêncio nesses casos propositalmente, portanto, não há nota nem entrada APP-3306.
Canais
Faturamento e Limites
Base de Conhecimento
Transmissões e Campanhas
| Código | O que significa | O que fazer |
|---|---|---|
APP-5101 |
Agente pausado automaticamente. O agente parou de enviar mensagens para novas pessoas porque poucas responderam, o que coloca o número em risco. | Revise com quem o agente está entrando em contato e sua mensagem inicial, depois reative o agente a partir de sua página. |
APP-5102 |
O protetor de envio interrompeu uma transmissão. A transmissão foi interrompida porque parecia estar sendo enviada para pessoas que nunca enviaram mensagens para você, o que coloca o número em risco. | Revise o público e, em seguida, 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 engajado 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, em seguida, 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 requer intervenção humana. | Abra o chat ou a automação vinculada. |
APP-5201 |
A execução da automação falhou. Uma execução desta automação parou com um erro; a mensagem da etapa é exibida na linha expandida. | Abra a execução para ver qual etapa falhou, corrija suas configurações e repita a execução. Ative Automação Falhou em Notificações para ser alertado quando isso acontecer. |
Integrações
Agendamentos
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.