Ações na mensagem e Buscar
Solicitar histórico sob demanda de um chat
https://api.nodinfra.com.br/message/history-syncSolicita 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 âncoraexact: tenta recarregar a mensagem exata informada emmessageid
Regras:
- envie
number modeé opcional; quando omitido, assumehistory- 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 ecountnã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,messageiddefine 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
Xvia histórico, informe comomessageida mensagem logo depois deXe usecount=1 - se
messageidnão for informado emmode=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 emmessageid mode=exactestá 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
historye também ficam disponíveis em/message/find
Corpo da requisição
modestringopcionalDefine 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
messageidstringopcionalEm `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órioJID 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
countintegeropcionalQuantidade desejada de mensagens no sync em `mode=history`. Em `mode=exact`, este campo é ignorado.
exemplo: 20
Exemplo
{
"number": "5511999999999@s.whatsapp.net",
"mode": "exact",
"messageid": "3EB01234567890ABCDEF"
}