Uma ferramenta de gestão de trabalho é o lugar onde as tarefas de um time já vivem: Asana, ClickUp, HubSpot, Jira ou Trello. Aqui significa uma delas alcançada por uma conexão que a sua organização fez — um token que um membro colou uma única vez — e não uma cópia do seu trabalho guardada em outro lugar.
Uma conexão, duas portas de entrada
- Uma sala de projeto mantém as próprias tarefas em sincronia com um projeto, uma lista ou um pipeline: uma tarefa criada na sala aparece na ferramenta, e uma mudança feita na ferramenta volta para a sala.
- A API alcança diretamente a mesma conexão: o Asana em /asana/v1, o ClickUp em /clickup/v1, o HubSpot em /hubspot/v1 e o Jira em /jira/v1, sete operações em cada um, com a mesma chave da LinkedIn API.
As quatro são uma só API repetida quatro vezes. O que muda é a palavra que cada ferramenta usa para o lugar onde as tarefas ficam — Asana e Jira chamam de projeto, o ClickUp chama de lista, o HubSpot chama de pipeline — e as quatro o chamam de project_id. Uma tarefa tem os mesmos cinco campos, venha de qual ferramenta vier: title, notes, status (open, doing ou done), assignee e due.
O Trello só se vincula a partir de uma sala e não tem uma API própria aqui. Tudo o que uma sala faz com o Trello ela faz pelo mesmo mecanismo de sincronização; o que falta é a porta de entrada, não a ferramenta.
Perguntas frequentes
Onde vai o token?
Na página de salas, com a sessão iniciada, nas ferramentas de tarefas da sala. Ele nunca passa pela API: POST /asana/v1/connections/link e as outras três respondem 403 com o endereço dessa página, porque um segredo não deve estar numa chamada de API que um assistente tem nas mãos.
Posso alcançar a conexão de outra organização?
Não. Uma conexão pertence a uma organização, e a que é de outra é respondida exatamente como a que não existe — 404, nunca 403, e com as mesmas palavras nos dois casos, para que não seja possível sondar um id. O id de um projeto é consultado na ferramenta a cada chamada em vez de ser aceito como está.
Em nome de quem fica o trabalho?
Do membro cujo token é a conexão. Uma tarefa criada pela API é criada por essa pessoa na ferramenta, como seria se ela mesma a tivesse digitado lá.