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 文档。
