Telegram Bot API integration for automated messaging and chat management in Axellero workflows.

Telegram Node

Send messages, manage chats, and handle bot interactions through the Telegram Bot API in Axellero workflows.

Available Operations

Send: Send text messages to chats
Receive: Get updates and messages via long polling
Manage: Delete and edit existing messages
Actions: Show typing indicators and chat actions

Connection Configuration

Parameter	Type	Required	Description
`token`	TEXT	Yes	Bot token obtained from @BotFather
`chatId`	TEXT	Yes	Default chat ID for operations (can be overridden per method)

{
  "token": "{{ctx.consts.TELEGRAM_BOT_TOKEN}}",
  "chatId": "{{ctx.vars.chatId}}"
}

Operations

sendMessage

Send text messages to Telegram chats.

Parameter	Type	Required	Description
`message`	TEXT	Yes	Text content of the message to send

{
  "message": "Hello! Your order #{{ctx.vars.orderNumber}} has been processed."
}

getUpdates

Retrieve pending updates from Telegram Bot API using long polling.

Parameter	Type	Required	Description
`offset`	INT	No	Identifier of the first update to return
`limit`	INT	No	Maximum number of updates to retrieve (1-100)
`timeout`	INT	No	Long polling timeout in seconds (0-90)

{
  "offset": 0,
  "limit": 10,
  "timeout": 30
}

deleteMessage

Remove messages from Telegram chats.

Parameter	Type	Required	Description
`messageId`	INT	Yes	Unique identifier of the message to delete

{
  "messageId": 123
}

editMessageText

Modify text content of existing messages in Telegram chats.

Parameter	Type	Required	Description
`messageId`	INT	Yes	Unique identifier of the message to edit
`text`	TEXT	Yes	New text content for the message

{
  "messageId": 123,
  "text": "Updated: Your order status has changed to 'shipped'."
}

sendChatAction

Show typing indicators and other chat actions to users.

Parameter	Type	Required	Description
`action`	TEXT	Yes	Action type: typing, upload_photo, record_video, upload_video, record_voice, upload_voice, upload_document, choose_sticker, find_location, record_video_note, upload_video_note

{
  "action": "typing"
}

Workflow Integration

Use workflow context to construct dynamic message content:

{
  "message": "Hello {{ctx.user.name}}! Your order #{{ctx.vars.orderNumber}} for {{ctx.vars.productName}} has been confirmed. Total: ${{ctx.vars.totalAmount}}"
}

Bot Setup

Create Bot: Message @BotFather on Telegram
Get Token: Use /newbot command and follow instructions to get your bot token
Find Chat ID: Add your bot to a chat and use getUpdates to find the chat ID
Configure: Set up the connector with your bot token and target chat ID

Response Format

Success Response

{
  "success": true,
  "messageId": 456,
  "chatId": "-1001234567890"
}

Error Response

{
  "success": false,
  "error": "Bot was blocked by the user"
}

Use Cases

Customer notifications: Send order updates and delivery notifications
Alert systems: Notify users about important events and system status
Interactive bots: Build conversational interfaces for customer support
Monitoring: Send system alerts and monitoring notifications to operation teams

Telegram

On this page