Trello
Esta integración está activa y lista para usar en Frihet.
Conecta tus tableros de Trello a Frihet. Consulta tableros, listas y tarjetas directamente desde tu ERP para tener contexto de proyecto al facturar.
¿Para qué sirve?
Con Trello integrado:
- Ver tableros — Consulta todos tus tableros de Trello desde Frihet
- Ver listas y tarjetas — Navega la estructura de tus proyectos
- Contexto al facturar — Consulta tareas completadas antes de crear una factura
- Visibilidad centralizada — Sin cambiar entre aplicaciones
Requisitos
- Cuenta Trello activa — trello.com
- API Key de Trello — Se obtiene desde el portal de desarrolladores
- Token de autorización — Se genera al autorizar tu aplicación
- Frihet Pro o superior
Conectar Trello con Frihet
Paso 1: Obtener tu API Key
- Ve a trello.com/power-ups/admin
- Inicia sesión en tu cuenta de Trello
- Haz clic en New para crear un nuevo Power-Up o integración
- Rellena los campos:
- Name: "Frihet ERP"
- Workspace: Selecciona tu workspace
- Una vez creado, ve a la pestaña API Key
- Copia tu API Key
Paso 2: Generar un Token
- En la misma página, junto a la API Key, haz clic en el enlace Token
- Se abrirá una página de autorización de Trello
- Revisa los permisos solicitados y haz clic en Allow
- Copia el Token generado
Necesitas ambas: la API Key y el Token. Cópialos antes de continuar.
Paso 3: Configurar en Frihet
- Ve a Ajustes → Integraciones
- Busca Trello
- Haz clic en Conectar
- Introduce tu API Key
- Introduce tu Token
- Haz clic en Verificar conexión
- Si es correcto, verás tus tableros listados
Cómo funciona
Frihet usa la API REST de Trello con autenticación por query params:
- Proporcionas API Key y Token
- Frihet añade ambos como parámetros de query en cada petición:
?key=<api-key>&token=<token> - Los tableros, listas y tarjetas se consultan bajo demanda
- Ambas credenciales se almacenan cifradas (AES-256-GCM) en Frihet
Datos sincronizados
| Dato | Dirección | Frecuencia |
|---|---|---|
| Tableros | Trello → Frihet | Bajo demanda |
| Listas | Trello → Frihet | Bajo demanda |
| Tarjetas | Trello → Frihet | Bajo demanda |
| Miembros | Trello → Frihet | Con cada consulta |
Casos de uso
Freelancer que gestiona proyectos en Trello
Tienes un tablero por cliente con columnas como "Por hacer", "En progreso" y "Completado". Antes de facturar, consultas las tarjetas completadas desde Frihet para verificar qué trabajo incluir.
Agencia con tableros de cliente
Tu equipo trabaja con tableros compartidos por cliente. Desde Frihet puedes ver el estado de cada tablero para saber cuándo un proyecto está listo para facturar.
Verificar entregables antes de facturar
Antes de emitir una factura de un proyecto, consultas desde Frihet las tarjetas del tablero correspondiente en Trello. Confirmas que todos los entregables están completados.
Funcionalidades
Ver tableros
- Desde Frihet, accede a la sección de Trello
- Verás todos los tableros a los que tiene acceso tu cuenta
- Selecciona un tablero para ver sus listas y tarjetas
Ver listas y tarjetas
- Selecciona un tablero
- Frihet muestra las listas (columnas) con sus tarjetas
- Cada tarjeta muestra título, miembros asignados y etiquetas
Navegar tarjetas
- Haz clic en una tarjeta para ver más detalles
- Ve la descripción, checklist, comentarios y adjuntos
- Usa esta información como referencia al crear facturas
Limites de API
Frihet implementa throttling automatico (100ms entre peticiones) para respetar los limites de la API de Trello. Las consultas a tableros grandes pueden tardar unos segundos adicionales.
Solución de problemas
"Error de autenticación"
- Verifica que la API Key y el Token son correctos
- El Token debe corresponder a la misma cuenta que la API Key
- Si revocaste el Token, genera uno nuevo y actualízalo en Frihet
"No veo todos mis tableros"
- Verifica que tu cuenta tiene acceso a esos tableros en Trello
- Los tableros privados de otros miembros no serán visibles
- Si eres invitado a un tablero, el acceso depende de los permisos del tablero
"El Token ha expirado"
- Los tokens de Trello no expiran por defecto a menos que los configures así
- Si el token fue revocado manualmente, genera uno nuevo
- Ve a trello.com/power-ups/admin para gestionar tokens
"Quiero desconectar"
- Ve a Ajustes → Integraciones → Trello
- Haz clic en Desconectar
- Opcionalmente, revoca el Token desde Trello en Settings → Applications