Como podemos ajudar?
Pesquise aqui os artigos ou procure as categorias abaixo.
Browse by topic
Find guides, tutorials, and answers organised by category.
Comece por aqui
Primeiros passos para acessar a IAra, entender a plataforma, testar o ambiente e colocar o atendimento em operação.
Browse
Conta, equipe e permissões
Configurações de conta, perfil, notificações, agentes, times, permissões e organização administrativa da IAra.
Browse
Canais de atendimento
Guias para conectar e gerenciar caixas de entrada, chat do site, Instagram, Facebook, e-mail, API e outros canais.
Browse
WhatsApp na IAra
Conexão, reconexão, QR Code, mensagens, templates, boas práticas e diagnóstico de problemas no WhatsApp.
Browse
Atendimento no dia a dia
Rotina dos agentes: conversas, transferências, etiquetas, respostas prontas, notas internas e encerramento de atendimento.
Browse
IAra — Agente de IA
Configuração e operação do agente de IA, assistentes, Copilot, documentos, FAQs, memórias, créditos, testes e prompts.
Browse
Automações e integrações
Workflows, webhooks, integrações externas, Google Calendar, CRM, N8N, Clinicorp e automações operacionais.
Browse
Kanban e CRM
Gestão visual de oportunidades, tarefas, etapas, funis comerciais e processos operacionais dentro da IAra.
Browse
Relatórios e gestão
Leitura gerencial de relatórios, SLA, produtividade, canais, agentes, etiquetas, IA, CSAT e rotinas de acompanhamento.
Browse
Solução de problemas
Diagnósticos guiados para problemas de WhatsApp, IA, mensagens, notificações, canais, automações e acesso.
Browse
Playbooks por segmento
Modelos de implantação e operação da IAra para clínicas, odontologia, estética, imobiliárias, escolas, e-commerce e suporte.
Browse
Modelos prontos
Prompts, mensagens, etiquetas, FAQs, checklists e scripts prontos para acelerar a operação com IA.
Browse
Segurança e LGPD
Boas práticas de acesso, permissões, dados sensíveis, auditoria, privacidade e segurança no atendimento.
Browse
Chamados e suporte Digi2B
Como acionar o suporte Digi2B, quais evidências enviar, como estruturar chamados e como acompanhar a resolução.
Browse
Novidades e atualizações
Changelog, novos recursos, melhorias, correções importantes e comunicados de evolução da plataforma.
Browse
Central de ajuda e autoatendimento
Como criar, organizar e evoluir uma central de ajuda dentro da IAra, com artigos, categorias, vídeos, domínio e conteúdo para IA.
Browse
Migrações e importações
Guias para migrar histórico, contatos, processos e rotinas de outras ferramentas para a IAra com segurança.
Browse
Popular articles
What other people are reading right now.
Como ler relatórios de SLA
Use este guia quando você precisar configurar, entender ou validar Como ler relatórios de SLA na IAra. Antes de começar na IAra Na tela: A configuração de SLA fica em Configurações > SLA; clique em Adicionar SLA para criar uma política de prazo. adicionar SLA. - 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 Os relatórios de SLA fornecem uma visão geral da conformidade de suas equipes com seus contratos. A taxa de acerto é a métrica mais importante a ser rastreada, ela mede a porcentagem de SLAs que foram cumpridos com sucesso. Quanto maior for essa taxa de acerto, melhor será sua conformidade. Na tela: Depois de configurar, acompanhe os dados de SLA nos relatórios para enxergar cumprimento e atrasos. relatório SLA. Filtragem Você pode filtrar o relatório com base nos seguintes atributos - Política de SLA - Caixa de entrada - Agente - Equipe - Etiqueta Isso permite que você tenha uma visão abrangente de que tipo de conversa tem a melhor ou a pior taxa de acerto. Isso também pode ser útil para monitorar o desempenho da equipe e dos agentes. Você também pode filtrar o relatório com base em uma data, o que torna mais fácil encontrar a taxa de acerto de uma equipe específica a cada trimestre e acompanhar historicamente como essa métrica mudou. Lista de conversas A lista de conversas mostra os erros de SLA mais recentes, clique no botão Ver detalhes para obter um resumo da linha do tempo de eventos perdidos de SLA, pode ser usado pelos gerentes para fazer a triagem das conversas que falharam consistentemente em seus SLAs e poder tomar medidas para garantir que seus clientes obtenham o serviço desejado no tempo estipulado. 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.
🎧 Chamados e suporte Digi2BO que enviar ao suporte
Use este guia quando você precisar abrir, acompanhar ou escalar demandas para a Digi2B com contexto suficiente. Quando usar este guia Use este guia para resolver ou revisar O que enviar ao suporte 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.
❓ Central de ajuda e autoatendimentoComo criar uma central de ajuda na IAra
Use este guia quando você precisar configurar, entender ou validar Como criar uma central de ajuda na IAra 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 Você pode criar facilmente um portal de autoatendimento para seus clientes acessarem artigos e informações. Neste guia, orientamos você nas etapas de configuração de uma Central de Ajuda, incluindo a criação de um portal e a adição de artigos. Você pode configurar sua Central de Ajuda em três partes, conforme explicado abaixo. I. Criando um portal Etapa 1. Clique no ícone da Central de Ajuda na barra lateral e clique no botão "Novo Portal". Na tela: Na área da Central de Ajuda, revise as informações iniciais e clique em Criar portal para salvar o portal. criar portal da central. Na tela: Depois de criar o portal, revise as configurações antes de divulgar a URL pública. configurações do portal. II. Criando categorias Na tela: Use categorias para organizar os artigos antes de publicar a central para clientes. categorias. III. Criando artigos Finalmente, comece a escrever seus artigos. Siga as etapas abaixo. Etapa 1. Você pode encontrar o botão "Novo Artigo" em quase todas as páginas. Clique nele. Etapa 2. Use o editor de texto para escrever seu artigo. Use a barra lateral para selecionar a categoria e o autor do seu artigo e atualizar o metaconteúdo. Aqui está um exemplo: Você pode usar o botão "Visualizar" para ver o resultado do seu artigo. Quando estiver pronto, clique em “Publicar”. Seu artigo ao vivo ficará assim: 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.
⚙️ Automações e integraçõesComo configurar horário comercial e resposta automática
Use este guia quando você precisar configurar, entender ou validar Como configurar horário comercial e resposta automática 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 Horário Comercial define quando sua equipe estará disponível. Eles alimentam três coisas: Na tela: Se o horário comercial acionar regras automáticas, revise a automação relacionada depois de configurar os horários. automação e horário comercial. 1. Mensagem de ausência temporária — os clientes que enviam mensagens fora do horário comercial veem uma mensagem personalizada em vez de nada 2. Comportamento do temporizador de SLA — quando os SLAs são configurados para usar o horário comercial, o relógio é pausado durante a noite e nos finais de semana 3. Precisão dos relatórios — as métricas de tempo de resposta podem ser calculadas em relação ao tempo de trabalho em vez do horário de trabalho O horário comercial é definido por caixa de entrada, portanto, uma caixa de entrada de suporte dos EUA e uma caixa de entrada de suporte da UE podem ter horários completamente diferentes. Permissões: Somente administradores podem configurar o horário comercial e a mensagem de ausência temporária de uma caixa de entrada. Configurando o horário comercial em uma caixa de entrada 1. Vá para Configurações → Caixas de entrada e abra a caixa de entrada que deseja configurar. 2. Clique na guia Horário comercial. 3. Ative Ativar disponibilidade comercial para esta caixa de entrada. 4. Escolha seu fuso horário — todos os horários programados são interpretados nesse fuso horário. 5. Para cada dia da semana defina: - Hora de início e Hora de término, ou - Marcar o dia como fechado o dia todo ou - Marque o dia como aberto o dia todo 6. Escreva sua mensagem de ausência temporária — seja curta e útil. "Obrigado por entrar em contato! Nossa equipe está disponível de segunda a sexta, das 9h às 18h EST. Entraremos em contato com você amanhã bem cedo." é um padrão sólido. 7. Salve. O que os clientes veem? Quando um cliente envia uma mensagem recebida para uma caixa de entrada que está fora do horário comercial, a IAra envia automaticamente a mensagem de ausência configurada de volta para ele como uma resposta de saída. Assim, um cliente que envia uma mensagem para sua caixa de entrada do WhatsApp à meia-noite recebe uma resposta de ausência temporária no WhatsApp. \ Algumas regras regem quando a resposta automática é acionada: - A mensagem de ausência temporária é enviada uma vez por dia, por conversa — mensagens repetidas do mesmo cliente no mesmo dia não geram uma segunda resposta automática. - Se um agente tiver enviado uma resposta pública na conversa nos últimos 5 minutos, a resposta automática será suprimida (para que uma conversa que ainda esteja sendo tratada ativamente no final do horário comercial não seja interrompida). A resposta automática é informativa. Não impede a pessoa atendida de enviar mais e não altera o status da conversa. A conversa chega normalmente e os agentes a veem sempre que a caixa de entrada volta em horário comercial. Como o horário comercial altera os temporizadores de SLA? Se você configurou um SLA com Somente durante o horário comercial ativado, o cronômetro faz uma pausa fora do horário comercial: - Mensagens do cliente na sexta-feira às 18h com SLA de 4 horas - A caixa de entrada está fechada das 18h de sexta às 9h de segunda-feira - O cronômetro não funciona no fim de semana - Prazo de vigência: segunda-feira às 13h (4 horas úteis a partir das 9h de segunda-feira aberto) Se o horário comercial estiver desativado no SLA (ou desativado na caixa de entrada), o cronômetro funcionará 24 horas por dia, 7 dias por semana — sexta-feira, 18h + 4 horas = sexta-feira, 22h. Como o horário comercial aparece nos relatórios? Na seção Relatórios, a maioria dos relatórios tem uma alternância de horário comercial. Quando ativado: o tempo médio de primeira resposta, o tempo de resolução etc. são calculados apenas em relação ao tempo de trabalho — os intervalos noturnos não contam. Perguntas frequentes Posso ter horários comerciais diferentes para dias diferentes? Sim – você define horários de início/término por dia de forma independente. Sábado, das 10h às 14h, enquanto de segunda a sexta, das 9h às 18h, é uma configuração normal. Posso configurar o horário comercial para toda a conta e não por caixa de entrada? Não diretamente. Cada caixa de entrada tem sua própria programação. Se você tiver muitas caixas de entrada que devem compartilhar o mesmo horário, será necessário defini-las em cada uma delas – mas isso também é um recurso, já que equipes em fusos horários diferentes geralmente atendem caixas de entrada diferentes. A IAra bloqueia mensagens fora do horário comercial? Não. A caixa de entrada está sempre aberta para receber. O horário comercial apenas controla o que nós mostramos ao cliente e como os cronômetros se comportam. E se um feriado fechar o escritório por um dia? Não há calendário de feriados integrado. Altere temporariamente esse dia para fechado o dia todo e reverta mais tarde. 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.
🛠️ Solução de problemasCatá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.
📲 WhatsApp na IAraCódigos de erro do WhatsApp: causas e soluções
Use este artigo quando a IAra, a Meta, a API oficial do WhatsApp ou o provedor retornar um código de erro no envio. Ordem recomendada de diagnóstico 1. Confirme se a conversa está dentro da janela permitida para resposta livre. 2. Se estiver fora da janela, use template aprovado e ativo. 3. Valide nome técnico, idioma e variáveis do template. 4. Confirme se o número do destinatário usa WhatsApp e está completo com DDI/DDD. 5. Se houver mídia, teste uma mensagem sem anexo. 6. Se houver volume alto, reduza ritmo e aguarde os limites normalizarem. 7. Se o erro envolver política, bloqueio ou conta comercial, acione o suporte Digi2B com as evidências. Limites, instabilidade e erros temporários Código Significado provável Como resolver 130429 Throughput excedido. O número ou conta ultrapassou o ritmo permitido. Reduza o volume, use filas, segmente envios e aguarde antes de reenviar. 131056 Limite por par remetente-destinatário. Aguarde antes de enviar novamente para o mesmo contato. 131016 Serviço temporariamente indisponível. Aguarde e tente novamente com intervalo. 131057 Conta ou número em manutenção/upgrade. Aguarde normalização e evite volume alto durante a janela. 1, 2, 131000 ou 135000 Erro genérico da API ou do serviço. Repita com texto simples e colete retorno completo se persistir. 130472 Número do destinatário afetado por limitação/experimento do canal. Use canal alternativo ou tente novamente mais tarde. Janela de 24 horas e templates Código Significado provável Como resolver 131047 Tentativa de reengajamento fora da janela permitida. Use um template aprovado para iniciar ou retomar a conversa. 132001 Template inexistente, não aprovado, indisponível ou idioma incorreto. Confira nome técnico, idioma e status do template. 132000 Quantidade de variáveis diferente do template. Envie exatamente a quantidade de parâmetros exigida. 132012 Tipo ou formato de parâmetro inválido. Corrija texto, moeda, data, mídia ou estrutura dos componentes. 132005 Texto final do template ficou longo demais. Reduza variáveis e conteúdo gerado. 132007 Formatação/caracteres violam política do template. Revise quebras, emojis, símbolos e texto promocional sensível. Destinatário, mídia e tipo de mensagem Código Significado provável Como resolver 131026 Mensagem não entregável ao destinatário. Confirme número, DDI/DDD, WhatsApp ativo, bloqueio e aceite dos termos do app. 131051 Tipo de mensagem não suportado. Troque por formato aceito, como texto ou link. 131052 Erro ao baixar mídia. Use URL pública, estável, sem expiração curta e com content-type correto. 131053 Erro ao enviar ou processar mídia. Reduza tamanho, troque formato e teste arquivo simples. 131021 Remetente e destinatário são o mesmo número. Envie para outro número de teste. Permissão, conta, pagamento e política Código Significado provável Como resolver 131005 Acesso negado. Reconecte o canal com permissões corretas. 131008 Parâmetro obrigatório ausente. Revise dados do template, destinatário e payload. 131042 Elegibilidade comercial, pagamento ou conta WhatsApp Business com problema. Regularize a conta comercial e acione o suporte Digi2B se necessário. 368, 130497 ou 131031 Bloqueio, restrição geográfica ou conta bloqueada. Interrompa envios e trate como incidente de política/compliance. 131049 Entrega suprimida por proteção do ecossistema, frequência, qualidade ou elegibilidade. Reduza frequência, melhore segmentação e revise qualidade dos templates. Códigos comuns via Twilio ou provedor intermediário Código Significado provável Como resolver 63016 Fora da janela permitida. Use template oficial ou aguarde nova interação do cliente. 63040, 63041 ou 63042 Template rejeitado, pausado ou desabilitado. Corrija, substitua ou ressubmeta o template. 63005 ou 63021 Conteúdo inválido ou recusado pelo canal. Ajuste formato, variáveis, mídia e componentes. 63013 Violação de política do canal. Revise o conteúdo antes de tentar novamente. 63017 ou 63018 Rate limit excedido. Reduza ritmo, aplique espera e segmente envios. Quando pedir ajuda à Digi2B - O código afeta grande volume ou todos os envios do número. - A conta, número ou WABA aparece bloqueada/restrita. - O erro persiste mesmo com texto simples e contato de teste válido. - O template está aprovado, mas falha com 132001, 132000 ou 132012. - A IAra mostra enviado, mas o provedor retorna falha posterior. Envie o código, horário, número remetente, número destinatário, link da conversa, nome do template e print do erro.