Solicitar presença de contato (online/offline)

dev

https://api-dev.messagefy.io

POST

/api/v1/message/sendcommand

Este endpoint permite se inscrever nos eventos de presença (online/offline) de um contato do WhatsApp. Após a inscrição bem-sucedida, eventos CONTACT_PRESENCE serão entregues via WebHook sempre que o contato mudar de status.

A inscrição é feita por contato e é válida enquanto o canal estiver 'ativo', isto é, após uma inatividade de 5~10 minutos, pode ser necessário fazer a inscrição novamente. Desconexões também encerram todas as inscrições.

Requisição

Authorization

Adicionar parâmetro em header

api-key

Exemplo:

api-key: ********************

Parâmetros Header

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200Sucesso

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-dev.messagefy.io/api/v1/message/sendcommand' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "channelId": "{{whatsapp-channelId}}",
  "content": {
    "type": "PRESENCE_SUBSCRIPTION",
    "commandType": "PRESENCE_SUBSCRIPTION",
    "id": "{{JID ou LID do contato}}"
  }
}'

Response Example

{
    "packageId": "string"
}

Modificado em 2026-02-19 20:22:15