Presença no chat

Envia indicadores de digitação ou gravação para um chat. Útil para simular comportamento humano antes de enviar uma mensagem.

Endpoint

POST /chat/presence

Parâmetros

Nome	Tipo	Obrigatório	Descrição
to	string	Sim	JID do chat
state	string	Sim	composing, paused, available ou unavailable

Request

cURL

curl -X POST https://endpoint.wi.api.br/chat/presence \
  -H "x-api-key: $WIAPI_KEY" \
  -H "x-instance: session_01" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999999999@s.whatsapp.net",
    "state": "composing"
  }'

JavaScript

const response = await fetch("https://endpoint.wi.api.br/chat/presence", {
  method: "POST",
  headers: {
    "x-api-key": process.env.WIAPI_KEY,
    "x-instance": "session_01",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "5511999999999@s.whatsapp.net",
    state: "composing",
  }),
});

Python

import requests

response = requests.post(
    "https://endpoint.wi.api.br/chat/presence",
    headers={
        "x-api-key": WIAPI_KEY,
        "x-instance": "session_01",
    },
    json={
        "to": "5511999999999@s.whatsapp.net",
        "state": "composing",
    },
)

Response

{ "success": true }