# Send Telegram Message
**Action ID:** `telegram_send_message`
## Description
Send a text message to a Telegram chat or channel. This node allows you to deliver messages directly to any Telegram user, group, or channel using your bot connection.
## Provider
**Telegram**
## Connection
| Name | Description | Required | Category |
| ----------------------- | --------------------------------------------------- | :------: | -------- |
| Telegram Bot Connection | The Telegram bot connection to use for the message. | ✓ | telegram |
## Input Parameters
| Name | Type | Required | Default | Description |
| ------------------------ | ------- | :------: | ------- | ---------------------------------------------------------------------------------------------------------- |
| chat\_id | string | ✓ | - | Unique identifier for the target chat or username of the target channel (in the format @channelusername) |
| text | string | ✓ | - | Text of the message to be sent, 1-4096 characters after entities parsing |
| business\_connection\_id | string | - | - | Unique identifier of the business connection on behalf of which the message will be sent |
| message\_thread\_id | integer | - | - | Unique identifier for the target message thread (topic) of the forum; for forum supergroups only |
| parse\_mode | string | - | - | Mode for parsing entities in the message text. Can be 'Markdown', 'MarkdownV2', or 'HTML' |
| entities | array | - | - | A JSON-serialized list of special entities that appear in message text |
| link\_preview\_options | object | - | - | Link preview generation options for the message |
| disable\_notification | boolean | - | - | Sends the message silently. Users will receive a notification with no sound |
| protect\_content | boolean | - | - | Protects the contents of the sent message from forwarding and saving |
| allow\_paid\_broadcast | boolean | - | - | Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee |
| message\_effect\_id | string | - | - | Unique identifier of the message effect to be added to the message; for private chats only |
| reply\_parameters | object | - | - | Description of the message to reply to |
| reply\_markup | object | - | - | Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, etc. |
View JSON Schema
```json
{
"description": "Telegram send message node input.",
"properties": {
"chat_id": {
"title": "Chat ID",
"type": "string",
"description": "Unique identifier for the target chat or username of the target channel (in the format @channelusername)"
},
"text": {
"title": "Message Text",
"type": "string",
"description": "Text of the message to be sent, 1-4096 characters after entities parsing"
},
"business_connection_id": {
"title": "Business Connection ID",
"type": "string",
"description": "Unique identifier of the business connection on behalf of which the message will be sent"
},
"message_thread_id": {
"title": "Message Thread ID",
"type": "integer",
"description": "Unique identifier for the target message thread (topic) of the forum; for forum supergroups only"
},
"parse_mode": {
"title": "Parse Mode",
"type": "string",
"description": "Mode for parsing entities in the message text. Can be 'Markdown', 'MarkdownV2', or 'HTML'"
},
"entities": {
"title": "Entities",
"type": "array",
"description": "A JSON-serialized list of special entities that appear in message text"
},
"link_preview_options": {
"title": "Link Preview Options",
"type": "object",
"description": "Link preview generation options for the message"
},
"disable_notification": {
"title": "Disable Notification",
"type": "boolean",
"description": "Sends the message silently. Users will receive a notification with no sound"
},
"protect_content": {
"title": "Protect Content",
"type": "boolean",
"description": "Protects the contents of the sent message from forwarding and saving"
},
"allow_paid_broadcast": {
"title": "Allow Paid Broadcast",
"type": "boolean",
"description": "Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee"
},
"message_effect_id": {
"title": "Message Effect ID",
"type": "string",
"description": "Unique identifier of the message effect to be added to the message; for private chats only"
},
"reply_parameters": {
"title": "Reply Parameters",
"type": "object",
"description": "Description of the message to reply to"
},
"reply_markup": {
"title": "Reply Markup",
"type": "object",
"description": "Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, etc."
}
},
"required": [
"chat_id",
"text"
],
"title": "TelegramSendMessageInput",
"type": "object"
}
```
## Output Parameters
| Name | Type | Description |
| ------------- | ------- | ---------------------------------------------------------------- |
| sent\_message | object | The message that was sent (if successful) |
| success | boolean | Whether the message was sent successfully |
| error | string | The error that occurred if the message was not sent successfully |
View JSON Schema
```json
{
"description": "Telegram send message node output.",
"properties": {
"sent_message": {
"title": "Sent Message if successful",
"type": "object",
"description": "The message that was sent."
},
"success": {
"title": "Success",
"type": "boolean",
"description": "Whether the message was sent successfully."
},
"error": {
"title": "Error",
"type": "string",
"description": "The error that occurred if the message was not sent successfully."
}
},
"required": [
"success"
],
"title": "TelegramSendMessageOutput",
"type": "object"
}
```
## How It Works
This node sends a text message to a specified Telegram chat or channel using the Telegram Bot API. You provide the recipient's chat ID (or channel username), the message text, and optional formatting parameters. The node returns the sent message object and a success status indicating whether the delivery was successful.
## Usage Examples
### Example 1: Simple Message to User
**Input:**
```
chat_id: "123456789"
text: "Hello! This is a message from my workflow."
```
**Output:**
```
success: true
sent_message: {
"message_id": 12345,
"chat": {"id": 123456789},
"date": 1699564800,
"text": "Hello! This is a message from my workflow."
}
```
### Example 2: Message to Channel with HTML Formatting
**Input:**
```
chat_id: "@my_channel"
text: "Important Update: The system is running normally."
parse_mode: "HTML"
```
**Output:**
```
success: true
sent_message: {
"message_id": 12346,
"chat": {"id": -1001234567890},
"date": 1699564801,
"text": "Important Update: The system is running normally."
}
```
### Example 3: Silent Notification
**Input:**
```
chat_id: "987654321"
text: "Background update completed"
disable_notification: true
```
**Output:**
```
success: true
sent_message: {
"message_id": 12347,
"chat": {"id": 987654321},
"date": 1699564802,
"text": "Background update completed"
}
```
## Common Use Cases
* **Notifications**: Send automated notifications to users, teams, or channels when specific workflow events occur
* **Alert Broadcasting**: Broadcast alerts and warnings to multiple channels or user groups
* **Status Updates**: Provide real-time status updates about long-running operations
* **Approval Requests**: Send messages requesting user approval for workflow actions
* **Data Delivery**: Send processed data or reports to Telegram users
* **Event Notifications**: Notify about scheduled events, deadlines, or important milestones
* **Error Reporting**: Send error messages and troubleshooting information directly to support channels
## Error Handling
| Error Type | Cause | Solution |
| ------------------------ | ----------------------------------------------------- | -------------------------------------------------------------------------- |
| Invalid Chat ID | The chat\_id doesn't exist or bot doesn't have access | Verify the chat\_id is correct and the bot has been added to the chat |
| Message Too Long | Text exceeds 4096 characters | Split the message into multiple smaller messages or shorten the content |
| Bot Not Member | The bot hasn't been added to the group or channel | Add the bot to the target group/channel before sending messages |
| Insufficient Permissions | Bot lacks permission to send messages | Check bot permissions in the Telegram group/channel settings |
| Rate Limit Exceeded | Too many messages sent too quickly | Implement delays between messages or use the allow\_paid\_broadcast option |
| Invalid Parse Mode | Invalid formatting mode specified | Use only 'Markdown', 'MarkdownV2', or 'HTML' |
## Notes
* **Chat ID Format**: For private chats, use the numeric ID. For channels, use the @username format or the numeric ID with a minus prefix.
* **Message Length**: Messages are limited to 4096 characters. Longer content should be split into multiple messages.
* **Parse Modes**: Use HTML for simple formatting, MarkdownV2 for more complex markdown syntax, or Markdown for basic markdown support.
* **Silent Messages**: Setting disable\_notification to true sends messages without triggering sound notifications for recipients.
* **Reply Markup**: Use reply\_markup to add inline keyboards, custom keyboards, or other interactive elements to your messages.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.agenticflow.ai/reference/nodes/telegram_send_message.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.