github/sim
1
1
Fork 0
mirror of https://github.com/simstudioai/sim.git synced 2026-04-28 03:00:29 -04:00
Code Issues Packages Projects Releases Wiki Activity

feat(telegram): added additional telegram tools & docs (#1625)

Browse Source 
* feat(telegram): added delete message,send photo-video-audio-animation tools

* fix: updated Telegram tool types and removed debug logs

* reverted telegram message tool to older name

* added docs for telegram

* updated telegram docs

---------

Co-authored-by: SimplyRohit <rohitjaatjaat073@gmail.com>
This commit is contained in:
Waleed
2025-10-14 15:34:41 -07:00
committed by GitHub
parent 6f3df271fd
commit f147eaee1c
12 changed files with 1550 additions and 50 deletions
Download Patch File Download Diff File Expand all files Collapse all files

103
apps/docs/content/docs/en/tools/telegram.mdx
View File

@@ -1,6 +1,6 @@
---
title: Telegram
description: Send messages through Telegram or trigger workflows from Telegram events
description: Interact with Telegram
---
import { BlockInfoCard } from "@/components/ui/block-info-card"
@@ -67,7 +67,7 @@ In Sim, the Telegram integration enables your agents to leverage these powerful
## Usage Instructions
Integrate Telegram into the workflow. Can send messages. Can be used in trigger mode to trigger a workflow when a message is sent to a chat.
Integrate Telegram into the workflow. Can send and delete messages. Can be used in trigger mode to trigger a workflow when a message is sent to a chat.
@@ -96,6 +96,105 @@ Send messages to Telegram channels or users through the Telegram Bot API. Enable
| `timestamp` | number | Unix timestamp when message was sent |
| `from` | object | Information about the bot that sent the 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.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Yes | Your Telegram Bot API Token |
| `chatId` | string | Yes | Target Telegram chat ID |
| `messageId` | string | Yes | Message ID to delete |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success or error message |
| `data` | object | Delete operation result |
### `telegram_send_photo`
Send photos to Telegram channels or users through the Telegram Bot API.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Yes | Your Telegram Bot API Token |
| `chatId` | string | Yes | Target Telegram chat ID |
| `photo` | string | Yes | Photo to send. Pass a file_id or HTTP URL |
| `caption` | string | No | Photo caption \(optional\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success or error message |
| `data` | object | Telegram message data including optional photo\(s\) |
### `telegram_send_video`
Send videos to Telegram channels or users through the Telegram Bot API.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Yes | Your Telegram Bot API Token |
| `chatId` | string | Yes | Target Telegram chat ID |
| `video` | string | Yes | Video to send. Pass a file_id or HTTP URL |
| `caption` | string | No | Video caption \(optional\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success or error message |
| `data` | object | Telegram message data including optional media |
### `telegram_send_audio`
Send audio files to Telegram channels or users through the Telegram Bot API.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Yes | Your Telegram Bot API Token |
| `chatId` | string | Yes | Target Telegram chat ID |
| `audio` | string | Yes | Audio file to send. Pass a file_id or HTTP URL |
| `caption` | string | No | Audio caption \(optional\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success or error message |
| `data` | object | Telegram message data including voice/audio information |
### `telegram_send_animation`
Send animations (GIFs) to Telegram channels or users through the Telegram Bot API.
#### Input
| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | Yes | Your Telegram Bot API Token |
| `chatId` | string | Yes | Target Telegram chat ID |
| `animation` | string | Yes | Animation to send. Pass a file_id or HTTP URL |
| `caption` | string | No | Animation caption \(optional\) |
#### Output
| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success or error message |
| `data` | object | Telegram message data including optional media |
## Notes