Skip to main content
POST
Send WhatsApp chat presence

Authorizations

Authorization
string
header
required

API Key no header Authorization. Exemplo: Authorization: Bearer sk_live_xxxxx

Body

application/json
presence
enum<string>
required

composing = typing; recording = recording audio (QR only). Meta and Gupshup accept composing only.

Available options:
composing,
recording
from
string
required

WhatsApp instance ID, E.164 phone number, or instance name. Required with presence unless instanceId is sent. Pools are not supported.

to
string

E.164 phone number or JID (@s.whatsapp.net / @g.us). Required for QR connections; ignored by official connections.

delayMs
integer

Reservado para uso futuro; ignorado na v1

messageId
string

External ID of the incoming message. Required for official Meta and Gupshup; use messages[].id from the webhook or externalMessageId from GET /v1/whatsapp/messages/inbound. Do not use the list internal id.

Required string length: 1 - 256
instanceId
string

Legacy alias for the instance ID. E.164 phone number and instance name are also accepted; from takes precedence when both are sent.

Response

Presença definida com success.

success
boolean
Example:

true

data
object