NODInfra

Ações na mensagem e Buscar

Fixa ou desafixa uma mensagem

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

Fixa ou desafixa uma mensagem específica usando a funcionalidade nativa do WhatsApp.

O endpoint realiza:

  • Busca a mensagem original no banco de dados usando o ID fornecido
  • Envia a ação de fixar ou desafixar a mensagem no WhatsApp
  • Funciona em conversas individuais e grupos
  • Gera um novo ID para o evento de pin/unpin
  • Retorna objeto de mensagem completo seguindo o padrão da API
  • Dispara eventos SSE/Webhook automaticamente

Importante:

  • O ID pode ser fornecido no formato completo (owner:messageid) ou apenas messageid
  • Em conversas 1:1, a ação é suportada normalmente
  • Em grupos, a permissão depende da configuração do WhatsApp do grupo (apenas admins ou qualquer membro)
  • O backend não valida localmente se a instância é admin do grupo; a decisão final é do WhatsApp
  • Newsletters/canais não são suportados neste endpoint
  • Se pin não for enviado, o valor padrão é true
  • Ao fixar mensagem, duration aceita dias (1, 7 ou 30)
  • Se duration não for enviado ou vier com qualquer outro valor, o backend usa 30 dias
  • Ao desafixar (pin: false), duration é ignorado

Corpo da requisição

idstringobrigatório

ID único da mensagem alvo (formato `owner:messageid` ou apenas `messageid`)

exemplo: 3A12345678901234567890123456789012

pinbooleanopcional

Define se a mensagem deve ser fixada (`true`) ou desafixada (`false`)

exemplo: true

durationintegeropcional

Duração do pin em dias. Valores aceitos: `1`, `7` ou `30`. Qualquer outro valor cai para `30`.

exemplo: 7

Exemplo

Fixar mensagem
{
  "id": "3A12345678901234567890123456789012",
  "pin": true,
  "duration": 7
}

Respostas

200Ação de fixar/desafixar mensagem enviada com sucesso
400Dados inválidos na requisição ou operação não suportada
401Sem sessão ativa ou token inválido
404Mensagem não encontrada
500Erro interno do servidor ou erro retornado pelo WhatsApp

Testar endpoint

POSThttps://api.nodinfra.com.br/message/pin
cURL
curl -X POST 'https://api.nodinfra.com.br/message/pin' \
  -H 'token: SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "3A12345678901234567890123456789012",
  "pin": true,
  "duration": 7
}'