Ações na mensagem e Buscar
Solicitar histórico sob demanda de um chat
/message/history-syncAutenticação: envie a chave da conexão no header token ou em Authorization: Bearer.
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 â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=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
historye também ficam disponíveis em/message/find
Corpo da requisição (JSON)
| Campo | Tipo | Descrição |
|---|---|---|
| mode | string | Define o comportamento da operação.
Exemplo: history |
| messageid | string | Em Exemplo: 3EB01234567890ABCDEF |
| number* | string | 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: [email protected] |
| count | integer | Quantidade desejada de mensagens no sync em Exemplo: 20 |
* obrigatório
Exemplos de corpo
Recuperar a mensagem exata informada
{
"number": "[email protected]",
"mode": "exact",
"messageid": "3EB01234567890ABCDEF"
}Buscar histórico anterior a uma mensagem de referência
{
"number": "[email protected]",
"mode": "history",
"messageid": "3EB01234567890ABCDEF",
"count": 20
}Recuperar apenas a mensagem imediatamente anterior à referência
{
"number": "[email protected]",
"mode": "history",
"messageid": "3EB0MENSAGEM_LOGO_APOS_X",
"count": 1
}Reutilizar âncora local já persistida
{
"number": "[email protected]",
"mode": "history",
"count": 50
}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
Experimente
Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.