Todoist

  챗봇을 Todoist와 통합하여 작업을 생성 및 수정하고, 댓글을 게시하는 등의 작업을 수행할 수 있습니다.

## 버전 `0.x`에서 `1.x`로 마이그레이션 중입니다.

버전 `0.x`에서 `1.x`로 마이그레이션하는 경우 다음과 같은 주요 변경 사항에 유의하세요:

> "작업 만들기" 작업이 "새 작업 만들기" 작업으로 대체되었습니다.

## 구성

### OAuth로 자동 구성

OAuth를 사용하여 Todoist 연동을 설정하려면 인증 버튼을 클릭하고 화면의 안내에 따라 Botpress 챗봇을 Todoist에 연결하세요.

OAuth로 봇을 구성할 때 사용자 계정으로 로그인하거나 봇을 위해 특별히 만든 사용자 계정으로 로그인할 수 있습니다.
사용자 계정으로 로그인하면 봇의 작업과 댓글이 사용자 계정으로 표시된다는 점에 유의하세요.
대부분의 사용 사례에서는 봇 전용 사용자 계정을 만드는 것이 좋습니다. 봇이 댓글을 게시하고 작업을 수행하려면 봇의 사용자를 공유 프로젝트에 초대해야 합니다.

### 개인 API 토큰을 사용하여 수동 구성하기

1. Todoist 앱 생성
   - 앱 관리 페이지](https://developer.todoist.com/appconsole.html)에서 앱을 생성합니다.
   - 앱 관리 페이지에서 사용자의 개인 API 토큰을 복사하거나 테스트 토큰을 생성합니다.
2. Todoist Botpress 연동 설정
   - Botpress 봇에 Todoist 연동을 설치합니다.
   - 앞서 복사한 API 토큰을 구성 필드에 붙여넣습니다. 이 토큰은 봇이 댓글을 게시하고, 작업을 업데이트하거나 생성하는 등의 작업을 수행하는 데 사용할 토큰입니다.
   - 구성을 저장합니다.
   - 봇의 Webhook URL을 복사합니다.
3. Todoist 앱 Webhook 구성
   - Todoist에서 앱의 앱 관리 페이지로 이동합니다.
   - 웹훅 이벤트가 활성화되어 있는지 확인합니다. 이를 위해 Todoist에서 제공하는 [이 지침](https://developer.todoist.com/sync/v9/#webhooks)을 따르세요.
   - 앞서 복사한 Webhook URL을 _웹훅 콜백 URL_ 필드에 붙여넣습니다.
   - 다음 _감시한 이벤트_를 확인합니다:
     - item:추가된_;
     - item:updated_;
     - item:completed_;
     - 참고:추가됨_.
   - Webhook 구성을 저장합니다.

## 제한 사항

표준 Todoist API 제한 사항은 Botpress 의 Todoist 통합에 적용됩니다. 이러한 제한에는 속도 제한, 페이로드 크기 제한 및 Todoist에서 부과하는 기타 제약이 포함됩니다. 챗봇이 이러한 제한 사항을 준수하여 최적의 성능과 안정성을 유지할 수 있도록 하세요.

자세한 내용은 [Todoist 개발자 문서](https://developer.todoist.com/rest/v2/#request-limits)에서 확인할 수 있습니다.