O que é LID no WhatsApp
LID (linked identity) é um identificador do WhatsApp, como 11122233344455@lid, que representa um contato sem revelar o número de telefone. É estável para o contato, mas não tem relação com o telefone.
Atualizado em
LID (linked identity) é um identificador que o WhatsApp usa para representar um contato sem revelar o número de telefone dele. Tem a forma de um JID terminado em @lid, como 11122233344455@lid. O WhatsApp identifica cada vez mais conversas assim, para proteger a privacidade dos usuários.
O que muda para quem integra
Antes, toda mensagem recebida vinha de um endereço com o telefone dentro ([email protected]), e bastava ler o número. Com o LID, uma mensagem pode chegar de 11122233344455@lid, e esse número não é um telefone: não há relação entre os dígitos do LID e os do celular do contato. Tentar adivinhar o telefone a partir dele não funciona.
O LID é estável para o contato: a mesma pessoa continua chegando com o mesmo LID. Então ele serve como identidade, só não serve para ligar o contato ao seu cadastro por telefone.
Eventos com phone: null
Na apiwpp, todo evento de conversa individual traz jid (sempre presente) e phone (o telefone em E.164, ou null). A apiwpp tenta descobrir o telefone de um LID pelo que o próprio número já sabe, como a sincronização de contatos e os mapeamentos que o WhatsApp informa. Quando não consegue, o evento chega mesmo assim, com phone: null; ele nunca é descartado por isso:
{
"type": "message.incoming",
"data": {
"from": "11122233344455@lid",
"jid": "11122233344455@lid",
"phone": null,
"body": "Posso levar meu filho também?"
}
}
contact.resolved: quando o telefone aparece
Se depois a apiwpp descobre o telefone de um LID que já chegou ao projeto com phone: null, o seu webhook recebe o evento contact.resolved, uma vez por LID:
{
"type": "contact.resolved",
"data": {
"lid": "11122233344455@lid",
"jid": "[email protected]",
"phone": "+5511988887777",
"firstSeenAt": "2026-09-25T12:00:00.000Z",
"messageCount": 2,
"source": "lid-mapping"
}
}
firstSeenAt e messageCount dizem desde quando e quantas mensagens chegaram sem telefone, e source diz como o telefone foi descoberto (lid-mapping, contacts ou sweep, uma verificação periódica).
Alguns LIDs nunca são resolvidos, porque o WhatsApp não revela o telefone de todos os contatos. Eles continuam chegando com phone: null, sempre com o mesmo jid.
Como tratar o LID no seu sistema
- Guarde o evento pelo
jid. Trate o LID como a identidade provisória do contato: uma conversa, um lead ou um cliente "sem telefone". - Não descarte mensagens sem telefone. Elas são de pessoas reais e podem ser respondidas: o campo
todo envio aceita o JID@lid, usado como veio. - Ao receber
contact.resolved, reatribua todos os eventos anteriores cujojidseja igual adata.lidao contato dedata.phone, juntando a conversa provisória com a do telefone se ela já existir. - Compare os dois formatos de celular ao procurar o contato pelo telefone, porque contas antigas podem estar registradas sem o nono dígito.
Os eventos e o envelope completos estão em webhooks assinados, e o guia de LID está na documentação da API.
Perguntas frequentes
Dá para descobrir o telefone a partir do LID?
Não. Os dígitos do LID não têm relação com o telefone. Só o WhatsApp sabe a correspondência, e a apiwpp avisa pelo evento contact.resolved quando o número conectado fica sabendo.
Posso responder um contato que chegou como LID?
Sim. Envie a resposta com o JID completo no campo to, por exemplo 11122233344455@lid. A apiwpp usa o JID como veio.
O evento contact.resolved chega mais de uma vez?
A apiwpp o envia uma vez por LID. Como a entrega de webhooks é at-least-once, trate o evento de forma idempotente: reatribuir as mesmas mensagens duas vezes não deve mudar o resultado.
Outros termos
Todos: Glossário →JID (Jabber ID) é o endereço interno que o WhatsApp usa para cada conversa: um contato é algo como [email protected], um grupo termina em @g.us e um contato identificado sem telefone termina em @lid.
O nono dígito é o 9 que os celulares brasileiros ganharam na frente do número. Contas de WhatsApp antigas podem continuar registradas sem ele, e uma mensagem enviada ao endereço com o 9 não chega até elas.
Webhook é uma chamada HTTP que um serviço faz para um endereço do seu sistema quando um evento acontece, como uma mensagem recebida. Em vez de perguntar de tempos em tempos se há novidades, o seu sistema é avisado na hora.