Help us learn about your current experience with the documentation. Take the survey.
Telegram
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
你可以配置 GitLab,使其向 Telegram 聊天或频道发送通知。 要设置 Telegram 集成,你必须:
创建 Telegram 机器人
要在 Telegram 中创建机器人:
- 与
@BotFather开始新聊天。 - 按照 Telegram 文档中的说明 创建新机器人。
创建机器人时,BotFather 会为你提供一个 API token。请妥善保管此 token,因为你在 Telegram 中验证机器人时需要它。
配置 Telegram 机器人
要在 Telegram 中配置机器人:
- 将机器人添加为新频道或现有频道的管理员。
- 为机器人分配
Post Messages权限以接收事件。 - 为频道创建标识符。
- 对于公开频道,输入公开链接并复制频道标识符(例如,
https:/t.me/MY_IDENTIFIER)。 - 对于私有频道,使用你的 API token 和
getUpdates方法,并复制频道标识符(例如,-2241293890657)。
- 对于公开频道,输入公开链接并复制频道标识符(例如,
在 GitLab 中设置 Telegram 集成
邀请机器人加入 Telegram 频道后,你可以配置 GitLab 发送通知:
- 启用集成:
- 对于你的群组或项目:
- 在左侧边栏,选择 搜索或跳转至 并找到你的项目或群组。
- 选择 设置 > 集成。
- 对于你的实例:
- 在左侧边栏底部,选择 管理员。
- 选择 设置 > 集成。
- 对于你的群组或项目:
- 选择 Telegram。
- 在 启用集成 下,勾选 激活 复选框。
- 可选。在 主机名 中,输入你的 本地机器人 API 服务器 的主机名。
- 在 Token 中,粘贴来自 Telegram 机器人的 token 值。
- 在 触发器 部分,勾选你希望在 Telegram 中接收的 GitLab 事件的复选框。
- 在 通知设置 部分:
- 在 频道标识符 中,粘贴 Telegram 频道标识符。
- 可选。在 消息线程 ID 中,粘贴目标消息线程的唯一标识符(论坛超级群组中的主题)。
- 可选。勾选 仅通知失败的流水线 复选框,以仅接收失败流水线的通知。
- 可选。从 发送通知的分支 下拉列表中,选择你希望接收通知的分支。
- 可选。选择 测试设置。
- 选择 保存更改。
Telegram 频道现在可以接收所有选定的 GitLab 事件。