# Telegram Official

> Send Dock notifications through Telegram's official Bot API using only Python standard library and api.telegram.org.

- **Type:** Skill
- **Install:** `agentstack add skill-uvwt-agentdock-telegram-official`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [uvwt](https://agentstack.voostack.com/s/uvwt)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [uvwt](https://github.com/uvwt)
- **Source:** https://github.com/uvwt/agentdock/tree/main/skill-sources/telegram-official
- **Website:** https://uvwt.github.io/agentdock-docs/

## Install

```sh
agentstack add skill-uvwt-agentdock-telegram-official
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Telegram Official Bot API Skill

通过 Telegram 官方 Bot API 给 Dock 发送通知。

## 能力

- `send`：发送普通文本消息。
- `event`：发送格式化的 Dock 事件通知。
- `updates`：读取精简后的 `getUpdates` 输出，用于发现 `chat_id`。
- `health`：调用 `getMe` 验证 token 和官方 API 连通性。

## 安全

- 只访问 `https://api.telegram.org`。
- 不登录 Telegram 个人号，不读取用户私聊历史。
- 不依赖第三方 Telegram SDK、MCP server 或代理服务。
- 不接受 token 作为 action input 或 CLI 参数。
- token 只从 `TELEGRAM_BOT_TOKEN` / `TG_BOT_TOKEN` / `.env` 读取。

## 辅助脚本执行

Skill 本体是本说明文档。确需调用包内辅助脚本时，在 Skill 包根目录使用相对路径执行；运行宿主负责切换到包根目录并把所需变量注入当前子进程。

```bash
printf '%s' '{"skill_action":""}' | python3 run.py
```

输入必须是 JSON 对象。写操作仍按本文档中的确认规则执行。

| 动作 | 用途 |
|---|---|
| `send` | Send a text message to the configured Telegram chat. |
| `event` | Send a formatted Dock event notification. |
| `updates` | Read compact getUpdates output to discover chat ids. |
| `health` | Call getMe to verify token and official Bot API connectivity. |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [uvwt](https://github.com/uvwt)
- **Source:** [uvwt/agentdock](https://github.com/uvwt/agentdock)
- **License:** Apache-2.0
- **Homepage:** https://uvwt.github.io/agentdock-docs/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-uvwt-agentdock-telegram-official
- Seller: https://agentstack.voostack.com/s/uvwt
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.