curl --request POST \
--url https://api.wppfy.com/message/reload \
--header 'Content-Type: application/json' \
--header 'token: <api-key>' \
--data '
{
"id": "5511988887777:3EB01234567890ABCDEF"
}
'{
"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": "Error al solicitar el mensaje: no hay sesión activa"
}Recuperar mensaje que no se abrió
Solicita al teléfono conectado una nueva copia de un mensaje que llegó sin poder abrirse.
Cuando un mensaje llega y no puede abrirse, la API ya solicita automáticamente una copia al teléfono. Si la copia no llega, el mensaje queda guardado con messageType: "error" en /message/find, sin el contenido original. También aplica a los Status de contactos (chatid: status@broadcast). Use esta ruta para intentarlo de nuevo, por ejemplo después de abrir WhatsApp en el teléfono.
Reglas:
- envíe el
idque devuelve/message/findo elmessageid - el mensaje debe estar guardado en la instancia; si no lo está, la respuesta es
404 - las llamadas (
messageType: call) no pueden solicitarse
Resultado:
- la respuesta solo confirma que la solicitud fue enviada al teléfono
- si el teléfono tiene el mensaje, este llega después como un mensaje nuevo: webhook/SSE
messages(status_postspara Status), y la fila de/message/findpasa a tener el contenido, con el mismomessageid - si la copia no llega, nada cambia y no hay aviso de falla
- Importante: la recuperación puede ocurrir solo después de abrir WhatsApp en el teléfono o dejarlo activo en segundo plano
Solo se recuperan los mensajes que no se abrieron. Para un mensaje ya guardado normalmente, la copia que el teléfono reenvía se descarta como repetida, sin webhook ni cambios. Justo después de conectar, mientras el historial inicial aún se está procesando, esa copia puede llegar de nuevo como mensaje nuevo. Para buscar mensajes antiguos que aún no están guardados, use POST /message/history-sync.
curl --request POST \
--url https://api.wppfy.com/message/reload \
--header 'Content-Type: application/json' \
--header 'token: <api-key>' \
--data '
{
"id": "5511988887777:3EB01234567890ABCDEF"
}
'{
"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": "Error al solicitar el mensaje: no hay sesión activa"
}