Linear

  Linear 集成为您的人工智能聊天机器人带来强大的项目管理功能。将Botpress 与现代问题跟踪和工作流管理工具Linear 无缝连接。通过该集成，您可以在聊天机器人中自动创建任务、跟踪进度并直接进行项目协作。让您的聊天机器人能够创建、更新和检索Linear 问题，为团队成员分配任务，跟踪到期日期等。使用Linear Integration forBotpress 简化您的项目管理流程并提高团队生产力。

## 从版本 `0.x` 迁移到 `1.x

Linear 整合的 `1.0` 版本现在要求用户提供webhook 签名密钥。如果使用 OAuth 身份验证，则不会受此变更的影响。如果使用 API 密钥与Linear 进行身份验证，则必须提供webhook 签名密文，以确保Botpress 和Linear 之间的通信安全。要获取webhook 签名密文，请按照下文_使用 API 密钥进行手动配置_部分中的说明进行操作。

## 配置

### 使用 OAuth 自动配置（推荐）

这是最简单的集成设置方法。要使用 OAuth 设置Linear 整合，请单击授权按钮并按照说明将Botpress 聊天机器人连接到Linear 。推荐使用此方法，因为它简化了配置过程，并确保聊天机器人与Linear 之间的安全通信。

使用这种配置模式时，将使用Botpress 管理的Linear 应用程序连接到Linear 工作区。该应用程序将拥有管理问题、评论和代表用户执行操作的必要权限。如果您需要对权限进行更精细的控制，可以选择手动配置模式。

### 使用 API 密钥手动配置

如果您希望手动配置集成，可以提供一个 API 密钥，将您的个人Linear 账户连接到Botpress 。请注意，使用 API 密钥时，机器人的操作将归属于您的个人Linear 账户。如果您希望将操作归属于您的组织而不是个人账户，则必须使用 OAuth 身份验证。与 API 密钥相比，OAuth 身份验证具有很多优势，而且不会占用Linear 组织的席位。

要使用个人 API 密钥设置Linear 集成，请按照以下步骤操作：

### 创建Linear API 密钥

1.在Linear 上，导航至账户设置并选择导航侧栏中的 API 选项卡。
2.在_个人 API 密钥_下，输入 API 密钥的名称，然后单击_创建新 API 密钥_按钮。
3.3. 将此 API 密钥保存在安全位置。在Botpress 中配置Linear 集成时将需要该密钥。

### 订阅Linear webhook  事件

1.在Botpress 中，导航至Linear 的集成配置页面。
2.2. 复制由Botpress 生成的webhook URL。
3.3. 在Linear 上，导航至账户设置并选择导航侧栏中的 API 选项卡。
4.4. 在 _Webhooks_ 下，单击 _Create newwebhook_ 按钮。
5.5. 为webhook 输入名称，并在 _URL_ 字段中粘贴Botpress 生成的webhook URL。
6.将webhook 签名密文复制到安全位置。在Botpress 中配置Linear 集成时将需要它。
7.7. 在 _Data change events_ 下，选择希望订阅的事件：

- 问题当创建、更新或删除问题时接收通知。
- 评论问题添加评论时接收通知。

8.在 _Teams_ 下，选择希望接收通知的团队。
9.单击 _Createwebhook_ 按钮保存更改。

### 配置Linear 中的集成 1.Botpress

1.在Botpress 中，导航到Linear 的集成配置页面。
2.2. 选择 _ConfigureLinear with an API Key_ 选项。
3.3. 在 _API Key_ 字段中输入从Linear 获取的 API 密钥。
4.4. 在 _Webhook Signing Secret_ 字段中输入从Linear 获取的webhook 签名密钥。
5.5. 保存配置并启用集成。
6.6. 复制由Botpress 生成的webhook URL。

## 限制

标准的Linear API 限制适用于Botpress 中的Linear 集成。这些限制包括速率限制、有效载荷大小限制以及Linear 平台施加的其他限制。请确保您的机器人遵守这些限制，以保持最佳性能和可靠性。

更多详细信息，请参阅[Linear API 文档](https://developers.linear.app/docs/graphql/working-with-the-graphql-api/rate-limiting)。