# Asana

:::tip Disponible
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](https://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

1. Ve a [app.asana.com/0/developer-console](https://app.asana.com/0/developer-console)
2. Inicia sesión con tu cuenta de Asana
3. En la sección **Personal access tokens**, haz clic en **Create new token**
4. Ponle un nombre (ej: "Frihet ERP")
5. Acepta los términos de la API
6. Copia el token generado

:::caution Guarda el token
El Personal Access Token solo se muestra una vez. Cópialo antes de cerrar la ventana.
:::

### Paso 2: Configurar en Frihet

1. Ve a **Ajustes** → **Integraciones**
2. Busca **Asana**
3. Haz clic en **Conectar**
4. Pega tu **Personal Access Token**
5. Haz clic en **Verificar conexión**
6. 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:

1. Proporcionas tu Personal Access Token
2. Frihet envía el token en la cabecera `Authorization: Bearer <token>`
3. Al conectar, Frihet consulta tus workspaces y selecciona el primero automáticamente
4. Los proyectos y tareas se consultan bajo demanda
5. 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

1. Desde Frihet, accede a la sección de Asana
2. Verás todos los proyectos de tu workspace
3. Cada proyecto muestra nombre, estado y número de tareas

### Ver tareas de un proyecto

1. Selecciona un proyecto
2. Frihet muestra las tareas con:
   - Nombre de la tarea
   - Estado (completada / pendiente)
   - Persona asignada
   - Fecha de vencimiento
3. 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"

1. Ve a **Ajustes** → **Integraciones** → **Asana**
2. Haz clic en **Desconectar**
3. Opcionalmente, revoca el token en [app.asana.com/0/developer-console](https://app.asana.com/0/developer-console)

## Próximos pasos

- [Conecta Trello como alternativa de gestión de proyectos](./trello)
- [Conecta Notion para documentación y bases de datos](./notion)
- [Automatiza flujos con n8n](./n8n)