WACrew

Guide

WhatsApp LID: the identifier that hides the phone number

A LID is a WhatsApp identifier that does not reveal the person's phone number. Why it appears in groups and direct chats, and how to avoid duplicate contacts in your integration.

Updated 1 min read
On this page
  1. Where you meet it
  2. Common mistake
  3. Questions

A LID is an identifier WhatsApp assigns to each account so the person can be identified without exposing their phone number. In the protocol it shows up as a JID ending in @lid.

WhatsApp started using LIDs to protect the numbers of people in large groups and communities, and they keep spreading across the platform.

Where you meet it

In a WhatsApp Web integration the same person may arrive as 14155550123@s.whatsapp.net one time and as 123456789@lid the next. In groups it is common for the sender to come with the LID only. Libraries such as Baileys keep a map between LID and phone number whenever WhatsApp provides both.

In WACrew, a person's direct chat by phone and by LID is merged on read, so the conversation does not appear split in two. The response says when that happened.

Common mistake

Treating the LID as a phone number and trying to call it or save it as a contact. It is not a phone number, just an internal code. Another one is creating a new CRM contact every time a LID appears, which duplicates people and history.

Questions

Can I get the phone number from a LID? Only when WhatsApp itself provides the pair (for example, the person already talked to you by number). There is no public conversion.

Does replying to a LID work? Yes, sending to the @lid JID is delivered normally.

Does the official API use LIDs? The Cloud API works with the number of whoever messages the business; LIDs are a concern for WhatsApp Web protocol integrations.

In Portuguese: LID.