NODAPI

Instancia

Atualizar status de presença da instância

POST/instance/presence

Autenticaçã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:

  1. Definir se a conta aparece como disponível ("online") ou indisponível
  2. Controlar o status de presença para todos os contatos
  3. 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_update com 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)

CampoTipoDescriçã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.

Cole a chave gerada no painel.