Pular para o conteúdo principal

​
Introdução

O @lid (Linked ID) é um identificador único e privado criado pelo WhatsApp para representar contatos sem expor diretamente o número de telefone. Essa mudança faz parte das atualizações de privacidade do WhatsApp, permitindo que o usuário oculte seu número em determinados contextos. Em alguns casos, o WhatsApp está enviando o @lid como identificação primária do usuário, mesmo que ele não tenha ativado nenhuma opção para esconder o número.

​
Diferença entre @lid e phone

O WhatsApp pode retornar os identificadores de contato de diferentes formas, dependendo do tipo de conversa, grupo ou configuração de privacidade:
  • phone: Pode conter o número real ("554499999999") ou o próprio @lid ("999999999999999@lid").
  • chatLid: É o identificador único mais estável.

​
Exemplo de Webhook

Nos webhooks da Z-API, o WhatsApp pode retornar o identificador do contato de diferentes formas, dependendo do tipo de interação e das configurações de privacidade do usuário.

​
Exemplo – Retorno completo com número e @lid:

{
  "chatLid": "999999999999999@lid",
  "phone": "554499999999"
}

​
Exemplo – Retorno apenas com o @lid:

{
  "chatLid": "65998849469@lid",
  "phone": "65998849469@lid"
}

​
Envio de mensagens usando o @lid

É possível enviar mensagens diretamente para um @lid, substituindo o número de telefone no corpo da requisição: 
{
  "phone": "999999999999999@lid",
  "message": "Olá! Essa mensagem foi enviada usando o identificador @lid."
}
O envio funciona normalmente, pois o @lid já é suportado pela API da Z-API na maioria dos endpoints.

​
Boas práticas de implementação

  • Priorize o uso de @lid para identificar contatos — esse atributo tende a ser o mais estável.
  • Evite depender apenas de phone, pois ele pode conter o número ou o próprio @lid.
  • Armazene e relacione o @lid em sua base de dados para manter consistência.

​
Conversão de @lid para número

Não é possível converter um @lid em número de telefone (phone). Essa limitação existe por motivos de privacidade definidos pelo WhatsApp. Permitir essa conversão invalidaria o propósito do recurso de ocultação de número. O mapeamento direto entre @lid e phone não é disponibilizado pelo WhatsApp nem pela Z-API.

​
Conversão de número (phone) para @lid

Por outro lado, é possível obter o @lid correspondente a um número de telefone utilizando o método “Número com Whatsapp ?”. Esse endpoint permite verificar se um número possui conta no WhatsApp e, quando aplicável, retorna também o identificador @lid associado a esse número.

​
Importante

  • Essa mudança é nativa do WhatsApp, e a Z-API apenas repassa as informações conforme recebidas.
  • O comportamento de retorno (@lid ou phone) pode variar.
  • O atributo chatLid já está implementado nos webhooks da Z-API e pode ser usado tanto para identificar quanto para enviar mensagens normalmente.
  • O @lid é uma medida que está sendo implementada pelo próprio WhatsApp; as mudanças estão sendo aplicadas gradualmente e ele ainda não está completamente implementado, por isso o comportamento pode ser inconsistente.