Use este guia quando você precisar configurar, entender ou validar **Problemas comuns do WhatsApp e como corrigir** 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 ## Mensagens do WhatsApp não recebidas mesmo que tudo pareça conectado ### Sintomas * O canal WhatsApp foi conectado com sucesso * O status do número de telefone mostra **Conectado** * A classificação de qualidade é **Verde** * Nenhum erro é mostrado na IAra * As mensagens enviadas podem funcionar, mas **as mensagens recebidas não são recebidas** ### Por que isso acontece Em alguns casos, o Meta exige que o número de telefone do WhatsApp seja **registrado novamente**, mesmo que ainda pareça conectado e íntegro. Isso geralmente acontece depois: * Uma mudança no nome de exibição * Atualizações do perfil comercial * Certos problemas internos de sincronização do Meta-side Quando isso ocorre, as mensagens do WhatsApp podem parar de ser entregues silenciosamente, sem apresentar erros visíveis. Este é um comportamento Meta conhecido. ### Como consertar Registrar novamente o número de telefone do WhatsApp resolve o problema imediatamente (pergunte-nos no suporte e resolveremos para você) *Não são necessárias alterações de plano * Nenhuma alteração no webhook é necessária * Na maioria dos casos, **nenhum novo código de verificação é necessário** Assim que o número for registrado novamente, a entrega da mensagem será retomada normalmente. ## Problemas de status do nome de exibição (pendente/rejeitado/não aprovado) ### O que é um nome de exibição? O nome de exibição é o nome comercial mostrado aos clientes no WhatsApp.\ Meta revisa e aprova esse nome antes de se tornar ativo. ### Status comuns de nomes de exibição * **Aprovado** – Tudo está bem, nenhuma ação necessária * **Pendente** – Meta está revisando o nome * **Rejeitado** – O nome não atendeu às diretrizes da Meta ### Por que os problemas de nomes de exibição são importantes * Um nome de exibição rejeitado ou pendente pode atrasar a integração *Alterar o nome de exibição pode exigir **registrar novamente o número de telefone** *As mensagens podem falhar ou parar de funcionar se o registro não for concluído após a aprovação ### Razões comuns para rejeição * O nome não corresponde ao nome da empresa no Meta Business Manager * Uso de palavras genéricas (por exemplo, “Suporte”, “Oficial”, “Serviço”) * Uso de emojis, símbolos ou letras maiúsculas * Incompatibilidade entre nome da marca e site/domínio ### Práticas recomendadas para nomes de exibição * Use seu **nome comercial ou marca oficial** * Combine o nome usado em seu site e no Meta Business Manager * Evite emojis, slogans ou descritores extras * Mantenha-o simples e consistente com a marca ### Nota importante Depois que um nome de exibição for aprovado, o Meta ainda poderá exigir que o número de telefone seja **registrado novamente** para que a alteração tenha efeito total. Se as mensagens do WhatsApp pararem de funcionar após uma atualização do nome de exibição, registrar novamente o número geralmente resolve o problema. ## Erro do WhatsApp 131049 – O usuário não aceitou os Termos de Serviço do WhatsApp ### O que é o erro 131049? O erro 131049 significa que o destinatário não aceitou os Termos de Serviço mais recentes do WhatsApp. Este erro é retornado pelo WhatsApp, não pela IAra, e é específico para o número de telefone do cliente, não para a configuração da sua empresa. ### Quando esse erro ocorre? Você pode ver o erro 131049 quando: * Enviando uma mensagem para um usuário que não abriu o WhatsApp recentemente * O WhatsApp lançou Termos de Serviço atualizados * O usuário não aceitou os novos termos em seu aplicativo WhatsApp Nesse estado, o WhatsApp **bloqueia a entrega de mensagens** para esse usuário até que ele aceite os termos. ### Por que isso acontece O WhatsApp exige que todos os usuários aceitem explicitamente os Termos de Serviço atualizados antes que possam: * Receba mensagens de empresas *Participe de conversas de negócios Até que o usuário aceite os termos, o WhatsApp rejeitará mensagens com erro **131049**. ### Como corrigir o erro 131049 Este problema **não pode ser corrigido na IAra ou na sua conta do WhatsApp Business**. O **pessoa atendida deve**: 1. Abra o aplicativo WhatsApp 2. Aceite o prompt dos Termos de Serviço mais recente Assim que o usuário aceitar os termos, as mensagens começarão a ser entregues automaticamente – nenhuma nova tentativa ou alteração de configuração será necessária. --- ## 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.