OpenWA icon

OpenWA

Interact with OpenWA WhatsApp API Gateway

Actions138

Message → Get History

AI-generated

Summary

Reads recent messages for a selected chat directly from the WhatsApp device. This live history read is supported by the whatsapp-web.js engine; Baileys returns HTTP 501.

Inputs

  • Session Name or ID (required) — Select or enter the session to read from.
  • Chat Name or ID (required) — Select or enter the chat JID, such as a personal chat ending in @c.us or a group ending in @g.us.
  • Deep — Defaults to false. Enables a deeper live read and raises the maximum Limit from 100 to 2,000. Deep reads are metadata-only, so Include Media is ignored; large reads may be slow and increase WhatsApp rate-limiting risk.
  • Include Media — Defaults to false. Requests media payloads in returned messages. Ignored when Deep is enabled.
  • Limit — Maximum number of messages to return; defaults to 50. The normal-read ceiling is 100, and Deep raises it to 2,000.

Output shape

A list of message items read from the selected chat.

History is read live from the device, not from the gateway's stored archive, so the session must use whatsapp-web.js. Baileys responds with HTTP 501. Deep reads return metadata only.

Links

Discussion