Get General Presence
Get the current presence status (online/offline) for the authenticated session.
Authentication Required
Login to swap the placeholders with your real Instance ID and Access Token.
Log InNo query parameters required
This endpoint doesn't expect data in the URL.
Mirror, Mirror: Checking Your Own Reflection
The /v2/presence (GET) endpoint allows you to programmatically verify how your WhatsApp session appears to the outside world. While you can set your status using the POST method, this GET method is crucial for auditing and synchronization.
🏗️ State Verification
Why check your own status?
1. Audit Loops
If you manage a fleet of 50 support bots, you need a dashboard to see which ones are currently "Online" and accepting chats.
- Workflow: Central Monitor calls
/v2/presenceon each instance every minute. - Alert: If a bot is supposed to be Online but returns
offline, tips: [ { "type": "positive", "title": "User Experience", "content": "Show "typing..." status to make the bot feel more human-like." }, { "type": "info", "title": "Status", "content": "Online status updates can trigger automation flows." } ], recommendations: [ "Do not keep "typing" status active for too long without sending a message.", "Respect user privacy regarding online presence.", "Use presence webhooks to trigger immediate responses." ],
trigger a slack alert to the engineering team. The session might have crashed or been manually toggled by a human using the mobile app.
2. UI Synchronization
If you are building a custom CRM with a "Go Online" toggle button:
- Problem: You don't know the initial state of the button when the page loads.
- Solution: Call this endpoint on page load. If it returns
available, render the toggle as green (Active). Ifunavailable, render it as grey (Inactive).
3. Debugging "Ghost" Issues
Sometimes users complain: "I see you online but you aren't replying!"
- Debugger: Call this endpoint. content:
- Result:
offline. - Conclusion: The user is seeing a cached state on their device, or you have privacy settings hiding your real status. The API confirms you are effectively invisible.
- Result:
🔄 The Feedback Loop
The "Auto-Correction" Pattern
WhatsApp sessions can sometimes drift. For example, if the physical phone loses internet connection for 10 minutes, WhatsApp might automatically mark the session as unavailable.
- Script:
- Cron job runs every 5 minutes.
- Step A: Call
GET /v2/presence. - Step B: If result is
offlineAND expected state isonline-> CallPOST /v2/presenceto force it back. - Result: Self-healing availability.
⚠️ Limitations
- Internal State Only: This endpoint only returns what the WhatsApp Web protocol thinks your status is. It does not strictly guarantee that your phone is reachable (e.g., if the battery died 30 seconds ago, the server might still think you are online for another minute).
- Privacy Masks: If your privacy settings are set to "Nobody", this endpoint might still return
available(because you know you are online), but external users will see nothing. Usage of this data must be combined with an understanding of your privacy configuration.
Request Parameters
Configure the parameters required to interact with this endpoint. All query and body arguments are listed below with their details.
Query Parameters & Request Body
Supported in URL Query String or JSON Bodystring | Your unique WhatsApp Instance ID Example: | ||
string | Your API Access Token Example: |
Build with AI using Wawp MCP
MCP READYConnect Wawp API directly to Cursor, Windsurf, or Claude Desktop. Let AI write, test, and execute your WhatsApp integration code automatically!
Request Samples
Use these ready-to-go code snippets to integrate our API into your project quickly and efficiently. Choose your preferred language and library.
Expected Responses
Explore all possible responses and outcomes from the server. We have documented each status code with data examples to make success and error handling easier.
Example
{
"presence": "online"
}Command Palette
Search for a command to run...