Use este guia quando você precisar configurar, entender ou validar **Inconsistências de números de WhatsApp no Brasil e Argentina** 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

Nos últimos anos, alguns países alteraram os seus sistemas de numeração móvel para acomodar o crescimento. Essas mudanças criaram inconsistências entre o número que você pode discar hoje e o número que o WhatsApp armazenou para contas mais antigas.

* **Brasil:** Um "9" foi adicionado após o código de área para todos os números de celular, criando um formato total de 13 dígitos. Exemplo: +55 11 9 8765-4321 em vez de +55 11 8765-4321.

* **Argentina**: Os números podem aparecer com ou sem um “9” após o código do país, dependendo de quando a conta do WhatsApp foi registrada. Exemplo: +54 9 11 1234-5678 vs +54 11

  1234-5678.

Por causa disso, quando a IAra inicia uma conversa no WhatsApp (usando o formato discável “correto”), o WhatsApp pode responder com o número registrado mais antigo do usuário. Isso pode criar contatos duplicados e interromper o fluxo de tickets na sua caixa de entrada.

Infelizmente, esse problema vem do próprio WhatsApp. Não há **nenhuma correção no nível da API** e é improvável que o WhatsApp atualize contas antigas para corresponder às novas regras de numeração.

## Como IAra resolve isso

Adicionamos lógica para evitar automaticamente contatos e tickets duplicados quando ocorrem essas incompatibilidades:

* **Caso 1: Mensagem recebida com um novo formato de número**
  (por exemplo, `+55` código do país + código de área + **9** + número, total de 13 dígitos)
  → Nenhuma alteração necessária. A mensagem está vinculada diretamente ao contato existente.

* **Caso 2: Mensagem recebida com um número no formato antigo**
  (por exemplo, `+55` código do país + código de área + número, 12 dígitos no total, faltando o dígito extra)
  → IAra verifica se já existe um contato no novo formato.
  → Nesse caso, vinculamos a mensagem ao contato correto em vez de criar uma duplicata.

## O que isso significa para você

* Você ainda pode notar a diferença na aparência dos números no WhatsApp e na aparência no seu CRM.

* Você pode continuar enviando mensagens aos clientes normalmente. A IAra cuida da incompatibilidade de plano de fundo

* A IAra normaliza automaticamente os números de telefone dos formatos antigos e novos nos bastidores para garantir uma correspondência consistente de contatos, independentemente do formato que o WhatsApp retorna.

---

## 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.