Your AI Connector Docs

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-mail e LinkedIn.
  • Vezes em que a IA não respondeu, e porquê — nenhum agente definido para responder, créditos esgotados, limite atingido, horário encerrado.
  • 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 e campanhas que foram pausadas automaticamente.
  • Execuções de automação que pararam com um erro.
  • Webhooks que estão a falhar ou que foram desligados 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.

Quando contactar 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 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)

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 contacto estava desligado, fora de cobertura ou não pode receber mensagens de texto. Tente novamente mais tarde. Se continuar a falhar, verifique se o número é um número de telemóvel.
TW-30004 Texto bloqueado. A operadora ou o destinatário bloqueou este texto. A pessoa pode ter bloqueado o seu número, optado por não receber ou o conteúdo foi filtrado. Se optou por não receber, a pessoa precisa de enviar START para o seu número. Caso contrário, tente uma redação mais curta e simples.
TW-30005 Número desconhecido ou já não existe. A operadora não reconhece este número. Pode estar desligado ou mal digitado. Verifique o número com o contacto.
TW-30006 Linha fixa ou operadora inalcançável. Este número é uma linha fixa ou pertence a uma operadora que não pode receber textos. Utilize um número de telemóvel ou contacte o destinatário por outro canal.
TW-30007 Texto filtrado como spam. O filtro de spam da operadora bloqueou este texto. Evite encurtadores de ligações, TUDO EM MAIÚSCULAS e textos idênticos repetidos. Para números dos EUA, certifique-se de que o seu registo Twilio A2P 10DLC está completo.
TW-30008 Falha na entrega por um motivo desconhecido. A operadora comunicou uma falha sem uma causa específica. Tente novamente. Se se repetir para este número, contacte a pessoa de outra forma.
TW-30024 Remetente não registado na operadora. O número a partir do qual está a enviar ainda não está registado ou verificado na operadora de destino. Na sua conta Twilio, complete o registo do número (A2P 10DLC ou verificação de número gratuito) e aguarde até que apareça como verificado.
TW-30034 Número dos EUA não registado para A2P 10DLC. As operadoras dos EUA bloqueiam textos de números que não estão ligados a uma campanha A2P 10DLC aprovada. Complete o registo da marca e da campanha na sua Consola 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. Chegou uma mensagem, mas nenhum agente de IA ativo estava configurado para responder nesse canal, pelo que 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 desse canal.
APP-3002 IA pausada: sem créditos. A IA não respondeu porque a conta ficou sem créditos. Carregue ou ative o carregamento automático em Definições → Faturação.
APP-3003 IA pausada: faturação. A IA não respondeu porque a subscrição está bloqueada por faturação. Regularize o pagamento em Definições → Faturação.
APP-3004 A sua chave de IA falhou e o recurso de reserva está desligado. A sua própria chave de fornecedor de IA devolveu um erro e o recurso de reserva para a IA da plataforma está desligado, pelo que não foi gerada nenhuma resposta. Corrija a chave em Definições → Modelo de IA, ou ligue o recurso de reserva.
APP-3101 A sua chave de fornecedor de IA tem um problema. A sua própria chave de fornecedor de IA foi rejeitada. Os seus bots continuam a funcionar com a IA da plataforma entretanto. Verifique a chave e a faturação do fornecedor em Definições → Modelo de IA.
APP-3201 Bot parado: limite de mensagens atingido para este contacto. (aviso) A IA atingiu o número máximo de mensagens permitido para este contacto e parou. Assuma o controlo da conversa ou aumente o limite de mensagens por contacto nas definições do agente.
APP-3301 IA ignorada: fora do horário ativo. (apenas informação) A mensagem chegou fora do horário de disponibilidade do bot. Ajuste o horário em Disponibilidade do agente se deveria ter respondido.
APP-3302 IA ignorada: gatilho de palavra-chave. (apenas informação) A mensagem do contacto correspondeu a uma palavra-chave que pausa a IA. Reveja as palavras-chave de pausa nas definições do agente.
APP-3303 IA ignorada: contacto optou por não receber. (apenas informação) Este contacto está excluído da IA. Remova a exclusão no contacto se não era essa a intenção.
APP-3304 IA ignorada: resposta a story do Instagram. (apenas informação) As respostas a stories do Instagram estão desligadas para este agente. Ative as respostas a stories nas definições de Instagram do agente se quiser que sejam respondidas.

Canais

Código O que significa O que fazer
APP-1111 WhatsApp Web desligado. O número do WhatsApp Web perdeu a ligação e precisa de uma nova digitalização de código QR. As mensagens em fila enquanto está em baixo não são enviadas. Abra Definições → Canais e clique em Voltar a ligar, depois digitalize o código QR.
APP-1112 Problema de ligação ao WhatsApp Business. A Meta reportou um problema com a sua ligação ao WhatsApp Business; o detalhe é mostrado na linha expandida. Siga o detalhe; se mencionar um token ou permissão, volte a ligar em Definições → Canais.
APP-1113 Conflito de entrega do Instagram. Outra aplicação detém o controlo das conversas do Instagram para esta conta, pelo que as respostas podem ser bloqueadas. No Meta Business Suite, defina a aplicação ligada como o recetor principal para mensagens do Instagram.
APP-1114 Limite de envio do WhatsApp Web atingido. (aviso) O número atingiu o seu limite de envio por agora. Aguarde; o limite reinicia diariamente e cresce à medida que o número aquece.

Faturação e Limites

Código O que significa O que fazer
APP-2002 Pagamento em atraso. O último pagamento da subscrição falhou. O serviço é interrompido se permanecer por pagar. Atualize o método de pagamento em Definições → Faturação.
APP-2003 Envio de saída pausado. O envio de mensagens de saída foi pausado devido a um problema de faturação não resolvido. Regularize o pagamento em Definições → Faturação.
APP-2004 Sem créditos. O saldo de créditos atingiu zero, pelo que as respostas da IA e as mensagens pagas param. Carregue ou ative o carregamento automático em Definições → Faturação.
APP-2101 Limite de contactos atingido. O limite de contactos do plano foi atingido, pelo que o envio de mensagens por IA está pausado para novos contactos. Atualize o plano ou remova contactos não utilizados.

Base de Conhecimento

Código O que significa O que fazer
APP-4001 Falha na importação da base de conhecimento. As páginas de uma importação não puderam ser lidas. Verifique se o site é acessível publicamente (sem barreira de início de sessão) 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 demasiadas mensagens falharam seguidamente. Leia as falhas acima no registo, corrija a causa e retome a campanha.
APP-5102 O protetor de envio parou uma difusão. A difusã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 a audiência e retome a partir da página de difusão.
APP-5103 Aviso do protetor de envio. (aviso) Uma difusão está a enviar mensagens para muitas pessoas que nunca lhe enviaram mensagens. Mantenha a audiência aquecida e o volume gradual. Veja Escalar o alcance do WhatsApp em segurança.
APP-5104 Difusão pausada automaticamente. A difusão foi pausada após falhas repetidas. Corrija a causa mostrada nas falhas de entrega e retome.

Automatizações

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

Integrações

Código O que significa O que fazer
APP-6001 Falha na entrega do webhook. O seu endpoint de webhook está a rejeitar ou a exceder o tempo limite nas entregas; a última resposta é apresentada na linha expandida. Verifique se o endpoint está ativo e devolve um estado 2xx rapidamente.
APP-6002 Webhook desativado após falhas repetidas. O webhook foi desligado porque continuava a falhar. Os eventos não estão a ser entregues ao mesmo. Corrija o endpoint e, em seguida, reative o webhook em Definições → Webhooks.

Marcações

Código O que significa O que fazer
APP-7001 Não é possível ler o calendário da sala. O Google Calendar associado a uma sala não pôde ser lido, pelo que a disponibilidade dessa sala pode estar incorreta. Partilhe novamente o calendário com a conta Google ligada ou volte a ligar o Google Calendar.

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.