Presence API

The Presence API lets you check if a WhatsApp user is currently online, offline, or typing, along with optional lastSeen data.

This is useful when you want to:

Show live presence status in your app or CRM.

Trigger workflows (e.g., notify your agent when the user comes online).

Log user activity for analytics.

🔄 Example Presence Response

{
  "id": "1234567890@c.us",
  "presences": [
    {
      "participant": "1234567890@c.us",
      "lastSeen": null,
      "lastKnownPresence": "offline"
    }
  ]
}

📘 Field Breakdown

Field	Type	Example Value	Description
id	string	`"1234567890@c.us"`	WhatsApp ID of the chat/contact.
presences	array	`[ {...} ]`	List of participants with presence data.
participant	string	`"1234567890@c.us"`	WhatsApp ID of the participant.
lastSeen	number	null	`1722170400` or `null`
lastKnownPresence	string	`"online"`, `"offline"`	Current or last known presence state.

🌐 Example with `lastSeen` Timestamp

{
  "id": "9876543210@c.us",
  "presences": [
    {
      "participant": "9876543210@c.us",
      "lastSeen": 1722170400,
      "lastKnownPresence": "online"
    }
  ]
}

🕒 lastSeen is returned as a Unix epoch timestamp. Convert it to your preferred date/time format.

⚠️ Notes

Presence updates depend on WhatsApp privacy settings — if a user hides their last seen, it may return null.

Not all engines return real-time presence; some may only report "offline" when hidden.

Use presence for status indicators, not for critical workflows (since data may be limited by privacy).

👉 Next Step: You can subscribe to Presence Webhooks to receive real-time updates whenever a contact’s status changes.

🔄 Example Presence Response#

📘 Field Breakdown#

🌐 Example with lastSeen Timestamp#

⚠️ Notes#

🔄 Example Presence Response

📘 Field Breakdown

🌐 Example with `lastSeen` Timestamp

⚠️ Notes