Telegram

版本历史

• 在 极狐GitLab 16.1 引入。

您可以配置极狐GitLab 向 Telegram 聊天或频道发送通知。 要设置 Telegram 集成，您必须：

1. 创建一个 Telegram 机器人。
2. 配置 Telegram 机器人。
3. 在极狐GitLab 中设置 Telegram 集成。

创建 Telegram 机器人#

要在 Telegram 中创建机器人：

1. 与 @BotFather 开始新聊天。
2. 按照 Telegram 文档中所述创建一个新机器人。

当您创建机器人时，BotFather 会为您提供一个 API 令牌。请保管好此令牌，因为您需要用它在 Telegram 中验证机器人。

配置 Telegram 机器人#

要在 Telegram 中配置机器人：

1. 将机器人作为管理员添加到新的或现有的频道。
2. 为机器人分配 Post Messages 权限以接收事件。
3. 为频道创建一个标识符。
   • 对于公共频道，输入一个公共链接并复制频道标识符（例如 https:/t.me/MY_IDENTIFIER）。
   • 对于私有频道，使用 API 令牌调用 getUpdates 方法并复制频道标识符（例如 -2241293890657）。

在极狐GitLab 中设置 Telegram 集成#

版本历史

• 消息线程 ID 在 极狐GitLab 16.11 引入。
• 主机名 在 极狐GitLab 17.1 引入。

先决条件：

• 用于实例启用的管理员访问权限。
• 用于群组启用的所有者角色。
• 用于项目启用的维护者或所有者角色。

将机器人邀请到 Telegram 频道后，您可以配置极狐GitLab 发送通知：

1. 要启用集成：
   • 对于您的群组或项目：
     1. 在顶部栏中，选择 搜索或跳转到 并找到您的项目或群组。
     2. 选择 设置 > 集成。
   • 对于您的实例：
     1. 在右上角，选择 管理员。
     2. 选择 设置 > 集成。
2. 选择 Telegram。
3. 在 启用集成 下，选中 活跃 复选框。
4. 可选。在 主机名 中，输入您的本地 Bot API 服务器的主机名。
5. 在 令牌 中，粘贴从 Telegram 机器人获取的令牌值。
6. 在 触发器 部分，选中您希望在 Telegram 中接收的极狐GitLab 事件的复选框。
7. 在 通知设置 部分：
   • 在 频道标识符 中，粘贴 Telegram 频道标识符。
   • 可选。在 消息线程 ID 中，粘贴目标消息线程（论坛超级群组中的话题）的唯一标识符。
   • 可选。选中 仅通知损坏的流水线 复选框，以仅接收失败流水线的通知。
   • 可选。选中 仅当状态变化时通知 复选框，以仅当引用的流水线状态变化时接收通知。
   • 可选。从 要发送通知的分支 下拉列表中，选择您希望接收通知的分支。
8. 可选。选择 测试设置。
9. 选择 保存更改。

现在，Telegram 频道可以接收所有选定的极狐GitLab 事件。