> For the complete documentation index, see [llms.txt](https://docs.helena.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helena.app/duvidas-e-novidades/faq/numero-privado-z-api.md).
# Número Privado (Z-API)
Recentemente, o WhatsApp implementou uma mudança de privacidade na forma como os números de telefone são exibidos em novas conversas, introduzindo um identificador chamado **LID**. Isso pode, em alguns casos, gerar dúvidas e a criação de contatos duplicados na plataforma.
Esta documentação explica o que é o LID, por que isso acontece e como você deve proceder para gerenciar e unificar seus contatos.
**1. O que é o "LID"? Por que estou vendo um número estranho em vez do telefone do cliente?**
O LID é um identificador temporário que o WhatsApp agora usa para novas conversas, a fim de proteger a privacidade do usuário.
* **Por que acontece:** Quando um cliente que não está na sua lista de contatos (ou que tem configurações de privacidade restritas) inicia uma conversa, o WhatsApp pode enviar primeiro este LID em vez do número de telefone real.
* **Comportamento da plataforma:** Nosso sistema exibe o LID que recebe no campo de nome do contato. Assim que o cliente interage e o WhatsApp libera o número real, o sistema automaticamente cria (ou atualiza) o contato com o número correto.
* **Importante:** Enquanto o sistema só tiver o LID, **não é possível responder** à conversa, pois a plataforma ainda não tem o número de telefone para o qual enviar a mensagem.
**2. Por que isso cria contatos duplicados?**
O problema de duplicação ocorre porque o sistema, por um tempo, pode ter dois registros para a mesma pessoa:
1. Um registro antigo com o **número de telefone**.
2. Um novo registro temporário sem número de telefone mas com o **LID**.
Até que o WhatsApp libere o número e o sistema consiga vincular os dois, eles podem aparecer como contatos separados, o que pode dividir o histórico de conversas.
**3. Como Unificar Contatos e Resolver Duplicidades**
Caso você identifique um contato identificado apenas pelo LID e saiba a qual cliente ele pertence, você pode realizar a unificação manual para consolidar o histórico de mensagens.
1. **Localize o Contato:** Acesse o menu **CRM -> Contatos** e utilize a busca para encontrar o registro que está sem o número de telefone (geralmente identificado pelo LID ou nome provisório).
2. **Inicie a Edição:** Clique sobre o contato desejado e selecione o **ícone de lápis (Editar)** no canto superior direito da ficha do contato.
3. **Insira o Telefone Real:** No campo **Telefone**, digite o número correto do cliente (com DDD). Ao tentar salvar, o sistema detectará que este número já pertence a outro cadastro.
4. **Acione a Revisão:** Uma mensagem de alerta aparecerá informando: *"O telefone informado já existe em outro contato"*. Clique no botão **Revisar** para abrir o assistente de mesclagem.
5. **Compare e Escolha os Dados:** No modal **Revisar dados do contato**, você verá duas colunas:
* **Contato Atual (LID):** Os dados do registro que você está editando agora.
* **Contato Existente:** Os dados que já estavam salvos na plataforma anteriormente.
* **Ação:** Selecione, campo por campo (Nome, Telefone, E-mail, Etiquetas), qual informação deve prevalecer no registro final unificado.
6. **Conclua a Mesclagem:** Após revisar e selecionar as informações mais atualizadas, clique em **Salvar e mesclar.**
{% hint style="success" %}
**O que acontece depois:**
O sistema irá deletar o registro duplicado e mover todo o histórico de conversas, cards, etiquetas e dados para um único perfil de contato, resolvendo a fragmentação da comunicação.
{% endhint %}
**4. O botão "Agrupar Contatos" não funcionou. Por quê?**
Para que o agrupamento funcione corretamente, a lógica do sistema precisa que certas condições sejam atendidas. A fusão só é possível se o sistema conseguir identificar claramente quem é o contato "original" e quem é o "duplicado".
**A lógica funciona assim:**
1. O sistema identifica um **Contato Original** (aquele que tem o número de telefone correto no campo `number`).
2. Ele procura por **Contatos Duplicados** (aqueles cujo campo `lid` é igual ao `number` do Contato Original).
3. Se encontrar essa correspondência, ele migra todas as informações (tickets, mensagens, oportunidades) do contato duplicado para o original.
4. Após a migração, o contato duplicado é removido.
Se a função não funcionou, provavelmente é porque o sistema não encontrou essa correspondência clara (ex: o LID no contato duplicado está diferente do número no contato original).
{% hint style="warning" %}
**API Oficial (WABA) e o LID**
O problema de duplicação de contatos ou tickets por conta da mudança de **LID** é uma característica de APIs não oficiais, como a **Z-API**.
Esta situação **não acontece** ao utilizar a **API Oficial do WhatsApp (WABA)**.
A API Oficial sempre utiliza o **número de telefone** como identificador único e permanente do contato, o que evita a criação de duplicatas.
{% endhint %}
**5. Perguntas Frequentes Adicionais**
* **Preciso ter o número do cliente salvo no meu celular para evitar o LID?** *Ajuda, mas não é uma garantia. A exibição do LID é uma regra de privacidade do WhatsApp e pode ocorrer mesmo com números salvos, dependendo das configurações do cliente.*
* **Um contato antigo de repente apareceu com um LID. O que aconteceu?** *Isso pode acontecer se o cliente iniciou uma nova conversa e o WhatsApp, por algum motivo, enviou o LID primeiro. Isso cria uma conversa temporária que depois precisa ser agrupada com o contato original.*
* **Estou usando uma API Não Oficial (Z-API). Isso influencia?** *Sim. As APIs não oficiais podem ter mais dificuldade em lidar com as novas regras do WhatsApp, o que pode aumentar a frequência de problemas com o LID.*
