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 Contact

AI-generated

Summary

Send a Telegram contact message to a specified chat ID.

Inputs

  • botToken — Bot token used to authenticate with Telegram (usually from previous node)
  • chatId (required) — Telegram chat identifier where the contact will be sent
  • replyToMessageId — Optional message ID to reply to (taken from previous node)
  • replyMarkup — Inline keyboard or other reply markup (JSON) as conveyed via input
  • phoneNumber (required) — Recipient's phone number in international format
  • firstName (required) — Recipient's first name
  • lastName (required) — Recipient's last name
  • useRateLimit — When true, node will use Redis to throttle requests and avoid 429 errors

Output shape

On success a Telegram contact message object is returned; on user block (403) a custom envelope with error details is emitted; on other errors an error envelope is emitted.

The successful output contains the full Telegram message payload; blocked output includes error_code 403, description and original item; error output includes standard n8n error fields. Outputs are passed downstream as separate items.

Examples

Example 1: Send a contact to a user when chatId, phoneNumber, firstName, lastName are provided by previous nodes.

Operation: sendContact; botToken from input; chatId=123456789; phoneNumber=+15551234567; firstName=John; lastName=Doe; useRateLimit=false

Example 2: Send a contact while replying to an existing message using its ID.

Operation: sendContact; botToken from input; chatId=987654321; phoneNumber=+447700123456; firstName=Jane; lastName=Smith; replyToMessageId=11223344

Example 3: Throttle outgoing contacts to stay within Telegram rate limits using Redis.

Operation: sendContact; botToken from input; chatId=555555555; phoneNumber=+33612345678; firstName=Bob; lastName=Brown; useRateLimit=true

Links

Discussion