Saltar al contenido principal
POST
/
api
/
chat
/
history
/
:instance
Historial del chat
curl --request POST \
  --url https://api.example.com/api/chat/history/:instance \
  --header 'Content-Type: application/json' \
  --data '
{
  "number": "<string>",
  "count": 123,
  "from": "<string>",
  "to": "<string>"
}
'
Auth: TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: sí

​
Descripción

Devuelve los mensajes almacenados de un chat específico, ordenados del más reciente al más antiguo. Puedes controlar la cantidad con count y filtrar por una ventana de fechas con from/to.
No hay cursor de paginación. Para paginar, ajusta los filtros from y to. El campo hasMore es una heurística: es true cuando la cantidad de mensajes devueltos == count (probablemente hay más).

​
Ejemplos

​
Últimos 50

Forma mínima: pasa solo number y usa el count predeterminado de 50 mensajes, devolviendo los más recientes del chat ordenados del más nuevo al más antiguo. 
curl -X POST "https://ryzeapi.cloud/api/chat/history/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{"number":"5511999999999"}'

​
Con ventana de fechas

Recupera hasta 200 mensajes enviados entre el 20 y el 28 de abril de 2026 (from/to en ISO 8601). Útil para extraer historial de un intervalo específico o paginar usando to como cursor. 
curl -X POST "https://ryzeapi.cloud/api/chat/history/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "5511999999999",
    "count":  200,
    "from":   "2026-04-20T00:00:00Z",
    "to":     "2026-04-28T23:59:59Z"
  }'

​
Grupo

La misma lógica, pero con number apuntando a un JID de grupo (@g.us) y count de 100. Cada item en messages[] lleva senderJid con el autor del mensaje dentro del grupo. 
curl -X POST "https://ryzeapi.cloud/api/chat/history/$Instance_Name" \
  -H "token: $Token_Instance" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "120363123456789@g.us",
    "count":  100
  }'

​
Respuesta exitosa

messages lleva los mensajes en orden cronológico inverso (más nuevos primero). count indica cuántos items vinieron en esta página y hasMore es true cuando alcanzaste exactamente el count solicitado, señalando que puede haber más mensajes, pagina usando los from/to del último mensaje devuelto. chat_jid es el JID resuelto del chat solicitado.
200 OK
{
  "success": true,
  "message": "Retrieved 2 messages from chat history",
  "chat_jid": "5511999999999@s.whatsapp.net",
  "messages": [
    {
      "id": "3EB08FCF27E532F1B0F5",
      "fromMe": true,
      "timestamp": "2026-04-28T14:30:00Z",
      "content": "Hi",
      "type": "text",
      "chatJid": "5511999999999@s.whatsapp.net",
      "senderJid": ""
    },
    {
      "id": "3EB08FCF27E532F1B0F4",
      "fromMe": false,
      "timestamp": "2026-04-28T14:29:55Z",
      "content": "Good morning!",
      "type": "text",
      "chatJid": "5511999999999@s.whatsapp.net",
      "senderJid": "5511999999999@s.whatsapp.net"
    }
  ],
  "count": 2,
  "hasMore": false
}

​
Parámetros de ruta

​
instance
string
requerido
Nombre de la instancia.

​
Cabeceras

NombreRequeridoEjemploDescripción
Content-Typesíapplication/json,
tokensí (o Authorization)a1b2c3d4-...TokenAccount o TokenInstance.

​
Cuerpo de la solicitud

​
number
string
requerido
Número de teléfono, JID privado (...@s.whatsapp.net o ...@lid), JID de grupo (...@g.us) o newsletter.
​
count
int
predeterminado:"50"
Cantidad máxima de mensajes a devolver. Sin límite superior interno.
​
from
string
ISO 8601 / RFC3339. Mensajes a partir de esta fecha (inclusive).
​
to
string
ISO 8601 / RFC3339. Mensajes hasta esta fecha (inclusive).

​
Notas y precauciones

  • Funciona incluso cuando la instancia está desconectada, lee directamente de la base de datos de ingestión.
  • Para paginar de forma segura, define to = timestamp del mensaje más antiguo ya recibido en la llamada anterior.
  • hasMore=true no garantiza al 100% que existan más mensajes, es solo una heurística basada en el count solicitado.

​
Respuestas de error

HTTPerror.messageCuándo ocurre
400Instance name is required,
400Invalid request body: <...>JSON malformado.
400Number is required,
400invalid 'from' date format. Use ISO 8601 format (e.g., '2026-02-16T18:32:39Z'),
400invalid 'to' date format. Use ISO 8601 format (e.g., '2026-02-16T18:32:39Z'),
401Invalid token,
404Instance not found,
Error 400
{
  "success": false,
  "error": { "message": "Number is required" }
}

​
Relacionados

Buscar mensaje

Recupera un mensaje específico del historial.

Media en base64

Descarga un media referenciado en el historial.