Enviar Mensagem
Enviar atualização de presença
POST
https://api.nodinfra.com.br/message/presenceURL 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órioNúmero do destinatário no formato internacional (ex: 5511999999999)
exemplo: 5511999999999
presencestringobrigatórioTipo de presença a ser enviada
valores:composingrecordingpaused
exemplo: composing
delayintegeropcionalDuraçã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