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.

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.

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

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.

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.