NODInfra

Ações na mensagem e Buscar

Solicitar histórico sob demanda de um chat

POSThttps://api.nodinfra.com.br/message/history-sync
URL completa: https://api.nodinfra.com.br/message/history-sync

Solicita ao WhatsApp um sync sob demanda de mensagens antigas de um chat ou tenta recuperar uma mensagem exata já conhecida localmente.

Modos suportados:

  • history (padrão): busca histórico para trás a partir de uma mensagem âncora
  • exact: tenta recarregar a mensagem exata informada em messageid

Regras:

  • envie number
  • mode é opcional; quando omitido, assume history
  • em mode=history, count é opcional e limitado a 100
  • em mode=history, messageid é opcional; quando informado, a API usa essa mensagem como referência para buscar mensagens mais antigas do chat
  • em mode=exact, messageid é obrigatório e count não é necessário

Observação:

  • Importante: a recuperação pode só acontecer depois de abrir o WhatsApp no celular ou deixá-lo ativo em segundo plano
  • em mode=history, messageid define a mensagem de referência para carregar histórico anterior
  • em mode=history, esse campo não serve para buscar essa mensagem específica
  • em mode=history, o histórico é buscado para trás a partir da mensagem de referência informada
  • se você quiser recuperar apenas uma mensagem específica X via histórico, informe como messageid a mensagem logo depois de X e use count=1
  • se messageid não for informado em mode=history, a API usa a mensagem mais antiga conhecida localmente desse chat como referência para buscar histórico anterior
  • em mode=exact, a API tenta um rerequest da mensagem exata informada em messageid
  • mode=exact está em teste e funciona melhor quando a mensagem já existe no histórico local da instância
  • as mensagens retornam depois via webhook/SSE em eventos do tipo history e também ficam disponíveis em /message/find

Corpo da requisição

modestringopcional

Define o comportamento da operação. - `history`: busca mensagens mais antigas a partir de uma âncora - `exact`: tenta recuperar a mensagem exata informada em `messageid`

valores:historyexact

exemplo: history

messageidstringopcional

Em `mode=history`, ID da mensagem de referência usada para buscar mensagens mais antigas do chat. Em `mode=exact`, ID exato da mensagem que deve ser recarregada.

exemplo: 3EB01234567890ABCDEF

numberstringobrigatório

JID completo do chat. Mantido obrigatório em todos os modos para simplificar o contrato público e restringir a busca ao chat esperado.

exemplo: 5511999999999@s.whatsapp.net

countintegeropcional

Quantidade desejada de mensagens no sync em `mode=history`. Em `mode=exact`, este campo é ignorado.

exemplo: 20

Exemplo

Recuperar a mensagem exata informada
{
  "number": "5511999999999@s.whatsapp.net",
  "mode": "exact",
  "messageid": "3EB01234567890ABCDEF"
}

Respostas

200Solicitação enviada com sucesso
400Payload inválido, modo inválido ou âncora insuficiente
404Mensagem exata não encontrada no histórico local
500Erro interno ao solicitar o history sync ou o rerequest exato

Testar endpoint

POSThttps://api.nodinfra.com.br/message/history-sync
cURL
curl -X POST 'https://api.nodinfra.com.br/message/history-sync' \
  -H 'token: SEU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "number": "5511999999999@s.whatsapp.net",
  "mode": "exact",
  "messageid": "3EB01234567890ABCDEF"
}'