Linear

  Các Linear tích hợp mang lại khả năng quản lý dự án mạnh mẽ cho chatbot hỗ trợ AI của bạn. Kết nối liền mạch Botpress với Linear , một công cụ theo dõi vấn đề và quản lý quy trình làm việc hiện đại. Với sự tích hợp này, bạn có thể tự động hóa việc tạo tác vụ, theo dõi tiến độ và cộng tác vào các dự án trực tiếp trong chatbot của mình. Trao quyền cho chatbot của bạn để tạo, cập nhật và truy xuất Linear vấn đề, phân công nhiệm vụ cho các thành viên trong nhóm, theo dõi ngày đến hạn và nhiều hơn nữa. Hợp lý hóa quy trình quản lý dự án của bạn và nâng cao năng suất của nhóm với Linear Tích hợp cho Botpress . ## Di chuyển từ phiên bản `0.x` sang `1.x` Phiên bản `1.0` của Linear tích hợp hiện nay yêu cầu người dùng cung cấp webhook ký bí mật. Nếu bạn sử dụng xác thực OAuth, bạn không bị ảnh hưởng bởi thay đổi này. Nếu bạn sử dụng khóa API để xác thực với Linear , bạn phải cung cấp một webhook ký bí mật để đảm bảo giao tiếp an toàn giữa Botpress Và Linear . Để có được webhook ký bí mật, hãy làm theo hướng dẫn trong phần _Cấu hình thủ công với khóa API_ bên dưới. ## Cấu hình ### Cấu hình tự động với OAuth (khuyến nghị) Đây là cách đơn giản nhất để thiết lập tích hợp. Để thiết lập Linear tích hợp sử dụng OAuth, nhấp vào nút ủy quyền và làm theo hướng dẫn để kết nối Botpress chatbot để Linear . Phương pháp này được khuyến nghị vì nó đơn giản hóa quá trình cấu hình và đảm bảo giao tiếp an toàn giữa chatbot của bạn và Linear . Khi sử dụng chế độ cấu hình này, một Botpress -được quản lý Linear ứng dụng sẽ được sử dụng để kết nối với bạn Linear không gian làm việc. Ứng dụng sẽ có các quyền cần thiết để quản lý các vấn đề, bình luận và thực hiện các hoạt động thay mặt cho người dùng của bạn. Nếu bạn cần kiểm soát chi tiết hơn đối với các quyền, bạn có thể chọn chế độ cấu hình thủ công thay thế. ### Cấu hình thủ công bằng khóa API Nếu bạn muốn cấu hình tích hợp thủ công, bạn có thể cung cấp khóa API để kết nối cá nhân của bạn Linear tài khoản để Botpress . Hãy nhớ rằng khi bạn sử dụng khóa API, các hành động do bot thực hiện sẽ được quy cho thông tin cá nhân của bạn Linear tài khoản. Nếu bạn muốn các hành động được quy cho tổ chức của bạn thay vì tài khoản cá nhân của bạn, bạn phải sử dụng xác thực OAuth. Xác thực OAuth cung cấp nhiều lợi thế hơn so với khóa API và không chiếm chỗ trong Linear tổ chức. Để thiết lập Linear tích hợp bằng cách sử dụng khóa API cá nhân, hãy làm theo các bước sau: ### Tạo Linear Khóa API 1. Trên Linear , điều hướng đến cài đặt tài khoản của bạn và chọn tab API trong thanh bên điều hướng. 2. Trong _Khóa API cá nhân_, nhập tên cho khóa API của bạn và nhấp vào nút _Tạo khóa API mới_. 3. Lưu khóa API này ở một vị trí an toàn. Bạn sẽ cần khóa này để cấu hình Linear tích hợp trong Botpress . ### Đăng ký Linear webhook sự kiện 1. Trong Botpress , điều hướng đến trang cấu hình tích hợp cho Linear . 2. Sao chép webhook URL được tạo bởi Botpress . 3. Trên Linear , điều hướng đến cài đặt tài khoản của bạn và chọn tab API trong thanh bên điều hướng. 4. Trong _Webhooks_, nhấp vào _Tạo mới webhook _ nút. 5. Nhập tên cho webhook và dán webhook URL được tạo bởi Botpress trong trường _URL_. 6. Sao chép webhook ký bí mật ở một vị trí an toàn. Bạn sẽ cần nó để cấu hình Linear tích hợp trong Botpress . 7. Trong _Sự kiện thay đổi dữ liệu_, hãy chọn các sự kiện bạn muốn đăng ký: - `Sự cố`: Nhận thông báo khi sự cố được tạo, cập nhật hoặc xóa. - `Bình luận`: Nhận thông báo khi bình luận được thêm vào sự cố. 8. Trong _Nhóm_, hãy chọn các nhóm bạn muốn nhận thông báo. 9. Nhấp vào _Tạo webhook _ nút để lưu các thay đổi của bạn. ### Cấu hình Linear tích hợp trong Botpress
1. Trong Botpress , điều hướng đến trang cấu hình tích hợp cho Linear . 2. Chọn _Configure Linear với tùy chọn API Key_. 3. Nhập khóa API bạn lấy được từ Linear trong trường _API Key_. 4. Nhập webhook ký bí mật bạn đã lấy được từ Linear trong trường _Webhook Signing Secret_. 5. Lưu cấu hình và kích hoạt tích hợp. 6. Sao chép webhook URL được tạo bởi Botpress . ## Tiêu chuẩn hạn chế Linear Các giới hạn của API áp dụng cho Linear tích hợp trong Botpress . Những hạn chế này bao gồm giới hạn tốc độ, hạn chế kích thước tải trọng và các hạn chế khác do Linear nền tảng. Đảm bảo rằng bot của bạn tuân thủ các giới hạn này để duy trì hiệu suất và độ tin cậy tối ưu. Chi tiết hơn có sẵn trong [ Linear Tài liệu API](https://developers.linear.app/docs/graphql/working-with-the-graphql-api/rate-limiting).