通过 GitLab 助手连接飞书与 GitLab 项目，在飞书中第一时间获取相关的开发动态，让跟踪管理、沟通交流更顺畅。

一、功能简介

1. 关于 GitLab

GitLab 是一款基于 Git 搭建的软件开发平台，更多详情可参阅 GitLab 官方文档。

GitLab 助手使你无需离开飞书，即可实现以下操作：

•通过在群聊中添加 GitLab 机器人，实时接收来自 GitLab 相关项目的更新消息，包括新评论通知、issue 动态以及 merge request 通知等

1.1 在飞书桌面端中打开相关群聊，添加 GitLab 助手 机器人进群（详细步骤可见如何在群聊中使用机器人）。

1.2 在群内 @ 该机器人并发送指令 @GitLab助手 get_webhook ，以获取该群 webhook 地址。

机器人将向该群的群主私信发送 webhook 地址。如果此群已有 webhook 地址，则会发送已有的地址。如果你不是该群的群主，请联系群主获取地址。

注：你还可以向 GitLab 机器人发送以下指令

1.3 前往 GitLab ，进入相关项目，在侧边栏中选择 Settings > Webhooks。填写 webhook 地址 (URL) 并勾选相关触发事件 (Trigger)。

注：目前 Gitlab 助手仅支持推送新评论提醒 (Comments)，issue动态 (Issues events)，merge request动态 (Merge request events)的通知。

1.4 完成上述步骤后，测试配置是否成功。在 GitLab 触发任意你已勾选的事件，如在飞书的对应群聊中收到了 GitLab 机器人推送的通知消息，则配置成功。

至此，你和项目成员们就可以在飞书群聊中实时接收项目更新消息了！点击卡片上的查看按钮，即可在电脑上打开打开你的 GitLab 查看详情

备注：如果希望在手机上也能点击 查看 按钮浏览项目详情，请继续阅读下一章节，完成 GitLab 助手的移动端小程序配置。

GitLab 助手还提供了移动端小程序的能力。将你的个人 GitLab 帐号与 GitLab 助手绑定，即可在飞书移动端内快速查看你的 pull request 与 issue 列表，还可进入详情页并直接添加评论。

2.1 前提

你的飞书团队管理员须在 GitLab 助手的管理后台配置企业内部 GitLab 地址。操作步骤如下：

•点击编辑进入编辑页面，进行系统地址配置。如果你使用的是 Gitlab 的 SaaS 版本，只需输入 https://gitlab.com即可；如果是私有化的部署，则输入私有化部署的域名

如果想测试上述地址是否输入正确，可以在浏览器中输入此地址并加上后缀 /api/v4/projects （例如： https://gitlab.com/api/v4/projects），确认页面可正确打开

2.2 使用移动端小程序

管理员完成上述配置后，你可通过以下步骤登录并使用 GitLab 移动端小程序。

2.2.1 获取 GitLab access token

•进入 Access Tokens 板块，给你的 token 命名，按需勾选 webhook 的 Scopes ，然后点击 Create personal access token 完成创建

2.2.2 回到飞书中，将你的 GitLab 帐号与 GitLab 助手绑定

@GitLab助手 set_access_token {username} {access_token}

注：{username} 为你的 GitLab 帐号的 Email 前缀；{access_token} 即前一步中在 GitLab 获取的 access token

2.2.3 至此，你就可以在飞书移动端上查看 GitLab 更新消息的详情了

当你在相关的群聊中收到 GitLab 助手推送的项目的消息卡片时，点击查看按钮，即可进入 GitLab 助手的小程序查看 pull request 或 issue 详情，还可进行简单的评论。

2.2.4 你还可在 GitLab 助手小程序中，查看所有你关心的项目的 pull request 和 issues 列表

在 GitLab 助手的看板中，Pull Request 和 Issues 标签页分别展示你所关注的项目的 pull request 和 issues 列表，点击某一项即可查看详情、并发送评论。

要使某一项目出现在小程序的首页列表中，先在相关群聊中找到与该项目相关的任一通知卡片，点击查看在移动端小程序打开详情页。此后，你就可在小程序中查看该项目下最新的 pull request 和 issue 列表了。

在底部导航栏中点击个人，进入个人设置页查看个人信息或随时退出个人账号登录。