Registo de erros
O Registo 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 ligação, uma importação que falhou a meio.
Cada entrada contém um código curto, uma explicação em linguagem simples e o que fazer a respeito — para que, quando algo parecer errado, possa ver a razão por si mesmo e corrigi-la, em vez de escrever para o suporte e esperar por uma resposta. É também a forma mais rápida de distinguir um problema real de algo que se comportou exatamente como deveria (um contacto que optou por sair, uma janela de resposta que fechou).
Onde a encontrar
No menu principal, no lado esquerdo do ecrã, mesmo no fundo, clique em Registo de erros — encontra-se logo acima de Ajuda. (Num telemóvel, toque primeiro no ícone de menu ☰ e, depois, em Registo de erros.)
Ler uma linha
Cada linha representa algo que falhou, com o mais recente primeiro.
| Parte da linha | O que lhe indica |
|---|---|
| Hora | Há quanto tempo aconteceu. Passe o rato por cima para ver a data e hora exatas. |
| Código | O código curto para este tipo de falha, por exemplo TW-63016. Clique para copiar. Todos os códigos são explicados abaixo. |
| Categoria e canal | A área a que pertence (entrega, IA, canal, faturação, etc.) e em que canal aconteceu. |
| O que aconteceu | A falha numa linha, com uma ligação para o contacto, quando aplicável. |
| O que fazer | A correção, numa linha. |
Clique numa linha para a expandir. A linha expandida adiciona a explicação completa, a mensagem do próprio fornecedor quando disponível, o código numérico do fornecedor e botões que o levam diretamente ao local onde pode corrigir o problema — Abrir chat, Ir para Canais e semelhantes. Sobre este código abre esta página na entrada correspondente a esse código.
Filtros
Acima da lista, pode filtrar os resultados:
- Intervalo de tempo — 24 horas, 7 dias ou 30 dias. Abre nos 7 dias e memoriza o intervalo que escolher.
- Fichas de categoria — uma ficha por categoria, cada uma 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 falhou efetivamente.
- Pesquisar — escreva o nome ou número de um contacto, ou um código, para encontrar uma entrada específica.
O que o registo abrange
- 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 falhado indica o contacto e o respetivo número, nomeia a conta onde ocorreu quando gere várias, e contém um botão Abrir conversa que o leva diretamente para esse chat.
- Vezes em que a IA não respondeu, e porquê — não foi definido nenhum agente para responder, os créditos esgotaram-se, foi atingido um limite, o horário estava encerrado ou a IA não conseguiu produzir uma resposta mesmo após várias tentativas.
- Problemas de canal — uma sessão do WhatsApp Web que se desligou, um início de sessão expirado, um limite de envio atingido.
- Faturação e limites — um pagamento em atraso, envio pausado, saldo de créditos vazio, limite de contactos atingido.
- Importações da base de conhecimento que falharam.
- Transmissões (incluindo entradas de campanhas clássicas) que foram pausadas automaticamente.
- Execuções de automatização que pararam com um erro.
- Webhooks que estão a falhar ou que foram desativados após falhas repetidas.
- Calendários de salas que não puderam ser lidos.
O que não abrange
- Tudo o que funcionou. O registo apenas lista falhas, por isso uma página vazia é um bom sinal.
- Falhas em toda a plataforma. Se várias coisas não relacionadas estiverem a falhar ao mesmo tempo, verifique primeiro o Estado do sistema.
- Resultados por destinatário de uma transmissão. Para saber como um envio se comportou no geral, abra a própria transmissão — consulte Transmissões.
Ler o Registo através da API
As mesmas entradas estão disponíveis através da API em GET /v1/error-log, e para assistentes de IA ligados através do servidor MCP como a ferramenta list_error_log_entries.
Quando contactar o suporte
A maioria das entradas indica exatamente o que deve alterar, e pode fazê-lo você mesmo. Quando uma entrada indicar para entrar em contacto, ou se o mesmo código continuar a aparecer após ter seguido a correção, contacte o suporte e inclua o código e a hora em que aconteceu (copie-os diretamente da linha). Geralmente, isso é suficiente para encontrarmos o problema sem necessidade de trocas de mensagens adicionais.
Todos os Códigos de Erro
A primeira parte de um código indica a origem da falha:
- TW — Twilio, o fornecedor por detrás do WhatsApp Business e SMS. O número a seguir é 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 próprios da Your AI Connector, utilizados para tudo o que um fornecedor não forneceu um número.
Cada código abaixo tem a sua própria ligação, pelo que Sobre este código na aplicação o levará 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 conteúdo multimédia e o cabeçalho e variáveis do modelo, e envie novamente. |
TW-63007 |
O número do remetente não está ligado. Esta mensagem foi enviada a partir de um número que não está ligado como remetente do WhatsApp. | Ligue novamente o número em Definições → Canais e tente de novo. |
TW-63012 |
Problema temporário no WhatsApp. O WhatsApp teve um problema temporário do seu lado. | Tente enviar novamente dentro de alguns minutos. |
TW-63016 |
Janela de resposta de 24 horas encerrada. A janela de resposta de 24 horas com este contacto encerrou, pelo que não é possível entregar uma mensagem de formato livre. | Envie um modelo aprovado para reabrir a conversa. |
TW-63021 |
Conteúdo não aceite pelo WhatsApp. O conteúdo não passou nas verificações do WhatsApp: um tipo de mensagem não suportado, multimédia demasiado grande ou não acessível publicamente, ou um texto de cabeçalho ou botão que excede o limite de caracteres. | Verifique se as hiperligações de multimédia abrem numa janela de navegador privada, encurte as etiquetas dos botões e mantenha o corpo do modelo abaixo de 1024 caracteres. |
TW-63024 |
O número não pode receber mensagens WhatsApp. Este número não pode receber mensagens WhatsApp. Pode não estar no WhatsApp ou a pessoa não aceitou os termos mais recentes do WhatsApp. | Confirme o número com o contacto ou contacte-o 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 contacto ou crie um nesse idioma em Modelos. |
TW-63032 |
Bloqueado por uma experiência da Meta. O WhatsApp não entregará mensagens para este número porque a Meta incluiu-o numa experiência da plataforma. | Não há nada a corrigir do seu lado. Contacte o contacto por outro canal se for urgente. |
TW-63049 |
Modelo de marketing bloqueado pela Meta. A Meta bloqueou este modelo de marketing. Os modelos de marketing já não podem ser entregues a números dos EUA. Noutros locais, isto é geralmente um limite temporário sobre quantas mensagens de marketing essa pessoa pode receber. | Para contactos nos EUA, utilize SMS ou e-mail. Para outros países, tente novamente mais tarde. |
TW-63050 |
O contacto optou por não receber marketing. Esta pessoa optou por não receber mensagens de marketing da sua empresa no WhatsApp. | Não receberá modelos de marketing novamente até que volte a subscrever. As mensagens de utilidade e serviço continuam a funcionar. |
TW-63051 |
Remetente WhatsApp bloqueado pela Meta. Este remetente WhatsApp está bloqueado pela Meta. Isto acontece geralmente após 30 dias sem mensagens enviadas. | Contacte o suporte para o registar novamente. |
TW-63058 |
País não permitido para mensagens empresariais. O WhatsApp não permite mensagens empresariais para destinatários neste país. | Contacte o contacto por SMS ou e-mail. |
TW-21211 |
Número de telefone inválido. O número de telefone do contacto não é um número válido: falta o código do país, um erro de digitação ou dígitos extra. | Abra o contacto e corrija o número no formato internacional, por exemplo +14155551234. |
TW-21212 |
Nenhum remetente aprovado nesta conta. O número a partir do qual esta mensagem foi enviada não é um remetente WhatsApp aprovado, pelo que o fornecedor recusou-a. | Abra Definições → Canais e verifique se o seu número WhatsApp Business está ligado e aprovado. Se aparecer como ligado, contacte o suporte e indique este código. |
TW-21408 |
País de destino não ativado. O envio para o país do contacto está desativado na conta de envio. | Para SMS com a sua própria conta Twilio, ative o país em Messaging → Settings → Geo Permissions na Consola Twilio. Para WhatsApp, contacte o suporte. |
TW-21602 |
Mensagem vazia. A mensagem não tinha texto, pelo que não pôde ser enviada. | Adicione texto à mensagem e envie novamente. |
TW-21610 |
O contacto respondeu STOP. Esta pessoa enviou STOP para o seu número, pelo que as operadoras bloqueiam mensagens futuras para ela. | Remova-a das suas listas. Ela pode enviar START para o seu número para voltar a subscrever. |
TW-21656 |
As variáveis do modelo não correspondem. Os valores preenchidos no modelo não corresponderam aos seus marcadores: falta um valor ou está vazio, ou um valor com 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 tem nenhum remetente que possa alcançar o país deste contacto com este tipo de mensagem. | Verifique o número em Definições → Canais. Se estiver ligado e aprovado, contacte o suporte e indique 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 aceite os termos mais recentes ou a sua aplicação está muito desatualizada. | Confirme o número com o contacto ou contacte-o de outra forma. |
META-131047 |
Janela de resposta de 24 horas encerrada. Passaram mais de 24 horas desde que o contacto lhe enviou uma mensagem pela última vez, pelo que não é possível entregar uma mensagem de formato livre. | 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 envolvimento saudável. O contacto atingiu o seu limite de mensagens de marketing por agora. | Aguarde pelo menos 24 horas antes de enviar modelos de marketing a este contacto novamente. |
META-131053 |
Não foi possível carregar o conteúdo multimédia. O conteúdo multimédia anexado a esta mensagem não pôde ser carregado para o WhatsApp. | Verifique se o tipo de ficheiro é suportado e se a hiperligação abre publicamente, depois reenvie. |
META-131056 |
Demasiadas mensagens para este contacto. Foram enviadas demasiadas mensagens para este contacto num curto período. | Aguarde um pouco antes de enviar mensagens a este contacto novamente. |
META-132000 |
As variáveis do modelo não correspondem. O número de valores preenchidos no modelo não correspondeu aos marcadores do modelo. | Verifique se cada marcador 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 contacto 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 o melhorar e submeta novamente; utilize outro modelo aprovado entretanto. |
META-130472 |
Bloqueado por uma experiência da Meta. A Meta não enviou esta mensagem como parte de uma experiência da plataforma. | Não há nada a corrigir do seu lado. |
META-133010 |
Número não registado no WhatsApp Business. O número de envio não está registado na Plataforma WhatsApp Business. | Ligue novamente o número em Definições → Canais. Se continuar assim, contacte o suporte. |
Messenger e Instagram
| Código | O que significa | O que fazer |
|---|---|---|
APP-1901 |
Conflito de automatização da página do Facebook. O Facebook não permitiu o envio desta resposta porque outra aplicação ou as respostas automáticas do próprio Facebook controlam atualmente esta conversação. | Nas definições da sua Página do Facebook, desative as respostas automáticas do Facebook, abra Configuração da página → Mensagens avançadas → Protocolo de transferência (Handover protocol) e clique em Configurar junto a Recetor do Messenger (ou Recetor do Instagram) para tornar a aplicação ligada o recetor principal. Depois, tente responder novamente. |
APP-1902 |
Janela de 24 horas da Meta encerrada. O Instagram e o Messenger apenas permitem respostas no prazo de 24 horas após a última mensagem do contacto. Este contacto não envia mensagens há mais de um dia, pelo que a Meta bloqueou a mensagem. | Aguarde que o contacto envie uma nova mensagem. Não existem modelos nestes canais; contacte-os via WhatsApp, SMS ou e-mail se não puder esperar. |
APP-1903 |
O comentário já tem uma resposta privada. A Meta permite uma resposta privada por comentário, e este comentário já recebeu uma. | Nada a corrigir. Continue na conversa por mensagem direta (DM) do contacto. |
APP-1904 |
Comentário já não está disponível. O comentário foi eliminado ou é demasiado antigo para uma resposta privada (o Instagram permite respostas privadas durante 7 dias). | Nada a corrigir. |
APP-1905 |
Permissão do Facebook ou Instagram em falta. A Meta recusou a mensagem porque falta uma permissão na ligação. | Volte a ligar a conta em Definições → Canais e aceite todas as permissões. No caso do Instagram, verifique também se a conta é uma conta profissional ligada à sua Página do Facebook e se a opção “Permitir acesso a mensagens” está ativada na aplicação Instagram. |
APP-1906 |
Sessão do Facebook ou Instagram expirada. O token de sessão desta Página ou conta de Instagram expirou ou foi revogado, pelo que não é possível enviar nada. | Volte a ligar a conta em Definições → Canais. |
APP-1907 |
Contacto já não está acessível. A Meta já não encontra esta conversação ou pessoa. Podem ter bloqueado a sua conta, eliminado a conta deles ou removido a conversação. | Nada a corrigir. |
APP-1908 |
Erro temporário da Meta. A Meta teve um problema temporário. | Tente novamente dentro de alguns minutos. |
APP-1909 |
A Meta rejeitou esta mensagem. A Meta recusou esta mensagem pelo motivo apresentado na linha expandida. | Leia os detalhes; se não for claro, contacte o suporte e indique este código. |
WhatsApp Web
| Código | O que significa | O que fazer |
|---|---|---|
WAW-463 |
O WhatsApp está a limitar as mensagens para este contacto. Podem ter bloqueado este número, ou trata-se de uma nova conversação que o WhatsApp ainda não permite a partir desta conta. | Aguarde e tente mais tarde, ou contacte a pessoa por outra via. Os números novos devem ser aquecidos gradualmente. |
WAW-479 |
Problema temporário de ligação ao WhatsApp. | Tente enviar novamente. |
APP-1101 |
O WhatsApp Web não está ligado. A mensagem não pôde ser enviada porque a ligação ao WhatsApp Web estava em baixo nesse momento. | Abra Definições → Canais e clique em Reconnect (Reconectar), depois digitalize o código QR com o telemóvel. Reenvie a mensagem depois. |
APP-1102 |
Nenhum número de WhatsApp ligado. Esta conta não tem nenhum número de WhatsApp ligado, por isso a mensagem não tinha para onde ir. | Ligue um número em Definições → Canais. |
APP-1103 |
Enviado através da ligação de WhatsApp errada. Esta conversação pertence ao seu número de WhatsApp Web, mas a mensagem foi enviada através do WhatsApp Business. | Responda a partir da própria conversação para que utilize o canal da própria conversação. |
APP-1104 |
Remetente de WhatsApp Business não configurado. A conta tentou enviar através do WhatsApp Business, mas não existe nenhum número de WhatsApp Business configurado. | Ligue um número de WhatsApp Business em Definições → Canais, ou mude o contacto para um canal que tenha ligado. Se um número estiver ligado, contacte o apoio ao cliente e indique este código. |
APP-1105 |
O WhatsApp não confirmou a mensagem. A mensagem foi entregue ao WhatsApp Web, mas o WhatsApp nunca confirmou a sua receção, pelo que é muito provável que não tenha chegado ao contacto. Isto significa, normalmente, que a ligação ao WhatsApp Web caiu por um momento durante o envio. | Verifique se o número de WhatsApp Web aparece como ligado em Definições → Canais e, em seguida, envie a mensagem novamente. |
APP-1201 |
Número de telefone inválido. O número de telefone do contacto não pôde ser validado. | Abra o contacto e corrija o número no formato internacional. |
APP-1301 |
Limite diário de novos contactos atingido. (aviso) Este número de WhatsApp Web atingiu o limite de hoje para enviar mensagens a pessoas que nunca lhe enviaram mensagens. O limite existe para proteger o número de ser banido. | Aguarde até amanhã. O limite aumenta à medida que o número é aquecido. Consulte Scaling WhatsApp outreach safely. |
APP-1401 |
Nenhum modelo aprovado anexado. Foi enviada uma mensagem de modelo 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 correio do destinatário rejeitou o endereço. | Verifique se existem erros ortográficos no endereço de e-mail do contacto. |
APP-1502 |
Nenhuma caixa de entrada de e-mail ligada. Esta conta não tem nenhuma caixa de entrada de e-mail ligada para enviar mensagens. | Ligue uma em Definições → Canais → E-mail. |
APP-1503 |
Não foi possível enviar o e-mail. O e-mail não pôde ser enviado pelo motivo apresentado na linha expandida. | Verifique as definições do seu fornecedor de e-mail em Definições → Fornecedor de E-mail Personalizado. |
APP-1601 |
Sessão do Telegram expirada. O início de sessão do Telegram para esta conta foi terminado, normalmente a partir das sessões ativas da aplicação Telegram. | Volte a ligar o Telegram em Definições → Canais. |
APP-1602 |
Bloqueado no Telegram. Um dos lados bloqueou o outro no Telegram, pelo que a mensagem não pode ser entregue. | Nada a corrigir a partir daqui. |
APP-1603 |
Falha na mensagem do Telegram. O Telegram não aceitou esta mensagem. | Tente novamente; se se repetir, volte a ligar o Telegram em Definições → Canais. |
APP-1701 |
SMS não configurado. Esta conta não tem nenhum remetente de SMS ligado. | Ligue a sua conta Twilio ou telemóvel Android em Definições → Fornecedor de SMS. |
APP-2001 |
Envio pausado: faturação. As mensagens de saída estão pausadas devido a uma fatura não paga ou a uma subscrição bloqueada. | Regularize o pagamento em Definições → Faturação; o envio será retomado automaticamente. |
APP-9001 |
Falha na entrega. A mensagem não pôde ser entregue. O motivo do fornecedor, quando existe, é apresentado na linha expandida. | Tente novamente; se continuar a acontecer, contacte o apoio ao cliente e indique este código e a hora. |
IA
Quando a IA não devolve uma resposta, esta tenta novamente de forma automática algumas vezes. Se ainda assim não conseguir responder, a conversação apresenta uma nota e o registo de erros recebe uma entrada APP-3306. Um chat que o agente tenha passado a uma pessoa (alertou um colega de equipa ou concluiu o chat) não conta: a IA mantém-se silenciosa de propósito, pelo que não aparece qualquer nota nem entrada APP-3306.
Canais
Faturação 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 a novas pessoas porque poucas responderam, o que coloca o número em risco. | Reveja com quem o agente está a entrar em contacto e a sua mensagem de abertura, depois volte a ligar o agente a partir da sua página. |
APP-5102 |
O protetor de envio parou uma transmissão. A transmissão foi parada porque parecia estar a ser enviada para pessoas que nunca lhe enviaram mensagens, o que coloca o número em risco. | Reveja o público-alvo e, em seguida, retome a partir da página de transmissão. |
APP-5103 |
Aviso do protetor de envio. (aviso) Uma transmissão está a enviar mensagens a muitas pessoas que nunca lhe enviaram mensagens. | Mantenha o público-alvo ativo e o volume gradual. Consulte Dimensionar o alcance do WhatsApp em segurança. |
APP-5104 |
Transmissão pausada automaticamente. A transmissão foi pausada após falhas repetidas. | Corrija a causa apresentada nas falhas de entrega e, em seguida, retome. |
Automatizações
| Código | O que significa | O que fazer |
|---|---|---|
APP-5001 |
A automatização requer a sua atenção. Uma automatização gerou um alerta que requer intervenção humana. | Abra a conversa ou a automatização associada. |
APP-5201 |
A execução da automatização falhou. Uma execução desta automatização parou com um erro; a mensagem do passo é apresentada na linha expandida. | Abra a execução para ver qual o passo que falhou, corrija as suas definições e repita a execução. Ative Falha na Automatização em Notificações para ser alertado quando isto acontecer. |
Integrações
Marcações
Próximos Passos
- Estado do Sistema — verifique se existe algum problema da nossa parte.
- Notificações — escolha quais as falhas que também lhe chegam por e-mail, notificação push ou pelo sino.
- Webhooks — envie eventos para os seus próprios sistemas.