API de Asana: qué se puede hacer y cómo usarla con agentes de IA
La API de Asana da acceso a workspaces, proyectos, secciones, tareas, comentarios y campos personalizados. La usan equipos de marketing, operaciones y PMO que organizan el trabajo en Asana. El acceso es mediante un token personal o una app OAuth registrada en la consola de desarrollador.
Qué ofrece la API de Asana
Tareas
Creación, asignación, fechas límite, dependencias y cierre de tareas y subtareas.
Proyectos y secciones
Lectura y organización de proyectos, secciones y estados de proyecto.
Comentarios (stories)
Alta de comentarios y lectura del historial de cada tarea.
Campos personalizados
Lectura y llenado de campos como prioridad, costo o cliente.
Portafolios y metas
Vista de conjuntos de proyectos y seguimiento de metas, según el plan.
Webhooks
Eventos de creación y cambio en proyectos y tareas.
Cómo acceder a la API de Asana
- Con las credenciales de tu empresaAcepta un token de acceso personal u OAuth 2.0 con una app registrada en la consola de desarrollador de Asana.
- Hay límites de solicitudes por minuto: Asana devuelve un aviso cuando se supera el límite.
- Evita usar el token personal de un colaborador.
- No le des al agente permiso para eliminar proyectos ni tareas.
Documentación oficial: developers.asana.com
Qué hace un agente de iTeam con la API de Asana
El briefing se convierte en proyecto
A partir de un briefing recibido por correo, el agente crea el proyecto con la plantilla del equipo, con tareas, responsables y fechas límite.
Actualización del estado del proyecto
Cada semana, el agente lee el avance y escribe el estado del proyecto con los riesgos y los próximos hitos.
Dependencias en riesgo
El agente avisa cuando una tarea atrasada va a empujar a otras que dependen de ella.
Solicitudes de Slack a Asana
Los pedidos hechos en el canal se vuelven tareas en la sección de entrada, con el enlace a la conversación original.
De la credencial al agente trabajando, con aprobación
Crear la credencial
Usa una cuenta de servicio de Asana para generar el token o registra una app OAuth en la consola de desarrollador.
Guardar en la bóveda y limitar los proyectos
Registra la credencial en la bóveda de iTeam y define en qué proyectos lee y escribe cada agente.
Probar en un proyecto piloto
Ejecuta la automatización en un proyecto piloto y revísala con el equipo antes de ampliarla.
Equipos de IA listos para este trabajo
Reportes e indicadores
Nina junta los datos, Darwin revisa los números y el informe de indicadores llega a Slack con lo que cambió y por qué.
Gestión de inventario
Nina vigila cada referencia, Darwin calcula cuánto reponer y la orden de compra sale solo cuando una persona la aprueba.
Compras y cotizaciones
Darwin pide cotizaciones y las compara en una tabla, Henry revisa las condiciones y la orden de compra sale con la aprobación registrada.
Logística y entregas
Nina arma las rutas y sigue a cada conductor por WhatsApp; Jaca avisa al cliente del estado de su pedido antes de que llame.
Preguntas sobre la API de Asana
¿La API de Asana es gratuita?
En general, la API está disponible en las cuentas de Asana sin costo aparte. Algunos recursos a los que se accede por ella dependen del plan.
¿Necesito programar para usar la API de Asana con iTeam?
No necesariamente. Asana está en el catálogo de apps de iTeam y el equipo de implementación configura proyectos, campos y reglas.
¿El agente puede usar plantillas de proyecto?
Sí, cuando el plan permite plantillas. Así cada proyecto nuevo nace con la misma estructura definida por el equipo.
