PATCH
/
wa
/
instances
/
{instance_id}
/
presence
Existência de Destinatário
curl --request PATCH \
  --url https://api.zapsterapi.com/v1/wa/instances/{instance_id}/presence \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "recipient": "group:123456789987654321",
  "status": "typing",
  "duration_strategy": "maximum_duration",
  "max_duration": 123
}'

​
Introdução

Este endpoint permite que você atualize o status de presença de um destinatário em uma instância específica do WhatsApp. Você pode definir se o destinatário verá uma indicação de que você está “digitando…” ou “gravando…”. Esta funcionalidade é útil para melhorar a experiência do usuário durante interações em tempo real, especialmente em aplicações que dependem de feedback instantâneo, como chats ao vivo ou integrações com IA.

​
Casos de Uso

  • Integração com OpenAI: Enquanto a IA está gerando uma resposta, você pode definir a presença como “digitando…” ou “gravando…” para simular a experiência de uma interação humana e manter o usuário informado sobre o processamento em andamento.

​
Estratégias de Uso

  • Definindo a Presença de Curta Duração: Utilize a estratégia maximum_duration para garantir que o status de “digitando…” ou “gravando…” seja exibido por um período específico de tempo. Esta estratégia é ideal para interações em que o tempo de resposta é previsível.
  • Até a Próxima Mensagem: Use a estratégia until_next_message para manter o status ativo até que a próxima mensagem seja enviada, proporcionando uma transição suave entre o momento em que o usuário percebe a presença e a entrega da mensagem final. Isso é útil em cenários onde o tempo de processamento pode variar, como durante a geração de respostas por IA.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
instance_id
string
required

ID da instância.

Body

application/json

Response

204

No Content