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

<figure><img src="/files/yBWxiKu8BzRhDrnWTSFe" alt=""><figcaption></figcaption></figure>

**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 %}

<figure><img src="/files/4dt1ihO43GXhUWJFUTTT" alt=""><figcaption></figcaption></figure>

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helena.app/duvidas-e-novidades/faq/numero-privado-z-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.