Saltar al contenido principal

Asana

¿Prefieres configuracion guiada con IA?

En lugar de seguir estos pasos manualmente, puedes usar el Asistente de Credenciales con IA — describe lo que quieres conectar y la IA te guiara paso a paso, adaptado a tu cuenta.

Descripción General​

Conecta tu cuenta de Asana a Nirvai para gestionar tareas, proyectos y flujos de trabajo de equipo programáticamente.

Métodos de Autenticación Soportados​

  • Personal Access Token (PAT) - Recomendado para integraciones personales/de un solo usuario

Requisitos Previos​

  • Una cuenta de Asana (gratuita o de pago)
  • Acceso al workspace para los proyectos que quieres gestionar

Instrucciones de Configuración​

Personal Access Token (Recomendado)​

  1. Inicia sesión en tu cuenta de Asana
  2. Ve a Developer Console
  3. Haz clic en Create new token bajo "Personal Access Tokens"
  4. Ingresa una descripción (ej., "Integración Nirvai")
  5. Haz clic en Create token
  6. Importante: Copia el token inmediatamente - no se mostrará de nuevo
  7. En Nirvai, crea una nueva credencial de Asana y pega el token

Permisos del Token​

Los Personal Access Tokens tienen los mismos permisos que tu cuenta de Asana:

  • Si eres admin del workspace, el token tiene acceso de admin
  • Si eres miembro, el token tiene acceso de nivel miembro
  • El acceso está limitado a los workspaces de los que eres parte

Gestión de Tokens​

Ver Tokens Activos​

  1. Ve a Developer Console
  2. Ve todos tus tokens activos bajo "Personal Access Tokens"

Revocar Tokens​

  1. Ve a Developer Console
  2. Encuentra el token que quieres revocar
  3. Haz clic en el icono de papelera para eliminarlo

Solución de Problemas​

Problemas Comunes​

  • 401 Unauthorized: El token puede estar revocado o inválido. Genera un nuevo token.
  • 403 Forbidden: No tienes acceso al recurso. Verifica los permisos del workspace/proyecto.
  • 404 Not Found: La tarea/proyecto puede no existir o no tienes acceso.
  • Rate limited: Asana tiene límites de tasa. Implementa estrategias de backoff para operaciones masivas.

Límites de Tasa de API​

Asana usa los siguientes límites de tasa:

  • Estándar: ~1500 solicitudes por minuto
  • Las respuestas incluyen el header X-Asana-Request-Count
  • Implementa backoff exponencial cuando alcances los límites

Mejores Prácticas​

  • Usa tokens separados para diferentes aplicaciones
  • Revoca tokens que ya no necesites
  • Nunca compartas tokens o los commits a control de versiones
  • Usa el principio de mínimo privilegio (considera crear un usuario de Asana dedicado para automatización)

Recursos Relacionados​

Adaptado para la plataforma Nirvai

Siguientes Pasos​

¿Ya tienes tu credencial? Conectala a un agente

Usa el Creador de Herramientas con IA para convertir esta credencial en herramientas usables por el agente. Describe lo que tu agente deberia poder hacer y la IA investiga la API, configura los endpoints y te entrega un toolkit revisable antes de guardar nada.