Recibir mensajes

Puedes recibir mensajes de WhatsApp de dos formas: leyendo el historial de mensajes de un chat y recibiendo mensajes en tiempo real mediante Eventos.

Leer historial de mensajes

Obtén el historial de mensajes de un chat:

http
GET /api/{session}/chats/{chatId}/messages?limit=100
jsonResponse
[
  {
    "id": "false_5215551234567@c.us_ABC123",
    "timestamp": 1723456789,
    "from": "5215551234567@c.us",
    "fromMe": false,
    "body": "Hola",
    "hasMedia": false
  }
]

Obtener un mensaje específico

http
GET /api/{session}/chats/{chatId}/messages/{messageId}?downloadMedia=true

Descargar archivos multimedia

Descarga el contenido multimedia (imagen, audio, video, documento) de un mensaje:

http
GET /api/files/{id}

La autenticación se envía mediante el header X-Api-Key.

Recibir mensajes en tiempo real

Para recibir mensajes al instante, configura Eventos en la sesión. Los eventos de mensajes disponibles son:

  • message — mensaje entrante.
  • message.any — cualquier evento de mensaje.
  • message.reaction — reacción a un mensaje.
  • message.ack — confirmación de entrega/lectura.
  • message.ack.group — confirmación de un participante en un grupo.
  • message.waiting — mensaje en cola.
  • message.edited — mensaje editado.
  • message.revoked — mensaje eliminado.