Solução de problemas

Mensagens não chegam: como diagnosticar

Use este guia quando você precisar resolver ou investigar: Mensagens não chegam: como diagnosticar. Quando usar este guia Use quando uma pessoa afirma que enviou mensagem, mas ela não aparece na IAra. Antes de começar - Confirme o canal afetado e o número ou perfil usado pela pessoa que enviou a mensagem. - Tenha acesso aos filtros de conversa. - Se possível, peça um print da mensagem enviada pela pessoa atendida. - Anote horário exato do teste. Diagnóstico passo a passo 1. Confirme se a mensagem foi enviada para o número ou canal correto. 2. Verifique se a caixa de entrada está conectada. 3. Remova filtros de status, time, responsável e etiqueta para evitar que a conversa esteja escondida. 4. Pesquise pelo contato ou número da pessoa atendida. 5. Veja se a conversa entrou em outra caixa de entrada parecida. 6. Teste com outro número externo. 7. Compare se mensagens antigas do mesmo canal aparecem normalmente. Como testar - Envie uma mensagem simples de texto pelo canal afetado. - Repita com outro contato externo. - Teste fora do Wi-Fi, se o problema parecer local. - Anote horário de cada mensagem enviada. Problemas comuns e leitura do resultado - A pessoa enviou mensagem para um número antigo ou perfil errado. - Filtro mostra apenas conversas atribuídas a outro agente. - Conversa foi resolvida ou reaberta em outro status. - Canal está desconectado ou com provedor instável. - Mensagem entrou, mas foi roteada para time diferente. Evidências para salvar - Print da mensagem no aparelho da pessoa atendida. - Print da busca/filtro na IAra. - Horário e fuso. - Número ou perfil da pessoa atendida. - Nome da caixa de entrada esperada. Quando abrir chamado - Abra um chamado quando dois testes externos não chegarem. - Abra chamado se o canal aparece conectado, mas nenhuma mensagem nova entra. - Abra chamado se a mensagem entra no provedor, mas não aparece na IAra. Checklist final - [ ] Canal, caixa de entrada ou assistente correto identificado. - [ ] Teste controlado realizado com horário anotado. - [ ] Prints e links relevantes salvos. - [ ] Causa provável registrada. - [ ] Chamado aberto apenas se o diagnóstico local não resolver.

Mensagens não enviam: como diagnosticar

Use este guia quando o agente tenta enviar uma mensagem pela IAra e ela falha, fica sem confirmação ou aparece como enviada mas a pessoa atendida não recebe. Primeiro: enviada não quer dizer entregue Em canais assíncronos, a mensagem pode passar por várias camadas antes de chegar à pessoa atendida: IAra, provedor, canal e destinatário. Por isso, o status enviada normalmente significa que uma camada aceitou a tentativa, mas ainda não prova que a pessoa atendida recebeu. | Status | Como interpretar | O que fazer | |---|---|---| | Pendente | A mensagem foi registrada e ainda aguarda processamento ou confirmação. | Aguarde alguns minutos e veja se outros envios do mesmo canal também estão parados. | | Em processamento | A IAra está tentando despachar a mensagem ou aguardando retorno do canal. | Evite reenviar em massa; teste uma mensagem simples. | | Enviada | A tentativa foi aceita por uma camada anterior. | Confirme se evoluiu para entregue, lida ou falhou. | | Entregue | O canal confirmou chegada ao destino. | Não reenvie; siga o atendimento normalmente. | | Lida | O canal informou leitura. | Nem todo canal mostra leitura, então a ausência desse status nem sempre é erro. | | Falhou ou rejeitada | Alguma regra, credencial, política, payload, limite ou destinatário bloqueou o envio. | Use o erro exibido e o tipo de canal para ir ao artigo específico. | | Não suportada | O canal não aceita aquele formato, mídia ou tipo de mensagem. | Troque por texto, link ou formato suportado. | Diagnóstico rápido 1. Confirme o canal e a caixa de entrada usados no envio. 2. Veja se o erro acontece com todos os contatos ou apenas com um contato. 3. Envie uma mensagem curta, sem link, mídia, emoji, template ou automação. 4. Se texto simples funcionar, investigue formato, mídia, template, variável ou automação. 5. Se texto simples falhar também, verifique conexão do canal, permissão, limite ou instabilidade. 6. Compare o horário da tentativa com qualquer alerta do canal ou do provedor. 7. Colete evidências antes de pedir ajuda à Digi2B. Se aconteceu isso, comece por aqui | Sintoma | Causa mais provável | Próximo passo | |---|---|---| | Falha genérica sem código | A causa real ficou no canal, provedor ou regra de envio. | Teste texto simples e colete print, horário e ID da conversa. | | Fica pendente ou em processamento | A confirmação do canal ainda não voltou ou há fila de envio. | Aguarde, teste outro contato e veja se o problema afeta o canal inteiro. | | Aparece como enviada, mas cliente não recebeu | O canal aceitou a tentativa, mas a entrega final falhou ou não foi confirmada. | Valide se há status entregue/lido ou falha posterior. | | Erro 403 | Permissão, token, conexão ou autorização insuficiente. | Reconecte o canal com a conta correta e aceite todas as permissões. | | Erro 404 | Conversa, caixa, contato ou recurso não encontrado. | Confirme se o envio está na conta/canal certo e se o recurso ainda existe. | | Erro 422 | Conteúdo, variável, mídia ou payload inválido. | Remova mídia/variáveis e teste texto simples. | | Erro 429 | Limite de envio ou excesso de tentativas. | Reduza o ritmo e aguarde antes de reenviar. | | Erro 5xx ou timeout | Instabilidade temporária do provedor/canal. | Aguarde, evite retries agressivos e monitore se normaliza. | | Manual funciona, automação falha | A regra gerou mensagem fora de contexto ou payload inválido. | Revise gatilho, condição, template e identificador do contato. | | Só mídia falha | Arquivo, URL, tamanho, formato ou tipo não aceito. | Use o artigo de anexos e mídias. | Artigos específicos - Códigos de erro do WhatsApp: causas e soluções - Como diagnosticar falhas em templates do WhatsApp - Anexos e mídias não enviam - Erros de e-mail: SMTP, autenticação, DNS e bounces - Erros em Facebook, Instagram e Messenger - Falhas em automações, API e webhooks no envio Evidências mínimas para o suporte Digi2B - Print da conversa com status ou erro exibido. - Canal e caixa de entrada usados. - Horário exato da tentativa, com fuso horário. - ID ou link da conversa. - Tipo de mensagem: texto livre, template, mídia, resposta pronta, automação ou API. - Nome e idioma do template, se aplicável. - Arquivo ou tipo de mídia usado, se aplicável. - Se afeta um contato, alguns contatos ou todos os envios do canal. Quando tentar novamente Tente novamente quando o erro for temporário: timeout, instabilidade, limite de envio, manutenção do canal ou falha intermitente. Aguarde alguns minutos e evite reenviar várias vezes para o mesmo contato em sequência. Quando não reenviar sem corrigir Não reenvie em massa quando o erro indicar template inválido, permissão ausente, número inválido, mídia incompatível, conteúdo rejeitado ou regra de política do canal. Nesses casos, a nova tentativa tende a falhar de novo e pode piorar a reputação do canal.

A IA não está respondendo: diagnóstico

Use este guia quando você precisar resolver ou investigar: A IA não está respondendo: diagnóstico. Quando usar este guia Use quando o assistente deveria responder automaticamente, mas fica silencioso ou transfere sem motivo claro. Antes de começar - Identifique qual assistente deveria responder. - Confirme a caixa de entrada vinculada. - Tenha uma conversa de teste. - Confira se há créditos e se o recurso está habilitado. Diagnóstico passo a passo 1. Confirme se o canal está conectado e recebendo mensagens. 2. Verifique se o assistente está ativo. 3. Confira se o assistente está vinculado à caixa correta. 4. Veja se a conversa já foi assumida por humano ou movida para um status que impede IA. 5. Revise regras de automação que disparam ou bloqueiam a IA. 6. Confira créditos e possíveis falhas recentes. 7. Teste com uma pergunta simples, dentro do escopo e sem anexos. Como testar - Envie uma saudação simples. - Envie uma pergunta que está claramente na FAQ. - Envie pedido de humano para validar transferência. - Repita em conversa nova, não apenas em conversa antiga. Problemas comuns e leitura do resultado - Assistente ativo, mas não vinculado à caixa. - Conversa já está com humano e a IA não deve interferir. - Créditos insuficientes. - Regra de automação pausada. - Canal não entrega o evento de mensagem para a IA. Evidências para salvar - Nome do assistente. - Nome da caixa de entrada. - Link da conversa. - Mensagem enviada para teste. - Horário do teste. - Print de status/créditos quando disponível. Quando abrir chamado - Abra chamado se o assistente está ativo, vinculado, com crédito e mesmo assim não responde. - Abra chamado se a IA responde em um canal, mas não em outro com mesma configuração. - Abra chamado se houver erro visível na execução da IA. Checklist final - [ ] Canal, caixa de entrada ou assistente correto identificado. - [ ] Teste controlado realizado com horário anotado. - [ ] Prints e links relevantes salvos. - [ ] Causa provável registrada. - [ ] Chamado aberto apenas se o diagnóstico local não resolver.

A IA está respondendo errado: diagnóstico

Use este guia quando você precisar resolver ou investigar: A IA está respondendo errado: diagnóstico. Quando usar este guia Use quando a IA responde com informação incorreta, tom inadequado, excesso de confiança ou não transfere quando deveria. Antes de começar - Separe exemplos reais de respostas ruins. - Defina qual seria a resposta correta. - Tenha acesso às instruções, documentos e FAQs do assistente. - Evite corrigir só a conversa; corrija a causa na base. Diagnóstico passo a passo 1. Leia o histórico completo da conversa. 2. Classifique o erro: informação, tom, limite, base ausente, base contraditória ou falta de transferência. 3. Verifique se a informação correta existe nos documentos ou FAQs. 4. Procure documentos conflitantes ou desatualizados. 5. Revise a instrução do assistente para ver se o limite está claro. 6. Adicione exemplo de resposta desejada quando o tom estiver ruim. 7. Teste novamente com a pergunta original e com variações. Como testar - Repita a pergunta original. - Faça a mesma pergunta com outras palavras. - Teste uma pergunta fora do escopo. - Teste pedido explícito por humano. Problemas comuns e leitura do resultado - Base de conhecimento incompleta. - Documento antigo contradiz documento novo. - Prompt permite responder quando deveria dizer que não sabe. - IA não tem regra clara de transferência. - Pergunta do cliente é ambígua e a IA não pergunta contexto. Evidências para salvar - Print da resposta errada. - Resposta correta esperada. - Documento ou FAQ que deveria sustentar a resposta. - Link da conversa. - Horário do teste. Quando abrir chamado - Abra chamado se a IA continua errando após base e instrução corrigidas. - Abra chamado se a IA ignora regra explícita de transferência. - Abra chamado se respostas mudam muito sem alteração de base. Checklist final - [ ] Canal, caixa de entrada ou assistente correto identificado. - [ ] Teste controlado realizado com horário anotado. - [ ] Prints e links relevantes salvos. - [ ] Causa provável registrada. - [ ] Chamado aberto apenas se o diagnóstico local não resolver.

O WhatsApp desconectou: diagnóstico

Use este guia quando você precisar diagnosticar o problema com evidências suficientes antes de pedir ajuda à Digi2B. Quando usar este guia Use este guia para resolver ou revisar O WhatsApp desconectou: diagnóstico na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Roteiro de diagnóstico 1. Identifique o canal afetado e confirme se o problema acontece com todos os contatos ou só com um caso. 2. Anote data, horário, número, caixa de entrada, agente responsável e link da conversa, se houver. 3. Reproduza com um teste simples e controlado. 4. Verifique permissões, conexão do canal, filtros de conversa, status, automações e disponibilidade de agentes. 5. Compare com outro canal, outra conversa ou outro usuário para separar falha de configuração de falha externa. 6. Se não resolver, abra um chamado com resumo, impacto, evidências e testes realizados. Como escrever o chamado se precisar pedir ajuda Use este formato: - Conta: nome da conta afetada. - Canal: WhatsApp, Instagram, site, e-mail, IA ou outro. - Quando aconteceu: data, horário e fuso. - Impacto: quantos contatos, agentes ou conversas foram afetados. - Evidências: prints, link da conversa, mensagem de erro e teste realizado. - Resultado esperado: o que deveria ter acontecido. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

O QR Code do WhatsApp não aparece

Use este guia quando você precisar diagnosticar o problema com evidências suficientes antes de pedir ajuda à Digi2B. Quando usar este guia Use este guia para resolver ou revisar O QR Code do WhatsApp não aparece na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Roteiro de diagnóstico 1. Identifique o canal afetado e confirme se o problema acontece com todos os contatos ou só com um caso. 2. Anote data, horário, número, caixa de entrada, agente responsável e link da conversa, se houver. 3. Reproduza com um teste simples e controlado. 4. Verifique permissões, conexão do canal, filtros de conversa, status, automações e disponibilidade de agentes. 5. Compare com outro canal, outra conversa ou outro usuário para separar falha de configuração de falha externa. 6. Se não resolver, abra um chamado com resumo, impacto, evidências e testes realizados. Como escrever o chamado se precisar pedir ajuda Use este formato: - Conta: nome da conta afetada. - Canal: WhatsApp, Instagram, site, e-mail, IA ou outro. - Quando aconteceu: data, horário e fuso. - Impacto: quantos contatos, agentes ou conversas foram afetados. - Evidências: prints, link da conversa, mensagem de erro e teste realizado. - Resultado esperado: o que deveria ter acontecido. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Notificações não aparecem: diagnóstico

Use este guia quando você precisar configurar, entender ou validar Notificações não aparecem: diagnóstico na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Se você não estiver recebendo notificações, siga estas etapas uma por uma. 1. Certifique-se de que as notificações estejam ativadas para sua conta Vá para Configurações do perfil → Notificações e habilite os tipos desejados para E-mail e/ou Push. Se um tipo estiver desativado, a IAra não o enviará. 2. Verifique se você está incluído nessa conversa Você só recebe determinadas notificações quando está conectado à conversa da maneira certa: - Conversa criada: você deve ser colaborador dessa caixa de entrada. - Nova mensagem da conversa atribuída: a conversa deve ser atribuída a você. - Nova mensagem da conversa participando: você deve ser adicionado como participante. - Menção: alguém deve marcar/mencionar você em uma nota ou mensagem. Importante: - Se você não estiver atribuído e não for participante, você não receberá notificações de “novas mensagens” para essa conversa. - Uma menção pode notificá-lo mesmo que você ainda não seja participante. 3. Verifique o status da conversa - Para conversas pendentes, a IAra não envia notificações de “Conversa criada” ou “Conversa atribuída”. *As notificações não se limitam apenas a conversas “abertas”. 4. Verifique o tipo de mensagem - Notificações regulares de “novas mensagens” são enviadas apenas para mensagens normais de clientes/agentes, não para notas privadas ou eventos de atividade. *Notas privadas geralmente não acionam notificações regulares de novas mensagens. - Mas se alguém mencionar você em uma nota privada, você ainda poderá receber uma notificação de menção. 5. Se as notificações push estiverem faltando - Ative o push nas configurações do perfil da IAra. - Permita notificações nas configurações do seu navegador ou sistema operacional móvel. - Se a permissão do navegador/sistema operacional estiver bloqueada, o push não chegará. 6. Se as notificações por e-mail estiverem faltando - Confirme se as notificações por e-mail estão habilitadas para esse evento. - Confirme se seu e-mail foi verificado. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Conversa caiu no time errado: diagnóstico

Use este guia quando você precisar diagnosticar o problema com evidências suficientes antes de pedir ajuda à Digi2B. Quando usar este guia Use este guia para resolver ou revisar Conversa caiu no time errado: diagnóstico na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Roteiro de diagnóstico 1. Identifique o canal afetado e confirme se o problema acontece com todos os contatos ou só com um caso. 2. Anote data, horário, número, caixa de entrada, agente responsável e link da conversa, se houver. 3. Reproduza com um teste simples e controlado. 4. Verifique permissões, conexão do canal, filtros de conversa, status, automações e disponibilidade de agentes. 5. Compare com outro canal, outra conversa ou outro usuário para separar falha de configuração de falha externa. 6. Se não resolver, abra um chamado com resumo, impacto, evidências e testes realizados. Como escrever o chamado se precisar pedir ajuda Use este formato: - Conta: nome da conta afetada. - Canal: WhatsApp, Instagram, site, e-mail, IA ou outro. - Quando aconteceu: data, horário e fuso. - Impacto: quantos contatos, agentes ou conversas foram afetados. - Evidências: prints, link da conversa, mensagem de erro e teste realizado. - Resultado esperado: o que deveria ter acontecido. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Automação não executou: diagnóstico

Use este guia quando você precisar diagnosticar o problema com evidências suficientes antes de pedir ajuda à Digi2B. Quando usar este guia Use este guia para resolver ou revisar Automação não executou: diagnóstico na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Roteiro de diagnóstico 1. Identifique o canal afetado e confirme se o problema acontece com todos os contatos ou só com um caso. 2. Anote data, horário, número, caixa de entrada, agente responsável e link da conversa, se houver. 3. Reproduza com um teste simples e controlado. 4. Verifique permissões, conexão do canal, filtros de conversa, status, automações e disponibilidade de agentes. 5. Compare com outro canal, outra conversa ou outro usuário para separar falha de configuração de falha externa. 6. Se não resolver, abra um chamado com resumo, impacto, evidências e testes realizados. Como escrever o chamado se precisar pedir ajuda Use este formato: - Conta: nome da conta afetada. - Canal: WhatsApp, Instagram, site, e-mail, IA ou outro. - Quando aconteceu: data, horário e fuso. - Impacto: quantos contatos, agentes ou conversas foram afetados. - Evidências: prints, link da conversa, mensagem de erro e teste realizado. - Resultado esperado: o que deveria ter acontecido. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Não consigo acessar minha conta

Use este guia quando você precisar diagnosticar o problema com evidências suficientes antes de pedir ajuda à Digi2B. Quando usar este guia Use este guia para resolver ou revisar Não consigo acessar minha conta na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Roteiro de diagnóstico 1. Identifique o canal afetado e confirme se o problema acontece com todos os contatos ou só com um caso. 2. Anote data, horário, número, caixa de entrada, agente responsável e link da conversa, se houver. 3. Reproduza com um teste simples e controlado. 4. Verifique permissões, conexão do canal, filtros de conversa, status, automações e disponibilidade de agentes. 5. Compare com outro canal, outra conversa ou outro usuário para separar falha de configuração de falha externa. 6. Se não resolver, abra um chamado com resumo, impacto, evidências e testes realizados. Como escrever o chamado se precisar pedir ajuda Use este formato: - Conta: nome da conta afetada. - Canal: WhatsApp, Instagram, site, e-mail, IA ou outro. - Quando aconteceu: data, horário e fuso. - Impacto: quantos contatos, agentes ou conversas foram afetados. - Evidências: prints, link da conversa, mensagem de erro e teste realizado. - Resultado esperado: o que deveria ter acontecido. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

O chat do site não aparece

Use este guia quando você precisar diagnosticar o problema com evidências suficientes antes de pedir ajuda à Digi2B. Quando usar este guia Use este guia para resolver ou revisar O chat do site não aparece na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Roteiro de diagnóstico 1. Identifique o canal afetado e confirme se o problema acontece com todos os contatos ou só com um caso. 2. Anote data, horário, número, caixa de entrada, agente responsável e link da conversa, se houver. 3. Reproduza com um teste simples e controlado. 4. Verifique permissões, conexão do canal, filtros de conversa, status, automações e disponibilidade de agentes. 5. Compare com outro canal, outra conversa ou outro usuário para separar falha de configuração de falha externa. 6. Se não resolver, abra um chamado com resumo, impacto, evidências e testes realizados. Como escrever o chamado se precisar pedir ajuda Use este formato: - Conta: nome da conta afetada. - Canal: WhatsApp, Instagram, site, e-mail, IA ou outro. - Quando aconteceu: data, horário e fuso. - Impacto: quantos contatos, agentes ou conversas foram afetados. - Evidências: prints, link da conversa, mensagem de erro e teste realizado. - Resultado esperado: o que deveria ter acontecido. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

E-mail não chega ou não envia pela IAra

Use este guia quando você precisar diagnosticar o problema com evidências suficientes antes de pedir ajuda à Digi2B. Quando usar este guia Use este guia para resolver ou revisar E-mail não chega ou não envia pela IAra na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Roteiro de diagnóstico 1. Identifique o canal afetado e confirme se o problema acontece com todos os contatos ou só com um caso. 2. Anote data, horário, número, caixa de entrada, agente responsável e link da conversa, se houver. 3. Reproduza com um teste simples e controlado. 4. Verifique permissões, conexão do canal, filtros de conversa, status, automações e disponibilidade de agentes. 5. Compare com outro canal, outra conversa ou outro usuário para separar falha de configuração de falha externa. 6. Se não resolver, abra um chamado com resumo, impacto, evidências e testes realizados. Como escrever o chamado se precisar pedir ajuda Use este formato: - Conta: nome da conta afetada. - Canal: WhatsApp, Instagram, site, e-mail, IA ou outro. - Quando aconteceu: data, horário e fuso. - Impacto: quantos contatos, agentes ou conversas foram afetados. - Evidências: prints, link da conversa, mensagem de erro e teste realizado. - Resultado esperado: o que deveria ter acontecido. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Instagram ou Facebook não conectam

Use este guia quando você precisar diagnosticar o problema com evidências suficientes antes de pedir ajuda à Digi2B. Quando usar este guia Use este guia para resolver ou revisar Instagram ou Facebook não conectam na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Roteiro de diagnóstico 1. Identifique o canal afetado e confirme se o problema acontece com todos os contatos ou só com um caso. 2. Anote data, horário, número, caixa de entrada, agente responsável e link da conversa, se houver. 3. Reproduza com um teste simples e controlado. 4. Verifique permissões, conexão do canal, filtros de conversa, status, automações e disponibilidade de agentes. 5. Compare com outro canal, outra conversa ou outro usuário para separar falha de configuração de falha externa. 6. Se não resolver, abra um chamado com resumo, impacto, evidências e testes realizados. Como escrever o chamado se precisar pedir ajuda Use este formato: - Conta: nome da conta afetada. - Canal: WhatsApp, Instagram, site, e-mail, IA ou outro. - Quando aconteceu: data, horário e fuso. - Impacto: quantos contatos, agentes ou conversas foram afetados. - Evidências: prints, link da conversa, mensagem de erro e teste realizado. - Resultado esperado: o que deveria ter acontecido. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Como limpar cache e recarregar o navegador

Use este guia quando você precisar configurar, entender ou validar Como limpar cache e recarregar o navegador na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Uma recarga forçada força seu navegador a ignorar o cache e buscar a versão mais recente de uma página da web no servidor. Isso é útil quando você está enfrentando problemas devido a arquivos em cache desatualizados. Veja como fazer isso em diferentes navegadores: Chrome Recarga difícil - Windows/Linux: pressione Ctrl + F5 - Mac: pressione Cmd + Shift + R Recarga forçada com cache desativado - Abra o DevTools (F12 ou Cmd + Option + I), clique com o botão direito do mouse no botão recarregar e escolha "Esvaziar cache e recarregar totalmente". Firefox Recarga difícil - Windows: pressione Ctrl + F5 ou Shift + F5 - Mac: pressione Cmd + Shift + R Recarga forçada com cache desativado - Abra o DevTools (F12), clique no ícone de configurações (engrenagem), marque "Desativar Cache" e recarregue. Edge Recarga difícil - Pressione Ctrl + F5 Recarga forçada com cache desativado - Abra o DevTools (F12), clique com o botão direito do mouse no botão recarregar para "Empty Cache and Hard Reload" (ou ative "Disable Cache" na guia de rede) e recarregue. Safári (Mac) - Pressione Cmd + Opção + R Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Anexos e mídias não enviam

Use este guia quando texto simples envia normalmente, mas imagens, vídeos, documentos, áudios, stickers ou arquivos falham. Causas mais comuns - Arquivo acima do limite aceito pelo canal. - Formato, codec ou extensão não suportados. - URL privada, expirada, bloqueada por login ou inacessível pelo provedor. - Content-type incorreto no arquivo hospedado. - Nome de arquivo com caracteres especiais que o canal rejeita. - Mídia enviada dentro de template com parâmetro incompatível. - Canal ou provedor recusando aquele tipo de mensagem. Teste de isolamento 1. Envie uma mensagem de texto simples para o mesmo contato. 2. Se texto falhar, o problema não é a mídia; volte ao diagnóstico geral. 3. Se texto funcionar, envie uma imagem pequena em formato comum. 4. Se a imagem pequena funcionar, o problema está no arquivo original. 5. Se qualquer mídia falhar, teste outro contato e outro canal. 6. Se a mídia vem de automação/API, envie manualmente o mesmo arquivo pela conversa. Como resolver por sintoma | Sintoma | Provável causa | Correção | |---|---|---| | Só um arquivo falha | Tamanho, formato, codec ou nome do arquivo. | Converta, reduza tamanho e renomeie o arquivo. | | Toda mídia falha no WhatsApp | Canal/provedor recusando upload ou download. | Teste arquivo simples e colete código 131052/131053, se aparecer. | | Link de mídia falha | URL privada, expirada ou sem content-type correto. | Use URL pública, estável e acessível sem login. | | Template com mídia falha | Variável de mídia incompatível ou template mal preenchido. | Confira tipo do cabeçalho e parâmetros do template. | | Vídeo falha, imagem funciona | Codec, duração, tamanho ou formato do vídeo. | Exporte em formato mais comum e menor. | | Documento falha | Arquivo grande, extensão bloqueada ou política do canal. | Envie link seguro ou converta para formato aceito. | Códigos comuns de mídia no WhatsApp | Código | Leitura prática | Ação | |---|---|---| | 131052 | O canal não conseguiu baixar a mídia. | Verifique se a URL é pública, estável e não expira rápido. | | 131053 | O canal recusou upload, formato ou processamento. | Reduza tamanho, troque formato e valide o tipo do arquivo. | | 131051 | Tipo de mensagem não suportado. | Use texto, imagem comum ou link como fallback. | | 63005 ou 63021 | Conteúdo recusado pelo provedor/canal. | Ajuste arquivo, payload ou componente de mídia. | Antes de pedir ajuda - Envie o arquivo original ou um link de download. - Informe canal, caixa de entrada, contato e horário da tentativa. - Diga se texto simples funciona para o mesmo contato. - Diga se outro arquivo pequeno funciona. - Inclua print do erro ou código retornado.

A IA demora para responder

Use este guia quando você precisar configurar e usar este recurso com clareza operacional. Quando usar este guia Use este guia para resolver ou revisar A IA demora para responder na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Passo a passo operacional 1. Acesse a área correspondente no painel da IAra. 2. Revise se você está na conta, caixa de entrada, time ou assistente correto. 3. Faça a configuração ou ação descrita pelo artigo. 4. Teste usando um cenário realista, mas controlado. 5. Confirme se o resultado aparece para quem precisa operar: agente, gestor, cliente ou suporte. 6. Documente qualquer diferença de tela para ajustar o artigo antes da publicação. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Erro de permissão ao acessar recurso

Use este guia quando você precisar diagnosticar o problema com evidências suficientes antes de pedir ajuda à Digi2B. Quando usar este guia Use este guia para resolver ou revisar Erro de permissão ao acessar recurso na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Roteiro de diagnóstico 1. Identifique o canal afetado e confirme se o problema acontece com todos os contatos ou só com um caso. 2. Anote data, horário, número, caixa de entrada, agente responsável e link da conversa, se houver. 3. Reproduza com um teste simples e controlado. 4. Verifique permissões, conexão do canal, filtros de conversa, status, automações e disponibilidade de agentes. 5. Compare com outro canal, outra conversa ou outro usuário para separar falha de configuração de falha externa. 6. Se não resolver, abra um chamado com resumo, impacto, evidências e testes realizados. Como escrever o chamado se precisar pedir ajuda Use este formato: - Conta: nome da conta afetada. - Canal: WhatsApp, Instagram, site, e-mail, IA ou outro. - Quando aconteceu: data, horário e fuso. - Impacto: quantos contatos, agentes ou conversas foram afetados. - Evidências: prints, link da conversa, mensagem de erro e teste realizado. - Resultado esperado: o que deveria ter acontecido. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Atributo obrigatório bloqueou o atendimento

Use este guia quando você precisar diagnosticar o problema com evidências suficientes antes de pedir ajuda à Digi2B. Quando usar este guia Use este guia para resolver ou revisar Atributo obrigatório bloqueou o atendimento na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Roteiro de diagnóstico 1. Identifique o canal afetado e confirme se o problema acontece com todos os contatos ou só com um caso. 2. Anote data, horário, número, caixa de entrada, agente responsável e link da conversa, se houver. 3. Reproduza com um teste simples e controlado. 4. Verifique permissões, conexão do canal, filtros de conversa, status, automações e disponibilidade de agentes. 5. Compare com outro canal, outra conversa ou outro usuário para separar falha de configuração de falha externa. 6. Se não resolver, abra um chamado com resumo, impacto, evidências e testes realizados. Como escrever o chamado se precisar pedir ajuda Use este formato: - Conta: nome da conta afetada. - Canal: WhatsApp, Instagram, site, e-mail, IA ou outro. - Quando aconteceu: data, horário e fuso. - Impacto: quantos contatos, agentes ou conversas foram afetados. - Evidências: prints, link da conversa, mensagem de erro e teste realizado. - Resultado esperado: o que deveria ter acontecido. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Erros de e-mail: SMTP, autenticação, DNS e bounces

Use este artigo quando mensagens de e-mail não saem pela IAra, voltam com bounce, caem em spam ou falham por autenticação. Separe envio, entrega e entregabilidade - Envio: a IAra conseguiu entregar a mensagem ao servidor SMTP configurado. - Entrega: o servidor do destinatário aceitou a mensagem. - Entregabilidade: a mensagem chegou à caixa principal, spam, quarentena ou foi recusada por política. Diagnóstico rápido 1. Confirme se a caixa de e-mail está conectada na IAra. 2. Envie um e-mail simples, sem anexo e sem link. 3. Se falhar, revise credenciais, porta e segurança do SMTP. 4. Se enviar mas cair em spam, revise SPF, DKIM e DMARC. 5. Se voltar bounce, leia se o código é 4xx temporário ou 5xx permanente. 6. Se só falha com anexo, reduza tamanho ou use link. Famílias de erro | Família | Como aparece | Causa provável | Correção | |---|---|---|---| | EMAIL-AUTH | authentication failed, invalid credentials, username/password not accepted | Senha, app password, MFA, SMTP AUTH ou permissão da caixa. | Atualize credenciais e método de autenticação. | | EMAIL-TLS | TLS handshake failed, certificate error, connection refused, timeout | Porta ou modo SSL/TLS/STARTTLS incorreto, firewall ou indisponibilidade. | Corrija porta, segurança e servidor SMTP/IMAP. | | EMAIL-DNS | cai em spam, rejeição por política, domínio desalinhado | SPF, DKIM ou DMARC ausente/incorreto. | Ajuste DNS do domínio remetente. | | EMAIL-4XX | 421, 450, 451, 452 | Falha temporária do servidor remoto. | Aguarde e tente novamente com intervalo. | | EMAIL-5XX | 550, 551, 552, 553, 554 | Falha permanente, destinatário inválido, política ou tamanho. | Corrija endereço, conteúdo, remetente ou anexo. | | EMAIL-SIZE/POLICY | message too big, relay denied, delivery not authorized | Anexo grande, remetente não autorizado ou política de segurança. | Reduza anexos, verifique remetente e use links quando adequado. | Códigos SMTP úteis | Código | Leitura prática | O que fazer | |---|---|---| | 421 | Serviço indisponível temporariamente. | Tentar novamente depois. | | 450 ou 451 | Caixa/servidor temporariamente indisponível. | Aguardar e reenviar com intervalo. | | 452 | Limite ou recurso insuficiente no destino. | Reduzir volume/tamanho e tentar depois. | | 550 | Destinatário inexistente, sem acesso ou rejeição por política. | Corrigir endereço ou política do remetente. | | 551 | Usuário não local ou precisa redirecionamento. | Validar endereço correto. | | 552 ou 5.3.4 | Mensagem ou anexo grande demais. | Reduzir anexo ou substituir por link. | | 553 | Endereço inválido. | Corrigir destinatário/remetente. | | 554 ou 5.7.1 | Transação falhou por política/autorização. | Revisar autenticação, reputação, conteúdo e DNS. | Quando pedir ajuda à Digi2B - A caixa está conectada, mas todo envio falha. - O provedor mudou política de senha, MFA ou autenticação. - O bounce não deixa claro se a falha é temporária ou permanente. - SPF, DKIM ou DMARC foram ajustados e o problema continua. Envie print do erro, provedor, endereço remetente, destinatário, horário, bounce completo e se o teste sem anexo funcionou.

Erros em Facebook, Instagram e Messenger

Use este artigo quando Facebook, Instagram ou Messenger aparecem conectados, mas mensagens não enviam, não chegam ou falham sem motivo claro. Causas mais comuns | Família | Sintoma | Causa provável | Correção | |---|---|---|---| | META-190 | OAuthException, token inválido, sessão expirada. | Token expirou, sessão foi revogada ou a conta perdeu acesso. | Reconecte o canal com o usuário correto. | | META-PERM | Permissão insuficiente, mensagem recusada, acesso negado. | Escopos, tarefas da página ou permissões do app ausentes. | Aceite todas as permissões no fluxo de reconexão. | | META-WINDOW | Não envia para usuário que não interagiu ou conversa antiga. | Política do canal limita contato fora do contexto permitido. | Aguarde nova interação do usuário ou use mecanismo oficial permitido. | | META-LINK | Página/Instagram desconectado, ativo errado, webhook incompleto. | Página, conta profissional ou vínculo entre ativos está incorreto. | Refaça o vínculo e reconecte a caixa de entrada. | Diagnóstico passo a passo 1. Confirme se o canal afetado é Facebook, Instagram ou Messenger. 2. Verifique se a conta do Instagram é profissional quando o canal exigir. 3. Confirme se a página correta está vinculada à conta correta. 4. Reconecte o canal com um usuário que tenha acesso administrativo aos ativos. 5. Aceite todas as permissões solicitadas no fluxo de conexão. 6. Teste com uma conversa recente iniciada pelo próprio pessoa atendida. 7. Se o problema for intermitente, compare horários e veja se afeta todos os perfis ou apenas um ativo. Sinais de permissão incorreta - A conexão aparece ativa, mas envio falha. - Mensagens chegam, mas respostas não saem. - Apenas algumas páginas ou perfis falham. - O usuário que conectou perdeu papel administrativo. - A conta foi reconectada, mas sem aceitar todas as permissões. Antes de pedir ajuda à Digi2B - Envie print do erro na conversa. - Informe página, perfil ou conta profissional afetada. - Informe quem conectou o canal e se essa pessoa ainda tem acesso aos ativos. - Diga se o pessoa atendida iniciou a conversa recentemente. - Envie horário exato e link da conversa na IAra.

Falhas em automações, API e webhooks no envio

Use este artigo quando o envio manual funciona, mas a mensagem enviada por automação, bot, API, webhook ou integração externa falha. O que normalmente muda nesse cenário Quando um agente envia manualmente, a IAra usa o contexto visível da conversa. Quando uma automação ou API envia, o conteúdo depende de regra, payload, identificador do contato, estado da conversa e permissões do canal. Um erro pequeno em qualquer uma dessas partes pode impedir o envio. Diagnóstico rápido 1. Envie manualmente uma mensagem curta na mesma conversa. 2. Se manual falhar também, volte ao diagnóstico geral do canal. 3. Se manual funcionar, revise a regra, gatilho ou payload que gerou a mensagem. 4. Confirme se a conversa está aberta e elegível para receber aquela mensagem. 5. Confirme se o contato, conversa, caixa e canal usados são os corretos. 6. Remova variáveis, mídia e botões para testar conteúdo mínimo. 7. Se houver limite de envio, aplique intervalo entre tentativas. Erros comuns | Família | Como aparece | Causa provável | Correção | |---|---|---|---| | API-400/422 | invalid payload, unprocessable entity, contato inválido, conversa inválida. | Campo obrigatório ausente, identificador incorreto ou conteúdo fora do formato. | Corrija payload, IDs e schema da integração. | | API-CTX | Regra dispara, mas a mensagem não sai. | Automação fora do contexto real da conversa ou canal. | Ajuste condição, janela, time, status ou handoff. | | API-WH | Evento não chega, status não atualiza ou bot não dispara. | Webhook/evento externo indisponível, inválido ou atrasado. | Revalide URL, autenticação, assinatura e resposta do endpoint. | | GEN-006 | Conteúdo vazio, mídia inválida ou tipo não suportado. | Variável vazia, anexo incompatível ou componente inválido. | Defina fallback para variável vazia e teste texto simples. | | GEN-007 | 429, rate limit, muitas tentativas. | Automação gerando volume alto ou repetido. | Reduza ritmo, deduplique gatilhos e use intervalo. | | GEN-008 | 5xx, timeout ou instabilidade externa. | Provedor, webhook ou integração temporariamente indisponível. | Aguarde, aplique retry controlado e monitore recorrência. | Como diferenciar erro de canal e erro de automação | Teste | Resultado | Interpretação | |---|---|---| | Manual falha e automação falha | Problema no canal, conta, contato ou política. | Investigue o canal antes da automação. | | Manual funciona e automação falha | Problema de regra, payload, variável ou contexto. | Revise a automação/API. | | Texto funciona e mídia falha | Problema de arquivo, URL, formato ou template com mídia. | Use o artigo de anexos e mídias. | | Um contato falha e outro funciona | Destinatário, janela, bloqueio ou limite por contato. | Valide contato e política do canal. | Evidências para suporte ou implantação - Nome da automação, bot, fluxo ou integração. - Gatilho que deveria enviar a mensagem. - Link da conversa e horário da tentativa. - Conteúdo gerado pela automação. - Variáveis usadas e valores reais preenchidos. - Print do erro ou retorno da API. - Confirmação se envio manual funciona na mesma conversa.

Catálogo completo de erros de envio na IAra

Use este catálogo quando você já tem um código, mensagem de erro ou sintoma e precisa encontrar rapidamente a causa provável e a primeira ação recomendada. Se você ainda não sabe por onde começar, leia primeiro Mensagens não enviam: como diagnosticar. Se o erro for de template, mídia, e-mail, Meta ou automação, os artigos específicos continuam sendo a melhor leitura guiada. Como pesquisar neste artigo - Pesquise pelo código exato, como 132001, 131047, 63016, 550, META-190, EMAIL-AUTH ou API-400/422. - Pesquise pela mensagem exibida, como Template does not exist, Rate limit exceeded, OAuthException, relay denied ou content can't be blank. - Pesquise pelo sintoma, como pendente, enviada mas não entregue, mídia não envia, token inválido, fora da janela ou bounce. Erros gerais da IAra e de canais | Código/família | Mensagens comuns | Causa provável | O que fazer | |---|---|---|---| | GEN-001 | Falha ao enviar, mensagem não enviada, não foi possível concluir o envio | A causa real ficou em uma camada inferior: credencial, política do canal, timeout, payload ou provedor. | Reduza para o menor teste possível: texto simples, sem automação e sem anexo. | | GEN-002 | Pendente, processing, em processamento | Fila, job, confirmação de webhook ou dependência temporariamente indisponível. | Aguarde, teste outro contato e veja se o problema afeta o canal inteiro. | | GEN-003 | Sent sem delivered/read, enviada mas não entregue | Aceite inicial seguido de rejeição posterior, callback ausente, bloqueio do destinatário ou status atrasado. | Use o status do canal/provedor como fonte principal de entrega real. | | GEN-004, 403 | forbidden, access denied, permission denied, insufficient permission | Token, escopo, conexão, papel do usuário ou autorização insuficiente. | Reconecte o canal com a conta correta e aceite todas as permissões solicitadas. | | GEN-005, 404 | not found, conversation not found, inbox not found | Recurso apagado, ID incorreto, conta errada, cache antigo ou referência inválida. | Confirme conta, caixa, contato, conversa e IDs usados no envio. | | GEN-006, 422 | unprocessable entity, invalid payload, content can't be blank, unsupported content | Conteúdo vazio, campo obrigatório ausente, JSON fora do schema, anexo inválido ou tipo não suportado. | Corrija o payload ou teste texto simples sem anexo/variável. | | GEN-007, 429 | rate limit exceeded, throughput exceeded, too many requests | Limite por app, canal, número, destinatário, página, provedor ou automação. | Reduza ritmo, use fila e aguarde antes de tentar de novo. | | GEN-008, 500, 502, 503, 504, timeout | server error, webhook não responde, conexão encerrada | Instabilidade temporária, provedor fora, DNS/TLS, webhook lento ou latência alta. | Trate como temporário, aplique espera/backoff e monitore recorrência. | WhatsApp: códigos Meta e Cloud API | Código | Nome curto | Leitura operacional | O que fazer | |---|---|---|---| | 1, WA-1/2/131000/135000 | API unknown | Erro genérico da API ou solicitação sem detalhe suficiente. | Teste de novo com texto simples e colete o retorno completo se persistir. | | 2, WA-1/2/131000/135000 | API service | Sobrecarga ou indisponibilidade temporária da API. | Aguarde e tente novamente com intervalo. | | 368, WA-368/130497/131031 | Temporarily blocked | Bloqueio temporário por política/compliance. | Interrompa envios e revise política, qualidade e status da conta. | | 130429, WA-130429 | Throughput exceeded | Taxa global de envio excedida. | Reduza volume, segmente envios e use backoff. | | 130472, WA-130472 | User number in experiment | Número do destinatário em experimento ou limitação do canal. | Use canal alternativo ou tente mais tarde. | | 130497, WA-368/130497/131031 | Country restriction | Restrição por país ou alcance geográfico. | Verifique restrição da conta/canal antes de reenviar. | | 131000, WA-1/2/131000/135000 | Something went wrong | Erro genérico sem detalhe suficiente. | Reproduza com payload mínimo e colete o retorno bruto. | | 131005, WA-131005/131008 | Access denied | Acesso negado, token/escopo/permissão inadequados. | Reconecte ou revise permissões do canal. | | 131008, WA-131005/131008 | Required parameter missing | Parâmetro obrigatório ausente. | Complete destinatário, template, componentes ou campos obrigatórios. | | 131016, WA-131016/131057 | Service unavailable | Serviço temporariamente indisponível. | Aguarde normalização e tente novamente com intervalo. | | 131021 | Sender equals recipient | Remetente e destinatário são o mesmo número. | Use outro número para teste/envio. | | 131026, WA-131026 | Message undeliverable | Mensagem não entregável ao destinatário. | Confirme número, WhatsApp ativo, bloqueio, atualização do app e aceite de termos. | | 131031, WA-368/130497/131031 | Account locked | Conta bloqueada. | Trate como incidente de conta/política e peça ajuda à Digi2B com evidências. | | 131037 | Display name not approved | Nome de exibição ou número em condição que exige aprovação. | Revise aprovação do número/nome no provedor/canal. | | 131042, WA-131042 | Business eligibility/payment issue | Elegibilidade comercial, pagamento, WABA ou conta com problema. | Regularize conta comercial, pagamento e status do número. | | 131047, WA-131047 | Re-engagement message | Tentativa de texto livre fora da janela de 24h. | Use template aprovado para iniciar ou retomar conversa. | | 131049, WA-131049 | Healthy ecosystem engagement | Entrega suprimida por proteção, frequência, qualidade ou elegibilidade. | Reduza frequência, melhore segmentação e revise qualidade dos templates. | | 131051, WA-131051 | Unsupported message type | Tipo de mensagem não suportado. | Troque por texto, link ou formato aceito pelo canal. | | 131052, WA-131052/131053 | Media download error | O canal não conseguiu baixar a mídia. | Use URL pública, estável, sem login, com content-type correto e sem expiração curta. | | 131053, WA-131052/131053 | Media upload error | Upload, formato, tamanho, codec ou processamento da mídia rejeitado. | Reduza tamanho, troque formato e teste arquivo simples. | | 131056, WA-131056 | Pair rate limit hit | Limite por par remetente-destinatário. | Aguarde antes de reenviar para o mesmo contato. | | 131057, WA-131016/131057 | Account in maintenance mode | Conta/número em manutenção ou upgrade. | Aguarde e evite volume alto até normalizar. | | 132000, WA-132000 | Template param count mismatch | Quantidade de variáveis diferente do template. | Envie exatamente os parâmetros exigidos, na ordem correta. | | 132001, WA-132001 | Template does not exist | Template inexistente, não aprovado, idioma incorreto ou não sincronizado. | Confira nome técnico, idioma, categoria e status do template. | | 132005 | Template hydrated text too long | Texto final do template excede limite. | Reduza variáveis longas e conteúdo dinâmico. | | 132007 | Template format character policy violated | Violação de política de caracteres/formatação. | Revise quebras, símbolos, emojis e conteúdo sensível. | | 132012, WA-132012 | Template parameter format mismatch | Tipo ou estrutura da variável incorreta. | Corrija texto, moeda, data, mídia, botão ou components. | | 135000, WA-1/2/131000/135000 | Generic user error | Erro genérico de requisição/usuário. | Refine o diagnóstico com retorno bruto, contato, template e payload usado. | Facebook, Instagram e Messenger | Código/família | Mensagens comuns | Causa provável | O que fazer | |---|---|---|---| | META-190 | OAuthException, token inválido, token expirado, sessão invalidada | Token expirou, sessão foi revogada ou a conta perdeu acesso. | Reconecte o canal com o usuário correto. | | META-PERM | permissões insuficientes, access denied, pages_messaging ausente, task de mensagem ausente | Escopos, tarefas da página ou permissões do app ausentes. | Reconecte aceitando todas as permissões e confirme papel administrativo. | | META-WINDOW | não é possível enviar fora da janela/contexto, usuário não iniciou conversa | Política do canal limita contato não solicitado. | Aguarde nova interação ou use mecanismo oficial permitido pelo canal. | | META-LINK | página desconectada, Instagram não vinculado, webhook incompleto, conta não profissional | Página, conta profissional, vínculo Página-Instagram ou subscribed fields incorretos. | Refaça vínculo e reconecte a caixa de entrada. | E-mail, SMTP, DNS e bounces | Código/família | Mensagens comuns | Causa provável | O que fazer | |---|---|---|---| | EMAIL-AUTH | authentication failed, invalid credentials, username/password not accepted, SMTP AUTH disabled | Senha, app password, MFA, SMTP AUTH ou permissão da caixa. | Atualize credenciais e método de autenticação. | | EMAIL-TLS | TLS handshake failed, certificate error, EOF, connection refused, timeout | Porta, SSL/TLS/STARTTLS, certificado, firewall, DNS ou indisponibilidade. | Corrija servidor, porta e política de segurança. | | EMAIL-DNS | e-mail cai em spam, rejeição por política, domínio desalinhado | SPF, DKIM ou DMARC ausente/incorreto. | Ajuste DNS do domínio remetente. | | EMAIL-4XX, 4.x.x | 421, 450, 451, 452 | Falha temporária do servidor remoto ou limitação transitória. | Aguarde e tente novamente com intervalo. | | EMAIL-5XX, 5.x.x | 550, 551, 552, 553, 554 | Falha permanente: endereço, política, remetente, conteúdo ou tamanho. | Corrija antes de reenviar. | | EMAIL-SIZE/POLICY | message too big, relay denied, delivery not authorized | Anexo grande, remetente não autorizado, relay bloqueado ou política de conteúdo. | Reduza anexo, use link e verifique remetente/autorização. | Códigos SMTP e enhanced status | Código | Leitura operacional | Natureza | O que fazer | |---|---|---|---| | 421 | Service not available, servidor indisponível. | Temporário | Tente depois. | | 450 | Mailbox unavailable temporário. | Temporário | Aguarde e tente novamente. | | 451 | Local error in processing. | Temporário | Aguarde; se persistir, peça o bounce completo. | | 452 | Recursos/armazenamento insuficientes. | Temporário | Reduza volume/tamanho e tente depois. | | 500 | Syntax error. | Permanente até correção | Corrija comando/payload SMTP. | | 501 | Syntax error in parameters. | Permanente até correção | Corrija parâmetros do endereço/mensagem. | | 502 | Command not implemented. | Permanente até correção | Revise compatibilidade do servidor. | | 503 | Bad sequence of commands. | Permanente até correção | Revise sequência/autenticação SMTP. | | 504 | Parameter not implemented. | Permanente até correção | Remova parâmetro não suportado. | | 550 | Mailbox unavailable, no access ou rejeição por política. | Permanente | Corrija destinatário, remetente ou política. | | 551 | User not local. | Permanente | Confirme endereço correto ou redirecionamento. | | 552, 5.3.4 | Exceeded storage, too much mail data, message too big. | Pode ser permanente | Reduza anexo ou use link. | | 553 | Mailbox name invalid. | Permanente | Corrija endereço. | | 554, 5.7.1 | Transaction failed, delivery not authorized. | Permanente até correção | Revise autenticação, reputação, conteúdo e DNS. | Twilio e provedores intermediários | Código/família | Nome curto | Leitura operacional | O que fazer | |---|---|---|---| | 63005, TW-63005/63021 | Channel did not accept content | Canal recusou o conteúdo. | Ajuste formato, componentes, mídia ou política do conteúdo. | | 63010 | Internal error | Erro interno do provedor. | Aguarde e colete retorno completo se persistir. | | 63012 | Provider internal service error | Serviço interno do provedor falhou. | Trate como temporário e monitore. | | 63013, TW-63013 | Channel policy violation | Violação de política do canal. | Corrija conteúdo e reenvie apenas após validação. | | 63016, TW-63016 | Outside allowed window | Fora da janela permitida. | Use template oficial ou aguarde nova interação. | | 63017, TW-63017/63018 | Rate limit exceeded | Limite excedido no provedor. | Reduza ritmo e aplique espera. | | 63018, TW-63017/63018 | Rate limit exceeded for channel | Limite excedido no canal. | Segmente envios e use fila. | | 63021, TW-63005/63021 | Invalid content | Conteúdo inválido. | Corrija estrutura, variáveis, mídia ou texto. | | 63040, TW-63040/63041/63042 | Template rejected | Template rejeitado. | Corrija e submeta novamente ou use outro template. | | 63041, TW-63040/63041/63042 | Template paused | Template pausado. | Use outro template ativo e revise qualidade. | | 63042, TW-63040/63041/63042 | Template disabled | Template desabilitado. | Substitua o template e revise política. | | TW-PROV-400/401/403/500/502 | Erro do provedor intermediário | API disabled, invalid api_key, endpoint blocked, internal server error, WhatsApp API not available. | Regularize credencial, pagamento, status da conta ou disponibilidade do provedor. | API, webchat, bots, webhooks e automações | Código/família | Mensagens comuns | Causa provável | O que fazer | |---|---|---|---| | API-400/422, 400, 422 | invalid payload, contact not found, identifier invalid, conversation not eligible, unprocessable entity | Schema quebrado, identificador errado, sessão encerrada, canal incompatível ou conteúdo inválido. | Corrija payload, contato, conversa e tipo de mensagem. | | API-CTX | automação dispara mas mensagem não sai, sessão não elegível, regra fora de contexto | Estado da conversa/canal não permite aquela ação. | Ajuste condição, janela, status, handoff e elegibilidade. | | API-WH | evento não chega, status não atualiza, bot não dispara, webhook silencioso | Webhook/evento externo indisponível, inválido, atrasado ou desconectado. | Revalide URL, autenticação, assinatura, resposta 2xx e processamento real do endpoint. | | 403 em API | forbidden, permission denied | Token/escopo/conta sem permissão. | Revise credencial e permissões da integração. | | 404 em API | not found, conversation not found, contact not found | ID incorreto, recurso apagado ou conta errada. | Corrija IDs e ambiente usado. | | 429 em API/automação | too many requests, rate limit exceeded | Automação repetindo envios ou volume alto. | Deduplique gatilhos, use fila e aplique intervalo. | | 5xx/timeout em webhook | endpoint não responde, conexão encerrada, status não atualiza | Instabilidade externa, DNS/TLS, latência ou endpoint fora. | Aplique retry controlado e monitore health do endpoint. | Problemas sem código explícito | Sintoma | Possível causa | O que fazer | |---|---|---| | Falha sem código na tela | Detalhe real ficou no provedor, webhook ou payload. | Teste mensagem simples e colete horário, canal, conversa e print. | | Mensagem aceita, mas sem delivered/failed | Callback/status webhook ausente ou atrasado. | Aguarde, valide status no canal/provedor e evite reenviar em massa. | | Canal degradado | Parte dos envios funciona, parte fica em sent/pendente. | Compare horários e veja se afeta todos os contatos ou só alguns. | | Timeout de rede | A plataforma não sabe se o request foi aceito. | Aguarde reconciliação antes de reenviar. | | Configuração incompleta | Conexão parece ativa, mas falta scope, task, webhook field ou vínculo. | Reconecte o canal e revise permissões. | | Desconexão silenciosa | Token funciona para algumas chamadas, mas não para enviar. | Refaça a conexão com o usuário correto. | | Manual funciona, automação falha | Regra, payload, variável ou contexto inválido. | Revise automação/API antes de culpar o canal. | | Só mídia falha | URL, MIME, extensão, codec, tamanho ou expiração. | Teste arquivo menor em formato comum e URL pública. | | E-mail sai, mas cai em spam | SPF, DKIM, DMARC, reputação ou cabeçalhos. | Corrija autenticação de domínio antes de aumentar volume. | O que separar antes de pedir ajuda à Digi2B - Canal, caixa de entrada, conversa, horário exato, código exibido e tipo de mensagem. - Template usado, idioma, variáveis, arquivo/URL de mídia, bounce de e-mail ou retorno bruto do provedor quando estiver disponível.