{
"success": true,
"message": "Message reload request sent. The message will be received if available.",
"details": {
"id": "5511988887777:3EB01234567890ABCDEF",
"messageid": "3EB01234567890ABCDEF",
"chat_jid": "5511999999999@s.whatsapp.net",
"sender_jid": "5511999999999@s.whatsapp.net",
"fromMe": false,
"candidate_count": 2,
"candidates": [
{
"chat_jid": "5511999999999@s.whatsapp.net",
"sender_jid": "5511999999999@s.whatsapp.net",
"strategy": "raw"
},
{
"chat_jid": "123456789012345@lid",
"sender_jid": "123456789012345@lid",
"strategy": "alt_lid"
}
]
}
}{
"error": "id or messageid is required"
}{
"error": "message not found in local history; use reload history to fetch older messages first"
}{
"error": "Failed to request message: no active session"
}Recuperar mensagem que não abriu
Pede ao celular conectado uma nova cópia de uma mensagem que chegou sem abrir.
Quando uma mensagem chega e não pode ser aberta, a API já pede uma cópia ao celular automaticamente. Se a cópia não vier, a mensagem fica salva com messageType: "error" no /message/find, sem o conteúdo original. Vale também para Status de contatos (chatid: status@broadcast). Use esta rota para tentar de novo, por exemplo depois de abrir o WhatsApp no celular.
Regras:
- envie o
idque o/message/finddevolve ou omessageid - a mensagem precisa estar salva na instância; se não estiver, a resposta é
404 - ligações (
messageType: call) não podem ser pedidas
Resultado:
- a resposta só confirma que o pedido foi enviado ao celular
- se o celular tiver a mensagem, ela chega depois como uma mensagem nova: webhook/SSE
messages(status_postspara Status), e a linha do/message/findpassa a ter o conteúdo, com o mesmomessageid - se a cópia não chegar, nada muda e não há aviso de falha
- Importante: a recuperação pode só acontecer depois de abrir o WhatsApp no celular ou deixá-lo ativo em segundo plano
Só mensagens que não abriram são recuperadas. Para uma mensagem já salva normalmente, a cópia que o celular reenvia é descartada como repetida, sem webhook nem alteração. Logo depois de conectar, enquanto o histórico inicial ainda está sendo processado, essa cópia pode chegar de novo como mensagem nova. Para buscar mensagens antigas que ainda não estão salvas, use POST /message/history-sync.
{
"success": true,
"message": "Message reload request sent. The message will be received if available.",
"details": {
"id": "5511988887777:3EB01234567890ABCDEF",
"messageid": "3EB01234567890ABCDEF",
"chat_jid": "5511999999999@s.whatsapp.net",
"sender_jid": "5511999999999@s.whatsapp.net",
"fromMe": false,
"candidate_count": 2,
"candidates": [
{
"chat_jid": "5511999999999@s.whatsapp.net",
"sender_jid": "5511999999999@s.whatsapp.net",
"strategy": "raw"
},
{
"chat_jid": "123456789012345@lid",
"sender_jid": "123456789012345@lid",
"strategy": "alt_lid"
}
]
}
}{
"error": "id or messageid is required"
}{
"error": "message not found in local history; use reload history to fetch older messages first"
}{
"error": "Failed to request message: no active session"
}