# Telegram

将 Telegram 机器人连接到项目，并设置哪些人可以向它发送任务。

Canonical page: https://beeuni.ai/docs/zh/connect/telegram

连接 Telegram 后，你可以在与机器人的聊天中给项目的智能体安排任务。回复会发回同一聊天，完整会话记录也可以在 Beeuni 中查看。

## 连接机器人

1. 在 Telegram 中打开 **@BotFather**，通过 `/newbot` 创建机器人，复制它的 Token。
2. 打开项目的**频道**页面，找到 **Telegram**，填入 Token 并连接。
3. 在 Telegram 中向机器人发送 `/start`。如果你的账号尚未获准使用，回复中会显示你的数字用户 ID。
4. 在 Beeuni 中把该 ID 加入允许使用的用户列表并保存，然后向机器人发送任务。

允许列表为空时，任何人都不能运行任务。连接机器人或修改列表需要管理项目连接器的权限。Token 保存在服务端，不会随安装信息返回，也不会传给智能体。

## 会话与访问权限

聊天中的第一条任务会创建会话，后续消息继续使用它。论坛群组的每个话题分别对应一个会话。发送 `/new` 后，下一条消息会创建新会话，原有记录仍保留在 Beeuni 中。

获准使用机器人的 Telegram 用户会以项目的自动化身份启动任务，创建的会话对项目可见。这不等于每位发送者分别登录自己的 Beeuni 账号。请只添加可以使用项目共享权限运行任务的人。

不再需要通过该机器人接收任务时，在频道页面断开连接即可。

## SDK

SDK 提供 `getTelegramInstallation`、`connectTelegram`、`setTelegramAllowedUsers` 和 `disconnectTelegram`，调用时传入项目 ID。访问令牌设置见 [SDK 身份验证](/docs/zh/sdk/auth)。