タスク管理ツールとは、チームのタスクがすでにある場所のことです。Asana、ClickUp、HubSpot、Jira、Trello。ここでは、そのどれかに、組織が作った接続を通して届くことを指します。メンバーが一度だけ貼り付けたトークンを使うので、仕事のコピーをどこかに別に置くことはありません。
ひとつの接続、2 つの入口
- プロジェクトルームは、自分のタスクをひとつのプロジェクト、リスト、パイプラインと揃えて保ちます。ルームで作ったタスクはツールに現れ、ツールで加えた変更はルームに戻ってきます。
- API は同じ接続に直接届きます。Asana は /asana/v1、ClickUp は /clickup/v1、HubSpot は /hubspot/v1、Jira は /jira/v1。どれも操作は 7 つで、LinkedIn API と同じキーを使います。
この 4 つは、ひとつの API が 4 回繰り返されているものです。違うのは、タスクが置かれる場所を各ツールがどう呼ぶかだけです。Asana と Jira はプロジェクト、ClickUp はリスト、HubSpot はパイプラインと呼びますが、4 つとも project_id という名前で指定します。タスクは、どのツールから来ても同じ 5 つのフィールドでできています。title、notes、status(open、doing、done のいずれか)、assignee、due。
Trello はルームがリンクするためのもので、ここには専用の API がありません。ルームが Trello で行うことはすべて、同じ同期エンジンを通して行われます。足りないのはツールではなく、入口のほうです。
よくある質問
トークンはどこに入れますか？
ルームのページで、サインインした状態で、ルームのタスクツールの中に入れます。API を通すことはありません。POST /asana/v1/connections/link も、ほかの 3 つの API の同じパスも、そのページのアドレスを添えて 403 を返します。アシスタントが扱う API 呼び出しに、秘密情報を載せるべきではないからです。
他の人の接続に届くことはありますか？
ありません。接続はひとつの組織に属していて、別の組織のものは、存在しないものとまったく同じに返されます。403 ではなく 404 で、どちらの場合も文面は同じなので、ID を探ることはできません。プロジェクト ID は、信用せず、呼び出しのたびにツールで調べます。
仕事は誰の名前になりますか？
接続の元になっているトークンの持ち主であるメンバーです。API で作ったタスクは、そのメンバーがツールで自分で入力した場合と同じく、そのメンバーが作ったことになります。