Understanding `@lid` on WhatsApp
This is not a WhatsApp bug. It is WhatsApp’s own privacy feature.
In recent months, many ReplyAgent.com users have reported that when receiving messages on WhatsApp, some contacts appear with identifiers in the following format:
123456789012345@lid
This is not an error, not a failure, and not an integration issue.
It is an official WhatsApp privacy feature.
What is @lid?
@lid stands for Linked ID.
It is an internal WhatsApp identifier used when the platform decides to hide the user’s real phone number for privacy reasons.
Instead of exposing:
5511999999999@s.whatsapp.net
WhatsApp returns:
123456789012345@lid
Meta simply passes through exactly the identifier provided by WhatsApp.
Why does WhatsApp hide the phone number?
WhatsApp is migrating to a progressive privacy model, mainly to protect users in scenarios such as:
- Contacts that are not saved
- Conversations initiated by third parties
- Messages in groups or communities
- Users who never had a direct (1:1) conversation
- Business, automation, and multi-device environments
This behavior already exists in the official Meta WhatsApp Business API as well.
When does @lid appear in practice?
You will see @lid more frequently when:
- The customer contacts you for the first time
- The customer’s number is not saved
- The conversation happens inside a group
- WhatsApp determines that exposing the number is not necessary
This decision is made exclusively by WhatsApp’s servers.
Is it possible to convert @lid into a phone number?
No.
Important points:
@lidcannot be converted into a phone number- There is no API, official or unofficial, that performs this conversion
- ReplyAgent.com does not have access to the hidden number
- Meta does not provide this data when WhatsApp decides to mask the number
Is this a ReplyAgent bug?
No.
The architecture works as follows:
- WhatsApp sends the data
- Meta or WhatsApp QR Code passes through exactly that data
- ReplyAgent consumes what was received
In other words:
- If WhatsApp sends
@lid, Meta or WhatsApp QR Code delivers@lid - There is no data manipulation, loss of information, or technical failure
Can @lid change later?
In some cases, yes, but it is not guaranteed.
Examples where the real number may appear later:
- After continuous direct message exchanges
- When the user saves your number
- When WhatsApp decides to release the real identifier
This behavior cannot be controlled by the platform.
How your operation should handle this
Recommended best practices:
- Treat
@lidas a valid identifier - Do not rely exclusively on the phone number
- Use the JID as the primary user key
- Avoid business rules based only on phone numbers
- Update the user record if the real number appears in the future, without depending on it
Comparison with the official WhatsApp API
| Scenario | Official API (Meta) | WhatsApp QR Code |
|---|---|---|
| Phone number hidden | Yes | Yes |
Returns @lid |
Yes | Yes |
| Convert to phone number | No | No |
| Feature control |
Conclusion
@lid is not a bug, not an error, and not a ReplyAgent failure.
It is an official WhatsApp privacy feature, applied globally, including in Meta’s official API.