Actions7
- Media Actions
- Message Actions
- Moderation Actions
Message → Get Messages
AI-generatedSummary
Fetch messages from a Telegram chat, filtered by recency mode (limit, hours, or date range), with optional media presence and type filtering.
Inputs
- chatId (required) — Chat ID (-100... or @channelusername). Required.
- mode — Select filtering mode: limit (recent count), hours (last X hours), or range (date range).
- limit — Maximum number of recent messages to retrieve. Visible when mode is limit.
- hours — Return messages from the last N hours. Visible when mode is hours.
- maxMessages — Safety cap for very active chats. Visible when mode is hours or range.
- fromDate — Start of date range (inclusive). Visible when mode is range.
- toDate — End of date range (inclusive). Visible when mode is range.
- onlyMedia — If true, only return messages that contain media (photos, videos, documents).
- mediaType — Filter by specific media types (photo, video, document). Visible when onlyMedia is true.
Output shape
Array of message objects, each containing messageId, chatId, date (ISO 8601), text, hasMedia, and mediaType (photo | video | document | other). Messages without matching filters are omitted.
Returns only messages that pass all active filters (mode bounds, onlyMedia, mediaType). Media type detection follows the node's internal logic: photo for image media, video for video or document-with-video-mime, document for other documents, and 'other' for messages with media not matching the above.
Examples
Example 1: Retrieve last 20 messages from a channel
chatId: -1001234567890, mode: limit, limit: 20