Concept
The Messages group provides direct access to individual messages by their unique identifier — without needing to know which conversation they belong to. These endpoints are useful in scenarios where you already have themessage_id at hand (for example, received via webhook) and need to fetch the full details or remove the message.
To list messages within the context of a specific conversation, use the endpoints from the Conversations or Chats groups, which offer pagination and conversation-based filters.
Message Structure
A message in Timely.ai represents any unit of communication exchanged in a conversation: text, image, audio, video, document, or interactive message (buttons, lists). Each message records the sender (contact, AI agent, or human), the source channel, delivery status, and platform metadata (such as the WhatsAppwamid or Telegram message_id).
Main Fields
When to Use Messages vs Conversations vs Chats
Available Endpoints
See the left sidebar for the full list of endpoints in this group. Each endpoint has its own page with request/response schema, cURL/JS/Python examples, and an interactive playground.
Next Steps
Your first request
If you haven’t made your first call yet, start here.