탐색으로 건너뛰기

Todoist

웹훅 도구로 발신자 요청을 Todoist 작업으로 전환합니다.

발신자가 콜백, 견적 또는 후속 조치가 필요한 다른 사항을 요청하면 접수 담당자가 Todoist에 작업을 추가할 수 있습니다. 웹훅 도구가 Todoist API를 통해 작업을 생성합니다.

시작하기 전에

1

API 토큰 복사

Todoist에서 Settings → Integrations → Developer를 열고 API token을 복사합니다. 이 토큰으로 Todoist 계정에 완전히 접근할 수 있으므로 비밀 정보로 취급하세요.

2

프로젝트 ID 찾기

Todoist 웹 앱에서 프로젝트를 엽니다. ID는 URL의 마지막 대시 뒤에 있는 마지막 부분입니다. 예를 들어 app.todoist.com/app/project/callbacks-6Jf8VQXxpwv56VQ7에서는 6Jf8VQXxpwv56VQ7입니다. 받은편지함에 작업을 추가하려면 이 단계를 건너뛰세요.

웹훅 도구 만들기

Integrations로 이동해 Add integration을 선택한 다음 Webhook Tool을 선택합니다.

필드값
Namecreate_todoist_task
Description”발신자에게 후속 조치를 약속했거나 팀에서 처리해야 할 사항을 발신자가 요청할 때마다 팀을 위한 작업을 생성합니다.”
MethodPOST
URLhttps://api.todoist.com/api/v1/tasks
Request HeadersAuthorization: Bearer 뒤에 API 토큰 입력
Body Parameterscontent (문자열, 필수): “발신자의 이름과 필요한 사항을 담은 짧은 제목입니다. 예: Jane Doe에게 견적 관련 콜백.”
description (문자열, 필수): “발신자의 이름, 전화번호 및 요청 세부 정보입니다.”
due_string (문자열): “후속 조치 시점을 일반 영어로 입력합니다. 예: tomorrow at 10am. 발신자가 말하지 않았다면 생략합니다.”
project_id (문자열, 필수): “항상 정확히 PROJECT_ID 값으로 입력합니다.”
Assign to agentsReceptionist

PROJECT_ID를 프로젝트 ID로 바꾸거나, 받은편지함에 작업을 추가하려면 project_id를 삭제하세요.

Enable을 선택한 다음 내일 콜백을 요청하여 접수 담당자를 테스트하세요. 마감일이 설정된 작업이 프로젝트에 표시됩니다.

문제 해결

문제확인할 사항
Todoist에서 401을 반환함헤더 값은 토큰 앞에 Bearer 가 와야 합니다. 토큰을 재설정했다면 다시 복사하세요.
Todoist에서 400 또는 404를 반환함프로젝트 ID와 URL이 https://api.todoist.com/api/v1/tasks인지 확인하세요. 이전 가이드에서는 과거 /rest/v2/ 주소를 사용합니다.
작업의 마감일이 잘못됨Todoist는 계정의 시간대에 따라 due_string을 해석합니다. Settings → General에서 확인하세요.
접수 담당자가 작업을 전혀 생성하지 않음도구 설명에 작업을 생성해야 하는 상황을 명시하세요.