WACrew

Guide

WhatsApp JID: the address of every chat

A JID is WhatsApp's internal identifier for every account, group or channel. The formats you will see in an integration and the mistake that makes messages never arrive.

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

A JID (Jabber ID) is the internal address WhatsApp uses for every destination: a person, a group, a channel. The name comes from XMPP, the protocol WhatsApp was originally built on.

If you integrate through WhatsApp Web (Baileys, whatsmeow and the unofficial APIs built on them), you handle JIDs all the time. Meta's official API hides this detail and works with phone numbers.

The common formats

formatwhat it is
14155550123@s.whatsapp.neta person's account, by number with country code
120363...@g.usa group
...@lidan account identified by its LID, without exposing the number
status@broadcaststatus updates
...@newslettera channel

Where you meet it

Every message event carries the chat JID and, in groups, the sender's JID. To reply, you send to the same JID. In WACrew each chat gets a stable slug derived from its JID (renaming the group does not change it), and a direct chat by number is dm-<number>.

Common mistake

Building the JID from the number as saved in the contact list. In some countries, Brazil being the classic case, many older accounts are registered without a digit that the current numbering plan adds. Sending to the "obvious" JID can show one tick and never deliver. Ask WhatsApp which JID is registered (onWhatsApp in Baileys) before the first message; WACrew does this for you.

Questions

Is a JID the same as a phone number? Almost: a person's JID carries the number, but with a suffix and in the form registered on the account, which may differ from what you typed.

Why does the same person show up with two JIDs? Because WhatsApp also identifies accounts by their LID. A good integration merges both.

In Portuguese: JID.