TelePilot2 Album Trigger icon

TelePilot2 Album Trigger

Triggers when a new album (group of media messages) is received

TelePilot2 Album Trigger

AI-generated

Summary

Listen for new Telegram media albums or optionally standalone messages, filtered by chat and group settings, and emit grouped album data when collected within a configurable time window.

Inputs

  • Chat ID Filter — Number to filter albums by a specific chat. Set to 0 to trigger for all chats.
  • Options.collectWindowSeconds — Number of seconds to wait for additional album messages before emitting the album (default 3).
  • Options.includeStandalone — Boolean to include non-album standalone messages in triggers (default false).
  • Options.ignoreGroups — Boolean to ignore albums from group chats (chats with negative chat IDs) (default false).

Output shape

A JSON array containing one object per emitted album or standalone message.

Each emitted item includes album_id, chat_id, message_count, first_message_id, last_message_id, date, caption, and an array of messages. Albums accumulate messages over the collect window before emission. Standalone messages are emitted individually if included. If Telegram account is not logged in, emits an error message.

Examples

Example 1: An album with multiple media messages arrives in a specified chat; the node waits up to the configured collect window to accumulate all messages, then emits the entire album as one object including all messages and metadata.

chatIdFilter set to an individual chat's ID, collect window at default 3 seconds; includeStandalone false; ignoreGroups false.

Example 2: Single media messages outside albums are emitted immediately if includeStandalone is true.

includeStandalone toggled to true; no chat ID filter.

Links

Discussion