# Telegram (/integrations/telegram)





{/* MANUAL-CONTENT-START:intro */}

Use [Telegram](https://telegram.org)'s Bot API to send messages, photos, videos, audio, animations, documents, locations, contacts, or polls. Message actions also edit, forward, copy, pin, delete, and react; chat actions retrieve chat or member details and show status indicators.

## Start workflows from Telegram messages [#start-workflows-from-telegram-messages]

1. Send `/newbot` to [BotFather](https://t.me/BotFather) in Telegram and copy the bot token.
2. Add a Telegram trigger to your workflow and enter **Bot Token**.
3. Deploy the workflow. Sim registers the generated webhook URL with Telegram.
4. Send a message to the bot and inspect the workflow run. The trigger returns message and sender data, including the source chat ID.

Telegram registers one webhook per bot. Registering it elsewhere redirects delivery, so use a separate bot when workflows need independent webhook destinations. See the [Telegram bot tutorial](https://core.telegram.org/bots/tutorial).

The [webhook setup video](https://www.youtube.com/embed/9oKcJtQ0_IM) also demonstrates starting a run from an incoming message.

## Send messages to a Telegram group [#send-messages-to-a-telegram-group]

1. Add the bot to the group and grant the permissions needed by the action.
2. Obtain the group's numeric chat ID from a bot message update, such as the trigger's `message.raw.chat.id`. Group IDs can be negative.
3. Add a Telegram action block, select **Send Message**, and set **Bot Token**, **Chat ID**, and **Message**.
4. Run the workflow and verify the message in the group.

The [group messaging video](https://www.youtube.com/embed/AG55LpUreGI) demonstrates the block configuration. Bot privacy settings affect which group messages Telegram delivers; receiving a command addressed to the bot can help verify the trigger before changing those settings.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Send, edit, forward, copy, pin, or delete messages; send media, locations, contacts, and polls; set reactions and chat actions; and inspect chats and members. Bot messages and events can start workflows.

## Actions [#actions]

### Telegram Send Message [#telegram-send-message]

Send a text message through the Telegram Bot API. Markdown is converted to Telegram HTML before sending; the response includes the sent message and recipient chat.

<ReferenceDetails>
  #### Input [#input]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID (numeric, can be negative for groups) |
  | `text` | string | Yes | Message text to send |

  #### Output [#output]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Telegram message data |
  | ↳ `message_id` | number | Unique Telegram message identifier |
  | ↳ `from` | object | Sender information |
  | ↳ `id` | number | Sender user ID |
  | ↳ `is_bot` | boolean | Whether the sender is a bot |
  | ↳ `first_name` | string | Sender first name |
  | ↳ `username` | string | Sender username, when available |
  | ↳ `chat` | object | Recipient chat information |
  | ↳ `id` | number | Recipient chat ID |
  | ↳ `first_name` | string | Chat first name, for private chats |
  | ↳ `username` | string | Chat username, when available |
  | ↳ `type` | string | Chat type: private, group, supergroup, or channel |
  | ↳ `date` | number | Unix timestamp when message was sent |
  | ↳ `text` | string | Text content of the sent message |
</ReferenceDetails>

### Telegram Delete Message [#telegram-delete-message]

Delete messages in Telegram channels or chats through the Telegram Bot API. Requires the message ID of the message to delete.

<ReferenceDetails>
  #### Input [#input-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID (numeric, can be negative for groups) |
  | `messageId` | string | Yes | Telegram message ID (numeric identifier of the message to delete) |

  #### Output [#output-1]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Delete operation result |
  | ↳ `ok` | boolean | API response success status |
  | ↳ `deleted` | boolean | Whether the message was successfully deleted |
</ReferenceDetails>

### Telegram Send Photo [#telegram-send-photo]

Send photos to Telegram channels or users through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-2]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID (numeric, can be negative for groups) |
  | `photo` | string | Yes | Photo to send. Pass a file\_id or HTTP URL |
  | `caption` | string | No | Photo caption (optional) |

  #### Output [#output-2]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Telegram message data including optional photo(s) |
  | ↳ `message_id` | number | Unique Telegram message identifier |
  | ↳ `from` | object | Chat information |
  | ↳ `id` | number | Chat ID |
  | ↳ `is_bot` | boolean | Whether the chat is a bot or not |
  | ↳ `first_name` | string | Chat username (if available) |
  | ↳ `username` | string | Chat title (for groups and channels) |
  | ↳ `chat` | object | Information about the bot that sent the message |
  | ↳ `id` | number | Bot user ID |
  | ↳ `first_name` | string | Bot first name |
  | ↳ `username` | string | Bot username |
  | ↳ `type` | string | Chat type (private, group, supergroup, channel) |
  | ↳ `date` | number | Unix timestamp when message was sent |
  | ↳ `text` | string | Text content of the sent message (if applicable) |
  | ↳ `photo` | array | List of photos included in the message |
  | ↳ `file_id` | string | Unique file ID of the photo |
  | ↳ `file_unique_id` | string | Unique identifier for this file across different bots |
  | ↳ `file_size` | number | Size of the photo file in bytes |
  | ↳ `width` | number | Photo width in pixels |
  | ↳ `height` | number | Photo height in pixels |
</ReferenceDetails>

### Telegram Send Video [#telegram-send-video]

Send videos to Telegram channels or users through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-3]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID (numeric, can be negative for groups) |
  | `video` | string | Yes | Video to send. Pass a file\_id or HTTP URL |
  | `caption` | string | No | Video caption (optional) |

  #### Output [#output-3]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Telegram message data including optional media |
  | ↳ `message_id` | number | Unique Telegram message identifier |
  | ↳ `from` | object | Information about the sender |
  | ↳ `id` | number | Sender ID |
  | ↳ `is_bot` | boolean | Whether the chat is a bot or not |
  | ↳ `first_name` | string | Sender's first name (if available) |
  | ↳ `username` | string | Sender's username (if available) |
  | ↳ `chat` | object | Information about the chat where message was sent |
  | ↳ `id` | number | Chat ID |
  | ↳ `first_name` | string | Chat first name (if private chat) |
  | ↳ `username` | string | Chat username (for private or channels) |
  | ↳ `type` | string | Type of chat (private, group, supergroup, or channel) |
  | ↳ `date` | number | Unix timestamp when the message was sent |
  | ↳ `text` | string | Text content of the sent message (if applicable) |
  | ↳ `format` | object | Media format information (for videos, GIFs, etc.) |
  | ↳ `file_name` | string | Media file name |
  | ↳ `mime_type` | string | Media MIME type |
  | ↳ `duration` | number | Duration of media in seconds |
  | ↳ `width` | number | Media width in pixels |
  | ↳ `height` | number | Media height in pixels |
  | ↳ `thumbnail` | object | Thumbnail image details |
  | ↳ `file_id` | string | Thumbnail file ID |
  | ↳ `file_unique_id` | string | Unique thumbnail file identifier |
  | ↳ `file_size` | number | Thumbnail file size in bytes |
  | ↳ `width` | number | Thumbnail width in pixels |
  | ↳ `height` | number | Thumbnail height in pixels |
  | ↳ `thumb` | object | Secondary thumbnail details (duplicate of thumbnail) |
  | ↳ `file_id` | string | Thumbnail file ID |
  | ↳ `file_unique_id` | string | Unique thumbnail file identifier |
  | ↳ `file_size` | number | Thumbnail file size in bytes |
  | ↳ `width` | number | Thumbnail width in pixels |
  | ↳ `height` | number | Thumbnail height in pixels |
  | ↳ `file_id` | string | Media file ID |
  | ↳ `file_unique_id` | string | Unique media file identifier |
  | ↳ `file_size` | number | Size of media file in bytes |
  | ↳ `document` | object | Document file details if the message contains a document |
  | ↳ `file_name` | string | Document file name |
  | ↳ `mime_type` | string | Document MIME type |
  | ↳ `thumbnail` | object | Document thumbnail information |
  | ↳ `file_id` | string | Thumbnail file ID |
  | ↳ `file_unique_id` | string | Unique thumbnail file identifier |
  | ↳ `file_size` | number | Thumbnail file size in bytes |
  | ↳ `width` | number | Thumbnail width in pixels |
  | ↳ `height` | number | Thumbnail height in pixels |
  | ↳ `thumb` | object | Duplicate thumbnail info (used for compatibility) |
  | ↳ `file_id` | string | Thumbnail file ID |
  | ↳ `file_unique_id` | string | Unique thumbnail file identifier |
  | ↳ `file_size` | number | Thumbnail file size in bytes |
  | ↳ `width` | number | Thumbnail width in pixels |
  | ↳ `height` | number | Thumbnail height in pixels |
  | ↳ `file_id` | string | Document file ID |
  | ↳ `file_unique_id` | string | Unique document file identifier |
  | ↳ `file_size` | number | Size of document file in bytes |
</ReferenceDetails>

### Telegram Send Audio [#telegram-send-audio]

Send audio files to Telegram channels or users through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-4]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID (numeric, can be negative for groups) |
  | `audio` | string | Yes | Audio file to send. Pass a file\_id or HTTP URL |
  | `caption` | string | No | Audio caption (optional) |

  #### Output [#output-4]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Telegram message data including voice/audio information |
  | ↳ `message_id` | number | Unique Telegram message identifier |
  | ↳ `from` | object | Information about the sender |
  | ↳ `id` | number | Sender ID |
  | ↳ `is_bot` | boolean | Whether the chat is a bot or not |
  | ↳ `first_name` | string | Sender's first name (if available) |
  | ↳ `username` | string | Sender's username (if available) |
  | ↳ `chat` | object | Information about the chat where the message was sent |
  | ↳ `id` | number | Chat ID |
  | ↳ `first_name` | string | Chat first name (if private chat) |
  | ↳ `username` | string | Chat username (for private or channels) |
  | ↳ `type` | string | Type of chat (private, group, supergroup, or channel) |
  | ↳ `date` | number | Unix timestamp when the message was sent |
  | ↳ `text` | string | Text content of the sent message (if applicable) |
  | ↳ `audio` | object | Audio file details |
  | ↳ `duration` | number | Duration of the audio in seconds |
  | ↳ `performer` | string | Performer of the audio |
  | ↳ `title` | string | Title of the audio |
  | ↳ `file_name` | string | Original filename of the audio |
  | ↳ `mime_type` | string | MIME type of the audio file |
  | ↳ `file_id` | string | Unique file identifier for this audio |
  | ↳ `file_unique_id` | string | Unique identifier across different bots for this file |
  | ↳ `file_size` | number | Size of the audio file in bytes |
</ReferenceDetails>

### Telegram Send Animation [#telegram-send-animation]

Send animations (GIFs) to Telegram channels or users through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-5]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID (numeric, can be negative for groups) |
  | `animation` | string | Yes | Animation to send. Pass a file\_id or HTTP URL |
  | `caption` | string | No | Animation caption (optional) |

  #### Output [#output-5]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Telegram message data including optional media |
  | ↳ `message_id` | number | Unique Telegram message identifier |
  | ↳ `from` | object | Information about the sender |
  | ↳ `id` | number | Sender ID |
  | ↳ `is_bot` | boolean | Whether the chat is a bot or not |
  | ↳ `first_name` | string | Sender's first name (if available) |
  | ↳ `username` | string | Sender's username (if available) |
  | ↳ `chat` | object | Information about the chat where message was sent |
  | ↳ `id` | number | Chat ID |
  | ↳ `first_name` | string | Chat first name (if private chat) |
  | ↳ `username` | string | Chat username (for private or channels) |
  | ↳ `type` | string | Type of chat (private, group, supergroup, or channel) |
  | ↳ `date` | number | Unix timestamp when the message was sent |
  | ↳ `text` | string | Text content of the sent message (if applicable) |
  | ↳ `format` | object | Media format information (for videos, GIFs, etc.) |
  | ↳ `file_name` | string | Media file name |
  | ↳ `mime_type` | string | Media MIME type |
  | ↳ `duration` | number | Duration of media in seconds |
  | ↳ `width` | number | Media width in pixels |
  | ↳ `height` | number | Media height in pixels |
  | ↳ `thumbnail` | object | Thumbnail image details |
  | ↳ `file_id` | string | Thumbnail file ID |
  | ↳ `file_unique_id` | string | Unique thumbnail file identifier |
  | ↳ `file_size` | number | Thumbnail file size in bytes |
  | ↳ `width` | number | Thumbnail width in pixels |
  | ↳ `height` | number | Thumbnail height in pixels |
  | ↳ `thumb` | object | Secondary thumbnail details (duplicate of thumbnail) |
  | ↳ `file_id` | string | Thumbnail file ID |
  | ↳ `file_unique_id` | string | Unique thumbnail file identifier |
  | ↳ `file_size` | number | Thumbnail file size in bytes |
  | ↳ `width` | number | Thumbnail width in pixels |
  | ↳ `height` | number | Thumbnail height in pixels |
  | ↳ `file_id` | string | Media file ID |
  | ↳ `file_unique_id` | string | Unique media file identifier |
  | ↳ `file_size` | number | Size of media file in bytes |
  | ↳ `document` | object | Document file details if the message contains a document |
  | ↳ `file_name` | string | Document file name |
  | ↳ `mime_type` | string | Document MIME type |
  | ↳ `thumbnail` | object | Document thumbnail information |
  | ↳ `file_id` | string | Thumbnail file ID |
  | ↳ `file_unique_id` | string | Unique thumbnail file identifier |
  | ↳ `file_size` | number | Thumbnail file size in bytes |
  | ↳ `width` | number | Thumbnail width in pixels |
  | ↳ `height` | number | Thumbnail height in pixels |
  | ↳ `thumb` | object | Duplicate thumbnail info (used for compatibility) |
  | ↳ `file_id` | string | Thumbnail file ID |
  | ↳ `file_unique_id` | string | Unique thumbnail file identifier |
  | ↳ `file_size` | number | Thumbnail file size in bytes |
  | ↳ `width` | number | Thumbnail width in pixels |
  | ↳ `height` | number | Thumbnail height in pixels |
  | ↳ `file_id` | string | Document file ID |
  | ↳ `file_unique_id` | string | Unique document file identifier |
  | ↳ `file_size` | number | Size of document file in bytes |
</ReferenceDetails>

### Telegram Send Document [#telegram-send-document]

Send documents (PDF, ZIP, DOC, etc.) to Telegram channels or users through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-6]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID (numeric, can be negative for groups) |
  | `files` | file\[] | No | Document file to send (PDF, ZIP, DOC, etc.). Max size: 50MB |
  | `caption` | string | No | Document caption (optional) |

  #### Output [#output-6]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `files` | file\[] | Files attached to the message |
  | `data` | object | Telegram message data including document |
  | ↳ `message_id` | number | Unique Telegram message identifier |
  | ↳ `from` | object | Information about the sender |
  | ↳ `id` | number | Sender ID |
  | ↳ `is_bot` | boolean | Whether the chat is a bot or not |
  | ↳ `first_name` | string | Sender's first name (if available) |
  | ↳ `username` | string | Sender's username (if available) |
  | ↳ `chat` | object | Information about the chat where message was sent |
  | ↳ `id` | number | Chat ID |
  | ↳ `first_name` | string | Chat first name (if private chat) |
  | ↳ `username` | string | Chat username (for private or channels) |
  | ↳ `type` | string | Type of chat (private, group, supergroup, or channel) |
  | ↳ `date` | number | Unix timestamp when the message was sent |
  | ↳ `document` | object | Document file details |
  | ↳ `file_name` | string | Document file name |
  | ↳ `mime_type` | string | Document MIME type |
  | ↳ `file_id` | string | Document file ID |
  | ↳ `file_unique_id` | string | Unique document file identifier |
  | ↳ `file_size` | number | Size of document file in bytes |
</ReferenceDetails>

### Telegram Edit Message Text [#telegram-edit-message-text]

Edit the text of an existing message in a Telegram chat or channel through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-7]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID (numeric, can be negative for groups) |
  | `messageId` | number | Yes | Identifier of the message to edit |
  | `text` | string | Yes | New text of the message |

  #### Output [#output-7]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Edited Telegram message data |
  | ↳ `message_id` | number | Unique Telegram message identifier |
  | ↳ `date` | number | Unix timestamp when message was sent |
  | ↳ `text` | string | Text content of the edited message |
</ReferenceDetails>

### Telegram Forward Message [#telegram-forward-message]

Forward a message from one Telegram chat to another through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-8]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Destination chat ID (numeric, can be negative for groups) |
  | `fromChatId` | string | Yes | Source chat ID the original message belongs to |
  | `messageId` | number | Yes | Identifier of the message to forward in the source chat |

  #### Output [#output-8]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Forwarded Telegram message data |
  | ↳ `message_id` | number | Identifier of the forwarded message |
  | ↳ `date` | number | Unix timestamp when message was sent |
  | ↳ `text` | string | Text content of the forwarded message |
</ReferenceDetails>

### Telegram Copy Message [#telegram-copy-message]

Copy a message to another Telegram chat without a forward header through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-9]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Destination chat ID (numeric, can be negative for groups) |
  | `fromChatId` | string | Yes | Source chat ID the original message belongs to |
  | `messageId` | number | Yes | Identifier of the message to copy in the source chat |
  | `caption` | string | No | New caption for the copied media (keeps the original if omitted) |

  #### Output [#output-9]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Copied message identifier |
  | ↳ `message_id` | number | Identifier of the new copied message |
</ReferenceDetails>

### Telegram Send Location [#telegram-send-location]

Send a point on the map to a Telegram chat through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-10]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID (numeric, can be negative for groups) |
  | `latitude` | number | Yes | Latitude of the location |
  | `longitude` | number | Yes | Longitude of the location |

  #### Output [#output-10]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Telegram message data for the sent location |
  | ↳ `message_id` | number | Unique Telegram message identifier |
  | ↳ `date` | number | Unix timestamp when message was sent |
</ReferenceDetails>

### Telegram Send Contact [#telegram-send-contact]

Send a phone contact to a Telegram chat through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-11]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID (numeric, can be negative for groups) |
  | `phoneNumber` | string | Yes | Contact's phone number |
  | `firstName` | string | Yes | Contact's first name |
  | `lastName` | string | No | Contact's last name |
  | `vcard` | string | No | Additional data about the contact in the form of a vCard |

  #### Output [#output-11]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Telegram message data for the sent contact |
  | ↳ `message_id` | number | Unique Telegram message identifier |
  | ↳ `date` | number | Unix timestamp when message was sent |
</ReferenceDetails>

### Telegram Send Poll [#telegram-send-poll]

Send a native poll to a Telegram chat through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-12]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID (numeric, can be negative for groups) |
  | `question` | string | Yes | Poll question (1-300 characters) |
  | `options` | json | Yes | List of 2-10 answer options as text strings |
  | `isAnonymous` | boolean | No | Whether the poll needs to be anonymous (defaults to true) |
  | `allowsMultipleAnswers` | boolean | No | Whether the poll allows multiple answers |

  #### Output [#output-12]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Telegram message data for the sent poll |
  | ↳ `message_id` | number | Unique Telegram message identifier |
  | ↳ `date` | number | Unix timestamp when message was sent |
</ReferenceDetails>

### Telegram Pin Message [#telegram-pin-message]

Pin a message in a Telegram chat through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-13]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID (numeric, can be negative for groups) |
  | `messageId` | number | Yes | Identifier of the message to pin |
  | `disableNotification` | boolean | No | Pass true to pin silently without notifying chat members |

  #### Output [#output-13]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Pin operation result |
  | ↳ `ok` | boolean | API response success status |
  | ↳ `result` | boolean | Whether the message was pinned |
</ReferenceDetails>

### Telegram Unpin Message [#telegram-unpin-message]

Unpin a pinned message in a Telegram chat through the Telegram Bot API. Unpins the most recent pinned message when no message ID is given.

<ReferenceDetails>
  #### Input [#input-14]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID (numeric, can be negative for groups) |
  | `messageId` | number | No | Identifier of the message to unpin (omit to unpin the most recent one) |

  #### Output [#output-14]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Unpin operation result |
  | ↳ `ok` | boolean | API response success status |
  | ↳ `result` | boolean | Whether the message was unpinned |
</ReferenceDetails>

### Telegram Set Message Reaction [#telegram-set-message-reaction]

Set or remove an emoji reaction on a message in a Telegram chat through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-15]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID (numeric, can be negative for groups) |
  | `messageId` | number | Yes | Identifier of the target message |
  | `reaction` | string | No | Emoji to react with (leave empty to remove the reaction) |
  | `isBig` | boolean | No | Pass true to show the reaction with a big animation |

  #### Output [#output-15]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Reaction operation result |
  | ↳ `ok` | boolean | API response success status |
  | ↳ `result` | boolean | Whether the reaction was set |
</ReferenceDetails>

### Telegram Send Chat Action [#telegram-send-chat-action]

Show a status action such as a typing indicator in a Telegram chat through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-16]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID (numeric, can be negative for groups) |
  | `action` | string | Yes | Type of action to broadcast (e.g. typing, upload\_photo, record\_video, upload\_document, find\_location) |

  #### Output [#output-16]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Chat action result |
  | ↳ `ok` | boolean | API response success status |
  | ↳ `result` | boolean | Whether the action was broadcast |
</ReferenceDetails>

### Telegram Get Chat [#telegram-get-chat]

Get up-to-date information about a Telegram chat through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-17]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID or @username (numeric, can be negative for groups) |

  #### Output [#output-17]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Telegram chat information |
  | ↳ `id` | number | Unique chat identifier |
  | ↳ `type` | string | Chat type (private, group, supergroup, channel) |
  | ↳ `title` | string | Chat title for groups and channels |
  | ↳ `username` | string | Chat username, if available |
  | ↳ `first_name` | string | First name for private chats |
  | ↳ `last_name` | string | Last name for private chats |
  | ↳ `description` | string | Chat description |
  | ↳ `bio` | string | Bio of the other party in a private chat |
  | ↳ `invite_link` | string | Primary invite link for the chat |
  | ↳ `linked_chat_id` | number | Linked discussion or channel chat ID |
</ReferenceDetails>

### Telegram Get Chat Member [#telegram-get-chat-member]

Get information about a member of a Telegram chat through the Telegram Bot API.

<ReferenceDetails>
  #### Input [#input-18]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot API Token |
  | `chatId` | string | Yes | Telegram chat ID or @username (numeric, can be negative for groups) |
  | `userId` | number | Yes | Unique identifier of the target user |

  #### Output [#output-18]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Success or error message |
  | `data` | object | Telegram chat member information |
  | ↳ `status` | string | Member's status (creator, administrator, member, restricted, left, kicked) |
  | ↳ `user` | object | Information about the user |
  | ↳ `id` | number | Unique user identifier |
  | ↳ `is_bot` | boolean | Whether the user is a bot |
  | ↳ `first_name` | string | User's first name |
  | ↳ `last_name` | string | User's last name |
  | ↳ `username` | string | User's username |
</ReferenceDetails>

## Triggers [#triggers]

A trigger starts a workflow when a supported event occurs in this service.

### Telegram Webhook [#telegram-webhook]

Trigger workflow from Telegram bot messages and events

<ReferenceDetails label="Configuration and outputs">
  #### Configuration [#configuration]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `botToken` | string | Yes | Your Telegram Bot Token from BotFather |

  #### Output [#output-19]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | object | Telegram message data |
  | ↳ `id` | number | Telegram message ID |
  | ↳ `text` | string | Message text content (if present) |
  | ↳ `date` | number | Date the message was sent (Unix timestamp) |
  | ↳ `messageType` | string | Detected content type: text, photo, document, audio, video, voice, sticker, location, contact, poll |
  | ↳ `raw` | object | Raw Telegram message object |
  | ↳ `message_id` | number | Original Telegram message\_id |
  | ↳ `date` | number | Original Telegram message date (Unix timestamp) |
  | ↳ `text` | string | Original Telegram text (if present) |
  | ↳ `caption` | string | Original Telegram caption (if present) |
  | ↳ `chat` | object | Chat information |
  | ↳ `id` | number | Chat identifier |
  | ↳ `username` | string | Chat username (if available) |
  | ↳ `first_name` | string | First name (for private chats) |
  | ↳ `last_name` | string | Last name (for private chats) |
  | ↳ `title` | string | Chat title (for groups/channels) |
  | ↳ `from` | object | Sender information |
  | ↳ `id` | number | Sender user ID |
  | ↳ `is_bot` | boolean | Whether the sender is a bot |
  | ↳ `first_name` | string | Sender first name |
  | ↳ `last_name` | string | Sender last name |
  | ↳ `username` | string | Sender username |
  | ↳ `language_code` | string | Sender language code (if available) |
  | ↳ `reply_to_message` | object | Original message being replied to |
  | ↳ `entities` | array | Message entities (mentions, hashtags, URLs, etc.) |
  | `sender` | object | Sender information |
  | ↳ `id` | number | Sender user ID |
  | ↳ `username` | string | Sender username (if available) |
  | ↳ `firstName` | string | Sender first name |
  | ↳ `lastName` | string | Sender last name |
  | ↳ `languageCode` | string | Sender language code (if available) |
  | ↳ `isBot` | boolean | Whether the sender is a bot |
  | `updateId` | number | Update ID for this webhook delivery |
  | `updateType` | string | Type of update: message, edited\_message, channel\_post, edited\_channel\_post, unknown |
</ReferenceDetails>