Guide: Chat Typing & Recording Presence
This endpoint allows you to send real-time chat indicators to the recipient's WhatsApp chat header, such as "typing..." (composing), "recording audio..." (recording), or clearing indicators (paused).
This feature is ideal for Customer Service platforms (Shared Inbox) or AI Chatbots to deliver a natural, responsive conversational experience.
Request Parameters
| Field | Type | Required? | Example | Description |
|---|---|---|---|---|
phone | string | Yes | 628123456789 | Recipient WhatsApp phone number (international format without +). |
state | string | Yes | composing | Presence state to display. Allowed values: composing, typing, recording, paused, stop. |
duration | integer | Optional | 5 | Indicator duration in seconds (max 30 seconds). The server will automatically dispatch a paused state once this duration elapses. |
Available state Values
state Value | Visual Effect in Recipient WhatsApp App |
|---|---|
composing or typing | Displays header text "typing...". Recommended when an agent starts composing a reply or an AI model begins generating text. |
recording | Displays header text "recording audio...". Recommended when a voice note is being recorded or audio synthesized. |
paused or stop | Instantly clears the typing/recording indicator. |
We recommend providing the duration parameter (e.g. "duration": 5) when setting the composing state. Wagy server manages a background timer to automatically send a paused status if no subsequent message is dispatched, preventing stuck typing indicators.
To safeguard WhatsApp account reputation and comply with platform policies, this endpoint is rate-limited to a maximum of 5 requests per 10 seconds per device.
Set chat presence / typing indicator
POST/:device_id/presence
Set chat presence state (typing, recording audio, or paused) for a specific WhatsApp chat.
Request
Responses
- 200
- 400
- 401
- 429
- 500
- 503
Chat presence status sent successfully
Format JSON salah atau parameter wajib kosong
API Key tidak valid atau tidak sesuai
Rate limit exceeded (Max 5 requests per 10 seconds)
Gagal mengirim chat presence
Device tidak terhubung (offline)