Un outil de suivi du travail, c'est là où les tâches d'une équipe vivent déjà : Asana, ClickUp, HubSpot, Jira ou Trello. Ici, cela désigne l'un d'eux atteint par une connexion que votre organisation a faite — un jeton qu'un membre a collé une seule fois — et non une copie de votre travail conservée ailleurs.
Une connexion, deux voies d'accès
- Une salle de projet garde ses propres tâches synchronisées avec un projet, une liste ou un pipeline : une tâche créée dans la salle apparaît dans l'outil, et une modification faite dans l'outil revient dans la salle.
- L'API atteint directement la même connexion : Asana sur /asana/v1, ClickUp sur /clickup/v1, HubSpot sur /hubspot/v1 et Jira sur /jira/v1, sept opérations chacun, avec la même clé que la LinkedIn API.
Les quatre sont une seule API répétée quatre fois. Ce qui change, c'est le mot que chaque outil emploie pour l'endroit où se trouvent les tâches — Asana et Jira l'appellent un projet, ClickUp une liste, HubSpot un pipeline — et les quatre le nomment project_id. Une tâche a les mêmes cinq champs, quel que soit l'outil d'où elle vient : title, notes, status (open, doing ou done), assignee et due.
Trello se relie uniquement depuis une salle et n'a pas d'API propre ici. Tout ce qu'une salle fait avec Trello, elle le fait par le même moteur de synchronisation ; c'est la porte d'entrée qui manque, pas l'outil.
Questions fréquentes
Où va le jeton ?
Sur la page des salles, une fois connecté, dans les outils de tâches de la salle. Il ne passe jamais par l'API : POST /asana/v1/connections/link et les trois autres répondent 403 avec l'adresse de cette page, car un secret n'a pas sa place dans un appel d'API qu'un assistant tient entre ses mains.
Puis-je atteindre la connexion d'une autre organisation ?
Non. Une connexion appartient à une organisation, et celle d'une autre reçoit exactement la même réponse que celle qui n'existe pas — 404, jamais 403, et avec les mêmes mots dans les deux cas, pour qu'on ne puisse pas sonder un identifiant. L'identifiant d'un projet est recherché dans l'outil à chaque appel au lieu d'être pris tel quel.
Au nom de qui est le travail ?
Du membre dont le jeton est la connexion. Une tâche créée par l'API est créée par cette personne dans l'outil, comme si elle l'y avait tapée elle-même.