NODInfra

Enviar Mensagem

Enviar atualização de presença

POSThttps://api.nodinfra.com.br/message/presence
URL completa: https://api.nodinfra.com.br/message/presence

Envia uma atualização de presença para um contato ou grupo de forma assíncrona.

🔄 Comportamento Assíncrono:

  • Execução independente: A presença é gerenciada em background, não bloqueia o retorno da API
  • Limite máximo: 5 minutos de duração (300 segundos)
  • Tick de atualização: Reenvia a presença a cada 10 segundos
  • Cancelamento automático: Presença é cancelada automaticamente ao enviar uma mensagem para o mesmo chat

📱 Tipos de presença suportados:

  • composing: Indica que você está digitando uma mensagem
  • recording: Indica que você está gravando um áudio
  • paused: Remove/cancela a indicação de presença atual

⏱️ Controle de duração:

  • Sem delay: Usa limite padrão de 5 minutos
  • Com delay: Usa o valor especificado (máximo 5 minutos)
  • Cancelamento: Envio de mensagem cancela presença automaticamente

📋 Exemplos de uso:

Digitar por 30 segundos:

{
  "number": "5511999999999",
  "presence": "composing",
  "delay": 30000
}

Gravar áudio por 1 minuto:

{
  "number": "5511999999999",
  "presence": "recording",
  "delay": 60000
}

Cancelar presença atual:

{
  "number": "5511999999999",
  "presence": "paused"
}

Usar limite máximo (5 minutos):

{
  "number": "5511999999999",
  "presence": "composing"
}

Corpo da requisição

numberstringobrigatório

Número do destinatário no formato internacional (ex: 5511999999999)

exemplo: 5511999999999

presencestringobrigatório

Tipo de presença a ser enviada

valores:composingrecordingpaused

exemplo: composing

delayintegeropcional

Duração em milissegundos que a presença ficará ativa (máximo 5 minutos = 300000ms). Se não informado ou valor maior que 5 minutos, usa o limite padrão de 5 minutos. A presença é reenviada a cada 10 segundos durante este período.

exemplo: 30000

Respostas

200Presença atualizada com sucesso
400Requisição inválida
401Token inválido ou expirado
500Erro interno do servidor

Testar endpoint

POSThttps://api.nodinfra.com.br/message/presence
cURL
curl -X POST 'https://api.nodinfra.com.br/message/presence' \
  -H 'token: SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{}'