작업 관리 도구는 팀의 작업이 이미 있는 곳입니다. Asana, ClickUp, HubSpot, Jira, Trello가 그렇습니다. 여기서는 그중 하나를 조직이 만든 연결을 통해 이용하는 것을 뜻합니다. 멤버가 한 번 붙여 넣은 토큰으로 접근하며, 업무의 사본을 다른 곳에 따로 두는 것이 아닙니다.
연결 하나, 들어가는 길 둘
- 프로젝트 룸은 자체 작업을 프로젝트, 리스트 또는 파이프라인 하나와 같은 상태로 유지합니다. 룸에서 만든 작업은 도구에 나타나고, 도구에서 바뀐 내용은 룸으로 돌아옵니다.
- API는 같은 연결에 직접 닿습니다. Asana는 /asana/v1, ClickUp은 /clickup/v1, HubSpot은 /hubspot/v1, Jira는 /jira/v1이며, 각각 동작이 7가지이고 LinkedIn API와 같은 키를 씁니다.
이 넷은 하나의 API를 네 번 되풀이한 것입니다. 다른 점은 작업이 놓이는 자리를 각 도구가 부르는 이름뿐입니다. Asana와 Jira는 프로젝트, ClickUp은 리스트, HubSpot은 파이프라인이라고 부르지만, 넷 모두 project_id라고 지정합니다. 작업은 어느 도구에서 왔든 같은 다섯 필드로 이뤄집니다. title, notes, status(open, doing, done 중 하나), assignee, due.
Trello는 룸이 연결하는 쪽이며, 여기에는 Trello 전용 API가 없습니다. 룸이 Trello로 하는 모든 일은 같은 동기화 엔진을 거칩니다. 빠진 것은 도구가 아니라 그쪽으로 난 문입니다.
자주 묻는 질문
토큰은 어디에 넣나요?
룸 페이지에서, 로그인한 상태로, 룸의 작업 도구 안에 넣습니다. API로는 절대 넣지 않습니다. POST /asana/v1/connections/link와 나머지 세 API의 같은 경로는 그 페이지의 주소와 함께 403으로 답합니다. 비밀 값은 어시스턴트가 들고 있는 API 호출에 실려서는 안 되기 때문입니다.
다른 사람의 연결에 닿을 수 있나요?
아니요. 연결은 하나의 조직에 속하며, 다른 조직의 연결은 존재하지 않는 연결과 똑같이 답합니다. 403이 아니라 404이며 두 경우 문구도 같으므로, ID를 떠볼 수 없습니다. 프로젝트 ID는 믿고 쓰지 않고 호출할 때마다 도구에서 조회합니다.
일은 누구 이름으로 남나요?
연결의 주인인 토큰의 멤버입니다. API로 만든 작업은, 그 멤버가 도구에 직접 입력했을 때와 똑같이 그 멤버가 만든 것으로 남습니다.