Instancia
Atualizar status de presença da instância
POST
/instance/presenceAutenticação: envie a chave da conexão no header token ou em Authorization: Bearer.
Atualiza o status de presença global da conta do WhatsApp atualmente conectada. Este endpoint permite:
- Definir se a conta aparece como disponível ("online") ou indisponível
- Controlar o status de presença para todos os contatos
- Salvar o estado atual da presença para a conta conectada
Tipos de presença suportados:
- available: Marca a conta como disponível/online
- unavailable: Marca a conta como indisponível/offline
Atenção:
- O status de presença pode ser temporariamente alterado para "available" (online) em algumas situações internas da API, e com isso o visto por último também pode ser atualizado.
- Caso isso for um problema, considere alterar suas configurações de privacidade no WhatsApp para não mostrar o visto por último e/ou quem pode ver seu status "online".
⚠️ Importante - Limitação do Presence "unavailable":
- Quando a API é o único dispositivo ativo: Confirmações de entrega/leitura (ticks cinzas/azuis) não são enviadas nem recebidas
- Impacto: Eventos
message_updatecom status de entrega podem não ser recebidos - Solução: Se precisar das confirmações, mantenha WhatsApp Web ou aplicativo móvel ativo ou use presence "available"
Exemplo de requisição:
{
"presence": "available"
}Exemplo de resposta:
{
"response": "Presence updated successfully"
}Erros comuns:
- 401: Token inválido ou expirado
- 400: Valor de presença inválido
- 500: Erro ao atualizar presença
Corpo da requisição (JSON)
| Campo | Tipo | Descrição |
|---|---|---|
| presence* | string | Status de presença da conta atualmente conectada Exemplo: available |
* obrigatório
Respostas
- 200Presença atualizada com sucesso
- 400Requisição inválida
- 401Token inválido ou expirado
- 500Erro interno do servidor
Experimente
Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.