Telegram Multi Actions (Stage) icon

Telegram Multi Actions (Stage)

Send all Telegram content types (text, media, video note, sticker, location, poll, dice, etc.) via Grammy. Supports URL, file_id, and n8n binary. Optional Redis rate limit, retry on 429, separate output for 403 (user blocked bot).

Actions17

Send Document

AI-generated

Summary

Send a document to a Telegram chat using the specified bot token and optional reply, caption, and rate‑limit settings.

Inputs

  • botToken — Bot token from input (e.g. from Orchestrator/Strapi)
  • chatId (required) — Chat ID of the destination chat; usually from a previous node.
  • replyToMessageId — Telegram message_id to reply to; often derived from previous nodes.
  • replyMarkup — Inline keyboard or reply keyboard JSON; optional for the operation.
  • mediaSource — Source of media: URL or file_id (or binary data if using binary mode).
  • media — URL or Telegram file_id for the document; defaults to the value from the previous node.
  • binaryPropertyName — Name of the binary property in the input item that holds the file data (default: "data").
  • caption — Caption text for the document; falls back to the node's text field.
  • captionEntities — Array of caption entities (formatting hints) for the document.
  • useRateLimit — Enable Redis‑based rate limiting to avoid 429 errors (requires Redis credentials).

Output shape

list of items per output (success, blocked, error)

Success output contains Telegram API response objects; blocked output contains items for 403 (bot blocked) with error details; error output contains items for other failures when continueOnFail is enabled. Each output is an array of record objects with json and pairedItem fields.

Examples

Example 1: Send a PDF from a URL

Bot Token from $json.access_token, Chat ID from $json.chatId, Media Source URL, Media URL from $json.url, no binary property, optional caption from $json.caption

Example 2: Upload a file from binary data

Bot Token from $json.access_token, Chat ID from $json.chatId, Media Source set to Binary, Binary Property Name from $json.binaryPropertyName, optional caption from $json.caption

Links

Discussion