Atualizar status de presença da instância

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