Conectores (Marketplace)
El marketplace de conectores centraliza las integraciones entre FoxPlan y sus herramientas externas (mensajería, CRM, ERP, ITSM, RR. HH.). Cada conector se instala en un espacio de trabajo, se configura una vez y, a continuación, reacciona automáticamente a los eventos de negocio de FoxPlan (cambio de estado, asignación, comentario…).
Ajustes → Conectores
La pestaña Conectores solo es visible para los colaboradores de FoxPlan (cuentas cuyo correo electrónico o login termina en @fox-plan.com). Se trata de una funcionalidad en curso de despliegue, gestionada por los equipos de FoxPlan por cuenta de los clientes.
Catálogo
| Conector | Editor | Categorías | Madurez |
|---|---|---|---|
| Slack | Slack | Comunicación, Notificaciones | Estable |
| Microsoft Teams | Microsoft | Comunicación, Notificaciones | Estable |
| Google Chat | Comunicación, Notificaciones | Estable | |
| Jira Cloud | Atlassian | ITSM, Gestión de proyectos | Beta |
| HubSpot | HubSpot, Inc. | CRM, Marketing | Alfa |
| Odoo | Odoo S.A. | ERP, Open Source | Alfa |
| Pennylane | Pennylane | Finanzas, Contabilidad | Alfa |
| Sage Business Cloud Accounting | Sage Group plc | Finanzas, Contabilidad | Alfa |
| Cegid | Cegid | ERP, Finanzas, RR. HH. | Alfa |
| HiBob | Hibob | RR. HH., People | Alfa |
| Infor M3 | Infor | ERP, Industria | Alfa |
| SAP S/4HANA Cloud (Public) | SAP SE | ERP, Finanzas | Alfa |
- Estable: listo para producción.
- Beta: funcional, con un perímetro que aún puede evolucionar.
- Alfa: conector inicial (prueba de conexión + un flujo). Reservado a la evaluación.
Instalar un conector
- Abra Ajustes → Conectores.
- Haga clic en la tarjeta del conector deseado para abrir su ficha.
- Pestaña Configuración: complete los campos requeridos (URL, tokens, credenciales…).
- Haga clic en Guardar. El conector queda entonces instalado en el espacio de trabajo.
- Utilice Probar para verificar la conexión antes de activar los flujos.
El conmutador situado en la parte superior de la ficha permite activar / desactivar globalmente la instalación sin perder su configuración.
Campos de configuración
Las fichas utilizan campos tipados: texto, URL, número, booleano, lista, área de texto, contraseña y secreto. Los campos marcados como secretos (tokens de API, URLs de webhook firmadas…) se cifran en reposo y nunca vuelven a mostrarse en claro — una máscara (••••) indica que ya hay un valor guardado.
La autenticación depende del conector: URL de webhook entrante (chat), token de API, Bearer, Basic u OAuth según la herramienta de destino.
Flujos y desencadenadores
Un conector expone uno o varios flujos. Cada flujo se activa de forma independiente en la pestaña Flujos de la ficha.
Los flujos de notificación reaccionan a los siguientes eventos de tarea:
- Cambio de estado de una tarea
- Cambio de responsable (asignación)
- Cambio de asignación de planificación
- Adición de un comentario
Los flujos de tareas solo se desencadenan si las opciones de notificación del proyecto correspondientes están activadas (Notificar al cambiar de estado, Notificar al asignar, Notificar al comentar…), definidas en la Definición del proyecto. Un conector recién instalado permanece por tanto en silencio mientras esas opciones no estén marcadas en los proyectos afectados.
Ejecución manual
Los flujos «bajo demanda» (por ejemplo una sincronización) pueden lanzarse manualmente mediante el botón Ejecutar de la pestaña Flujos. El resultado (éxito / fallo, código HTTP) se devuelve inmediatamente.
Seguimiento y registros
La pestaña Registros de cada conector lista las últimas ejecuciones: fecha, flujo, tipo de evento, estado, código HTTP, duración y mensaje.
- El envío hacia las herramientas externas es asíncrono: nunca afecta al guardado de la tarea en FoxPlan. Si un conector falla, la acción de FoxPlan se completa con normalidad y el error queda registrado.
- Los registros se purgan automáticamente tras un periodo de retención (60 días por defecto), gestionado por un índice TTL de MongoDB.
Las URLs de webhook de Slack / Teams / Google Chat introducidas directamente en la ficha del proyecto siguen funcionando como antes, en paralelo a los conectores. Los conectores del marketplace no las sustituyen: ofrecen una configuración centralizada a escala del espacio de trabajo.
Seguridad
- Todos los secretos de los conectores están cifrados (AES-GCM) con una clave dedicada (
CONNECTOR_SECRETS_ENCRYPTION_KEY). - Los datos de los conectores (instalaciones, configuración de flujos, registros) están aislados por espacio de trabajo (tenant).
- El acceso a la pantalla está restringido a las cuentas FoxPlan, y las llamadas de API correspondientes están protegidas en el servidor.