Asana
Esta integración está activa y lista para usar en Frihet.
Conecta tu workspace de Asana a Frihet. Consulta proyectos y tareas directamente desde tu ERP para tener visibilidad del trabajo realizado al momento de facturar.
¿Para qué sirve?
Con Asana integrado:
- Ver proyectos — Consulta todos tus proyectos de Asana desde Frihet
- Ver tareas — Navega las tareas de cada proyecto con su estado
- Contexto al facturar — Revisa tareas completadas antes de crear facturas
- Detección automática de workspace — Frihet detecta tu workspace principal automáticamente
Requisitos
- Cuenta Asana activa — asana.com
- Personal Access Token — Se genera desde la configuración de Asana
- Frihet Pro o superior
Conectar Asana con Frihet
Paso 1: Obtener tu Personal Access Token
- Ve a app.asana.com/0/developer-console
- Inicia sesión con tu cuenta de Asana
- En la sección Personal access tokens, haz clic en Create new token
- Ponle un nombre (ej: "Frihet ERP")
- Acepta los términos de la API
- Copia el token generado
El Personal Access Token solo se muestra una vez. Cópialo antes de cerrar la ventana.
Paso 2: Configurar en Frihet
- Ve a Ajustes → Integraciones
- Busca Asana
- Haz clic en Conectar
- Pega tu Personal Access Token
- Haz clic en Verificar conexión
- Frihet detectará automáticamente tu primer workspace
Paso 3: Verificar conexión
Si la conexión es correcta, Frihet mostrará:
- Nombre de tu workspace en Asana
- Número de proyectos accesibles
- Tu nombre de usuario en Asana
Cómo funciona
Frihet usa la API REST v1 de Asana con Bearer authentication:
- Proporcionas tu Personal Access Token
- Frihet envía el token en la cabecera
Authorization: Bearer <token> - Al conectar, Frihet consulta tus workspaces y selecciona el primero automáticamente
- Los proyectos y tareas se consultan bajo demanda
- El token se almacena cifrado (AES-256-GCM) en Frihet
Datos sincronizados
| Dato | Dirección | Frecuencia |
|---|---|---|
| Proyectos | Asana → Frihet | Bajo demanda |
| Tareas | Asana → Frihet | Bajo demanda |
| Estado de tareas | Asana → Frihet | Con cada consulta |
| Asignados | Asana → Frihet | Con cada consulta |
Casos de uso
Consultor que factura por proyecto
Gestionas los entregables de cada cliente en Asana. Antes de facturar, consultas desde Frihet las tareas completadas del proyecto para incluir el desglose correcto en la factura.
Agencia creativa con sprints
Tu equipo trabaja en sprints organizados en proyectos de Asana. A final de cada sprint, consultas las tareas completadas desde Frihet y generas las facturas correspondientes.
Verificar alcance antes de facturar
Tienes un proyecto con alcance definido en Asana. Antes de emitir la factura final, verificas desde Frihet que todas las tareas del alcance están marcadas como completadas.
Funcionalidades
Ver proyectos
- Desde Frihet, accede a la sección de Asana
- Verás todos los proyectos de tu workspace
- Cada proyecto muestra nombre, estado y número de tareas
Ver tareas de un proyecto
- Selecciona un proyecto
- Frihet muestra las tareas con:
- Nombre de la tarea
- Estado (completada / pendiente)
- Persona asignada
- Fecha de vencimiento
- Filtra por estado para ver solo las completadas
Detección automática de workspace
Al conectar, Frihet detecta tu primer workspace automáticamente. Si tienes varios workspaces en Asana, se usa el principal. No necesitas configurar nada adicional.
Manejo de errores
Todas las llamadas a la API de Asana tienen un timeout de 30 segundos. Si una peticion falla, Frihet registra el error automaticamente para diagnostico. Verifica tu conexion a internet si las consultas fallan repetidamente.
Solución de problemas
"Error de autenticación"
- Verifica que el Personal Access Token es correcto
- Comprueba que no ha sido revocado en la consola de desarrollador de Asana
- Si regeneraste el token, actualízalo en Frihet
"No veo mis proyectos"
- Frihet usa el primer workspace de tu cuenta. Si tienes varios, el que quieres puede estar en otro
- Verifica que tienes acceso a los proyectos desde tu cuenta de Asana
- Los proyectos privados de otros usuarios no serán visibles
"Las tareas no se actualizan"
- Las consultas son en tiempo real (bajo demanda)
- Recarga la vista en Frihet para ver cambios recientes
- Verifica que las tareas están asignadas al proyecto correcto en Asana
"Quiero usar otro workspace"
- Actualmente, Frihet auto-detecta el primer workspace
- Si necesitas cambiar, desconecta y reconecta la integración
- El workspace seleccionado depende del orden devuelto por la API de Asana
"Quiero desconectar"
- Ve a Ajustes → Integraciones → Asana
- Haz clic en Desconectar
- Opcionalmente, revoca el token en app.asana.com/0/developer-console