Una herramienta de seguimiento del trabajo es el lugar donde ya viven las tareas de un equipo: Asana, ClickUp, HubSpot, Jira o Trello. Aquí significa una de ellas a la que se llega mediante una conexión que hizo tu organización — un token que un miembro pegó una sola vez — y no una copia de tu trabajo guardada en otro sitio.
Una conexión, dos vías de entrada
- Una sala de proyecto mantiene sus propias tareas sincronizadas con un proyecto, una lista o un pipeline: una tarea creada en la sala aparece en la herramienta, y un cambio hecho en la herramienta vuelve a la sala.
- La API llega directamente a la misma conexión: Asana en /asana/v1, ClickUp en /clickup/v1, HubSpot en /hubspot/v1 y Jira en /jira/v1, siete operaciones cada una, con la misma clave que la LinkedIn API.
Las cuatro son una sola API repetida cuatro veces. Lo que cambia es la palabra que cada herramienta usa para el lugar donde están las tareas — Asana y Jira lo llaman proyecto, ClickUp lo llama lista, HubSpot lo llama pipeline — y las cuatro lo nombran project_id. Una tarea tiene los mismos cinco campos venga de la herramienta que venga: title, notes, status (open, doing o done), assignee y due.
Trello solo se vincula desde una sala y aquí no tiene una API propia. Todo lo que una sala hace con Trello lo hace con el mismo motor de sincronización; lo que falta es la puerta de entrada, no la herramienta.
Preguntas frecuentes
¿Dónde se pone el token?
En la página de salas, con la sesión iniciada, en las herramientas de tareas de la sala. Nunca pasa por la API: POST /asana/v1/connections/link y las otras tres responden 403 con la dirección de esa página, porque un secreto no tiene cabida en una llamada a la API que tiene en sus manos un asistente.
¿Puedo llegar a la conexión de otra organización?
No. Una conexión pertenece a una organización, y la que es de otra se responde exactamente igual que la que no existe — 404, nunca 403, y con las mismas palabras en ambos casos, de modo que no se pueda sondear un id. El id de un proyecto se consulta en la herramienta en cada llamada en lugar de darse por bueno.
¿A nombre de quién queda el trabajo?
Del miembro cuyo token es la conexión. Una tarea creada mediante la API la crea esa persona en la herramienta, igual que si la hubiera escrito allí.