任务管理工具,就是团队的任务本来就在的地方:Asana、ClickUp、HubSpot、Jira 或 Trello。在这里,它指的是通过你的组织建立的连接来使用其中之一 — 凭的是成员粘贴过一次的令牌,而不是把你的工作另存一份放在别处。
一个连接,两种入口
- 项目房间让自己的任务与一个项目、列表或管道保持同步:在房间里创建的任务会出现在工具里,在工具里做的改动会回到房间。
- API 直接触及同一个连接:Asana 在 /asana/v1,ClickUp 在 /clickup/v1,HubSpot 在 /hubspot/v1,Jira 在 /jira/v1,每个都有七个操作,用的是与 LinkedIn API 相同的密钥。
这四个其实是同一个 API 的四个版本。不同的只是各个工具对放任务的那个地方的叫法 — Asana 和 Jira 叫项目,ClickUp 叫列表,HubSpot 叫管道 — 而四个都把它叫作 project_id。不论来自哪个工具,一个任务都是同样的五个字段:title、notes、status(open、doing 或 done)、assignee 和 due。
Trello 只由房间来关联,在这里没有自己的 API。房间对 Trello 做的一切,都走同一个同步引擎;缺的是那道入口,不是这个工具。
常见问题
令牌要填在哪里?
在房间页面,登录后,在房间的任务工具下面。它绝不会经过 API:POST /asana/v1/connections/link 以及另外三个工具的同类路径,都会返回 403,并附上那个页面的地址 — 因为机密不该出现在助手手里的 API 调用中。
我能触及别人的连接吗?
不能。一个连接只属于一个组织,属于别人的连接,得到的回答与不存在的连接完全一样 — 是 404,不是 403,而且两种情况措辞相同,所以没人能借此探测 ID。项目 ID 每次调用都会到工具里查证,而不是直接信任。
工作记在谁的名下?
记在连接所用令牌所属的那位成员名下。通过 API 创建的任务,就是由这位成员在工具里创建的,和他亲手在那里输入的一样。