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 集成,你必须:

  1. 创建 Telegram 机器人
  2. 配置 Telegram 机器人
  3. 在 GitLab 中设置 Telegram 集成

创建 Telegram 机器人

要在 Telegram 中创建机器人:

  1. @BotFather 开始新聊天。
  2. 按照 Telegram 文档中的说明 创建新机器人

创建机器人时,BotFather 会为你提供一个 API token。请妥善保管此 token,因为你在 Telegram 中验证机器人时需要它。

配置 Telegram 机器人

要在 Telegram 中配置机器人:

  1. 将机器人添加为新频道或现有频道的管理员。
  2. 为机器人分配 Post Messages 权限以接收事件。
  3. 为频道创建标识符。
    • 对于公开频道,输入公开链接并复制频道标识符(例如,https:/t.me/MY_IDENTIFIER)。
    • 对于私有频道,使用你的 API token 和 getUpdates 方法,并复制频道标识符(例如,-2241293890657)。

在 GitLab 中设置 Telegram 集成

邀请机器人加入 Telegram 频道后,你可以配置 GitLab 发送通知:

  1. 启用集成:
    • 对于你的群组或项目
      1. 在左侧边栏,选择 搜索或跳转至 并找到你的项目或群组。
      2. 选择 设置 > 集成
    • 对于你的实例
      1. 在左侧边栏底部,选择 管理员
      2. 选择 设置 > 集成
  2. 选择 Telegram
  3. 启用集成 下,勾选 激活 复选框。
  4. 可选。在 主机名 中,输入你的 本地机器人 API 服务器 的主机名。
  5. Token 中,粘贴来自 Telegram 机器人的 token 值
  6. 触发器 部分,勾选你希望在 Telegram 中接收的 GitLab 事件的复选框。
  7. 通知设置 部分:
    • 频道标识符 中,粘贴 Telegram 频道标识符
    • 可选。在 消息线程 ID 中,粘贴目标消息线程的唯一标识符(论坛超级群组中的主题)。
    • 可选。勾选 仅通知失败的流水线 复选框,以仅接收失败流水线的通知。
    • 可选。从 发送通知的分支 下拉列表中,选择你希望接收通知的分支。
  8. 可选。选择 测试设置
  9. 选择 保存更改

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