Linear 통합은 AI 기반 챗봇에 강력한 프로젝트 관리 기능을 제공합니다. Botpress 을 최신 이슈 추적 및 워크플로 관리 도구인 Linear 과 원활하게 연결하세요. 이 통합을 통해 챗봇 내에서 바로 작업 생성을 자동화하고, 진행 상황을 추적하고, 프로젝트에서 협업할 수 있습니다. 챗봇이 Linear 이슈를 생성, 업데이트 및 검색하고, 팀원에게 작업을 할당하고, 마감일을 추적하는 등의 작업을 수행할 수 있도록 역량을 강화하세요. Botpress 용 Linear 통합으로 프로젝트 관리 프로세스를 간소화하고 팀 생산성을 향상하세요. ## 버전 `0.x`에서 `1.x`로 마이그레이션하기 Linear 통합의 `1.0` 버전에서는 이제 사용자가 webhook 서명 비밀번호를 제공해야 합니다. OAuth 인증을 사용하는 경우 이 변경사항의 영향을 받지 않습니다. API 키를 사용하여 Linear 로 인증하는 경우 Botpress 과 Linear 간의 안전한 통신을 위해 webhook 서명 비밀을 제공해야 합니다. webhook 서명 비밀번호를 얻으려면 아래의 _API 키로 수동 구성하기_ 섹션의 지침을 따르세요. ## 구성 ### OAuth를 사용한 자동 구성(권장) 가장 간단하게 연동 서비스를 설정할 수 있는 방법입니다. OAuth를 사용하여 Linear 연동을 설정하려면 인증 버튼을 클릭하고 안내에 따라 Botpress 챗봇을 Linear 에 연결하세요. 이 방법은 구성 프로세스를 간소화하고 챗봇과 Linear 간의 안전한 통신을 보장하므로 권장됩니다. 이 구성 모드를 사용하는 경우 Botpress-관리되는 Linear 애플리케이션이 Linear 워크스페이스에 연결되는 데 사용됩니다. 이 애플리케이션은 사용자를 대신하여 이슈, 댓글을 관리하고 작업을 수행하는 데 필요한 권한을 갖습니다. 권한을 보다 세밀하게 제어해야 하는 경우 수동 구성 모드를 대신 선택할 수 있습니다. ### API 키를 사용한 수동 구성 연동을 수동으로 구성하려면 API 키를 제공하여 개인 Linear 계정을 Botpress 에 연결할 수 있습니다. API 키를 사용하면 봇이 수행하는 작업은 개인 Linear 계정으로 귀속된다는 점에 유의하세요. 작업이 개인 계정이 아닌 조직에 귀속되도록 하려면 OAuth 인증을 사용해야 합니다. OAuth 인증은 API 키에 비해 많은 이점을 제공하며 Linear 조직 내에서 자리를 차지하지 않습니다. 개인 API 키를 사용하여 Linear 연동 서비스를 설정하려면 다음 단계를 따르세요: ### Linear API 키 만들기 1. Linear 에서 계정 설정으로 이동한 후 탐색 사이드바에서 API 탭을 선택합니다. 2. 2. _개인 API 키_에서 API 키의 이름을 입력하고 _새 API 키 만들기_ 버튼을 클릭합니다. 3. 3. 이 API 키를 안전한 위치에 저장합니다. Botpress 에서 Linear 연동을 구성하는 데 필요합니다. ### Linear webhook 이벤트 구독하기 1. Botpress 에서 Linear 에 대한 연동 구성 페이지로 이동합니다. 2. Botpress 에서 생성한 webhook URL을 복사합니다. 3. Linear 에서 계정 설정으로 이동하여 탐색 사이드바에서 API 탭을 선택합니다. 4. 웹훅_에서 _새로 만들기 webhook_ 버튼을 클릭합니다. 5. webhook 의 이름을 입력하고 Botpress 에서 생성한 webhook URL을 _URL_ 필드에 붙여넣습니다. 6. webhook 서명 비밀번호를 안전한 위치에 복사합니다. Botpress 에서 Linear 연동을 구성하는 데 필요합니다. 7. 데이터 변경 이벤트_에서 구독하려는 이벤트를 선택합니다: - 이슈`를 선택합니다: 이슈가 생성, 업데이트 또는 삭제될 때 알림을 받습니다. - 댓글`: 이슈에 댓글이 추가될 때 알림을 받습니다. 8. 팀_에서 알림을 받고자 하는 팀을 선택합니다. 9. webhook _ 만들기 버튼을 클릭하여 변경 사항을 저장합니다. ### Linear 연동 구성하기 Botpress 1. Botpress 에서 Linear 에 대한 연동 설정 페이지로 이동합니다. 2. API 키로 Linear 구성_ 옵션을 선택합니다. 3. Linear 에서 받은 API 키를 _API 키_ 필드에 입력합니다. 4. Linear 에서 받은 webhook 서명 비밀번호를 _웹훅 서명 비밀번호_ 필드에 입력합니다. 5. 구성을 저장하고 연동을 활성화합니다. 6. Botpress 에서 생성한 webhook URL을 복사합니다. ## 제한 사항 표준 Linear API 제한 사항은 Botpress 의 Linear 통합에 적용됩니다. 이러한 제한에는 속도 제한, 페이로드 크기 제한 및 Linear 플랫폼에서 부과하는 기타 제약 조건이 포함됩니다. 봇이 이러한 제한 사항을 준수하여 최적의 성능과 안정성을 유지할 수 있도록 하세요. 자세한 내용은 [Linear API 문서](https://developers.linear.app/docs/graphql/working-with-the-graphql-api/rate-limiting)에서 확인할 수 있습니다.
