這Linear 集成為您的人工智慧聊天機器人帶來了強大的專案管理功能。無縫連接Botpress 和Linear ,一種現代問題追蹤和工作流程管理工具。透過這種集成,您可以自動建立任務、追蹤進度並直接在聊天機器人中協作處理專案。使您的聊天機器人能夠創建、更新和檢索Linear 問題、向團隊成員分配任務、追蹤截止日期等等。簡化您的專案管理流程並提高團隊生產力Linear 整合用於Botpress 。 ## 從版本 `0.x` 遷移到 `1.x` 版本 `1.0` Linear 整合現在需要用戶提供webhook 簽名秘密。如果您使用 OAuth 身份驗證,則不受此變更的影響。如果您使用 API 金鑰進行驗證Linear ,您必須提供webhook 簽署秘密以確保之間的安全通信Botpress 和Linear 。為了獲得webhook 簽署金鑰,請按照下面_使用 API 金鑰進行手動配置_部分中的說明進行操作。 ## 設定 ### 使用 OAuth 自動配置(建議) 這是設定整合最簡單的方法。要設定Linear 使用 OAuth 集成,點擊授權按鈕並按照說明連接您的Botpress 聊天機器人Linear 。建議使用此方法,因為它可以簡化配置過程並確保聊天機器人和聊天機器人之間的安全通信Linear 。當使用該配置模式時, Botpress - 管理Linear 應用程式將用於連接到您的Linear 工作區。該應用程式將具有代表您的用戶管理問題、評論和執行操作所需的權限。如果您需要對權限進行更精細的控制,您可以選擇手動設定模式。 ### 使用 API 金鑰進行手動配置 如果您喜歡手動配置集成,您可以提供 API 金鑰來連接您的個人Linear 帳戶到Botpress 。請記住,當您使用 API 金鑰時,機器人執行的操作將歸因於您的個人資訊Linear 帳戶。如果您希望將操作歸因於您的組織而不是您的個人帳戶,則必須使用 OAuth 身份驗證。與 API 金鑰相比,OAuth 身份驗證具有許多優勢,並且不會佔用您的空間Linear 組織。要設定Linear 使用個人 API 金鑰進行集成,請按照以下步驟操作: ### 創建Linear API 金鑰 1. 開啟Linear ,導覽至您的帳戶設定並選擇導覽側欄中的 API 標籤。 2. 在_個人 API 金鑰_下,輸入 API 金鑰的名稱,然後按一下_建立新 API 金鑰_按鈕。 3. 將此 API 金鑰保存在安全位置。您將需要它來配置Linear 融入Botpress 。 ### 訂閱Linear webhook 事件 1. 在Botpress ,導航至整合設定頁面Linear 。 2. 複製webhook 產生的網址Botpress 。 3. 開啟Linear ,導覽至您的帳戶設定並選擇導覽側欄中的 API 標籤。 4. 在 _Webhooks_ 下,按一下 _新建webhook _ 按鈕。 5. 輸入名稱webhook 並貼上webhook 產生的網址Botpress 在 _URL_ 欄位中。 6. 複製webhook 在安全位置簽署秘密。您將需要它來配置Linear 融入Botpress 。 7. 在_資料變更事件_下,選擇您要訂閱的事件: - “問題”:在建立、更新或刪除問題時接收通知。 - “評論”:當評論添加到問題時接收通知。 8. 在_團隊_下,選擇您希望接收其通知的團隊。 9. 點選_創建webhook _ 按鈕儲存您的變更。 ### 配置Linear 融入Botpress 1. 在Botpress ,導航至整合設定頁面Linear 。 2. 選擇_配置Linear 帶有 API Key_ 選項。 3. 輸入您取得的API金鑰Linear 在 _API Key_ 欄位中。 4. 輸入webhook 您從以下位置獲得的簽名秘密Linear 在 _Webhook Signing Secret_ 欄位中。 5. 儲存配置並啟用整合。 6. 複製webhook 產生的網址Botpress 。 ## 限制標準Linear API 限制適用於Linear 融入Botpress 。這些限制包括速率限制、有效負載大小限制以及由Linear 平台。確保您的機器人遵守這些限制,以保持最佳性能和可靠性。更多詳細資訊可在 [ Linear API 文件](https://developers.linear.app/docs/graphql/working-with-the-graphql-api/rate-limiting)。