Problemas comuns do WhatsApp e como corrigir

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.