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 Sticker

AI-generated

Summary

Send selected Telegram content types (text, media, locations, polls, etc.) using the provided bot token.

Inputs

  • botToken (required) — Bot token (password‑type field) taken from input JSON, e.g. from Orchestrator.
  • operation (required) — Telegram API method to invoke, such as 'sendSticker', 'sendPhoto', etc.
  • chatId (required) — Target chat identifier; can be derived from input JSON.
  • replyToMessageId — Optional message ID to reply to, usually from a previous node.
  • replyMarkup — Inline keyboard markup JSON; can be supplied from input.
  • mediaSource — Source of media: 'url' for URL/file_id or 'binary' for binary data.
  • media — URL or file_id of media; for binary mode this is ignored.
  • binaryPropertyName — Name of the binary property in the input item that holds the media data.
  • useRateLimit — Enable Redis‑based rate limiting to avoid 429 errors.
  • text — Text content for sendText operation; fallback from caption or publication.
  • entities — JSON array of message entities for text formatting.
  • caption — Caption text for media messages.
  • captionEntities — JSON array of caption entities for formatting.
  • hasSpoiler — Add spoiler flag to photos or videos.
  • mediaGroupSource — Method to provide media for sendMediaGroup: 'urls' or 'binary'.
  • mediaGroupUrls — Comma‑separated list of URLs or file_ids for media group.
  • mediaGroupBinaryNames — Comma‑separated list of binary property names for media group.
  • mediaGroupTypes — Comma‑separated list of media types matching mediaGroupUrls/binaryNames.
  • fromChatId — Source chat ID for forward or copy operations.
  • messageId — Message ID to forward or copy.
  • latitude — Latitude for location or venue.
  • longitude — Longitude for location or venue.
  • venueTitle — Title for venue.
  • venueAddress — Address for venue.
  • phoneNumber — Phone number for contact.
  • firstName — First name for contact.
  • lastName — Last name for contact.
  • pollQuestion — Question text for a poll.
  • pollOptions — Comma‑separated list of poll options.
  • pollAnonymous — Make poll anonymous.
  • pollQuiz — Turn poll into a quiz.
  • pollCorrectOptionId — Correct option index for quiz.
  • pollOpenPeriod — Open period in seconds.
  • diceEmoji — Emoji representing the dice face.

Output shape

Three possible output streams: success items containing Telegram API responses, blocked 403 items for user‑blocked errors, and error items for other failures.

Each stream may be empty; success items are passed downstream; blocked items are sent to the second output; errors are sent to the third output unless continueOnFail is enabled.

Examples

Example 1: Send a sticker using a URL stored in the incoming item's media field.

Operation set to 'sendSticker', chatId from input, mediaSource = url, media = {{ $json.media?.[0]?.url }}, botToken from credentials.

Example 2: Forward a message from another chat.

Operation = 'forward', fromChatId and messageId provided, replyToMessageId optional, botToken required.

Example 3: Send a media group using multiple binary properties.

Operation = 'sendMediaGroup', mediaGroupSource = binary, mediaGroupBinaryNames = data1,data2, mediaGroupTypes = photo,video, botToken required, rate limit enabled.

Links

Discussion