Pular para o conteúdo principal
POST
Enviar presença no chat WhatsApp

Autorizações

Authorization
string
header
obrigatório

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

Corpo

application/json
presence
enum<string>
obrigatório

composing = digitando; recording = gravando áudio (somente QR). Meta e Gupshup aceitam apenas composing.

Opções disponíveis:
composing,
recording
from
string
obrigatório

ID, telefone E.164 ou nome da instância WhatsApp. Obrigatório junto com presence, salvo quando instanceId for enviado. Pools não são aceitos.

to
string

Telefone E.164 ou JID (@s.whatsapp.net / @g.us). Obrigatório em conexões QR; ignorado nas oficiais.

delayMs
integer

Reservado para uso futuro; ignorado na v1

messageId
string

ID externo da mensagem recebida. Obrigatório para Meta e Gupshup oficiais; use messages[].id do webhook ou externalMessageId de GET /v1/whatsapp/messages/inbound. Não use o id interno da listagem.

Required string length: 1 - 256
instanceId
string

Alias legado do ID de instância. Aceita também telefone E.164 ou nome; from tem prioridade se ambos forem enviados.

Resposta

Presença definida com sucesso.

success
boolean
Exemplo:

true

data
object