Articles in this section

Understanding `@lid` on WhatsApp

Published:
Updated:

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:

  • @lid cannot 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:

  1. WhatsApp sends the data
  2. Meta or WhatsApp QR Code passes through exactly that data
  3. 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 @lid as 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 WhatsApp WhatsApp

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.

AB
Written by Ana Benini
Updated:
Access denied
Access denied