Zoom

A1Connection architecture

The connection uses OAuth 2.0 against the vendor's own consent screen. The authorisation request names the minimum scopes the features need — the exact scope list is shown in the security-flow panel below, pulled from the same provider registry the application uses. The code-for-token exchange happens entirely server-side (Autenticación de cliente HTTP Basic, per the vendor's token endpoint contract); tokens are stored encrypted at rest and are never rendered back to any screen — connection pages show presence, not values.

El ciclo de vida del token se gestiona en un único punto de control: la caducidad activa una actualización automática, los tokens de actualización renovados se conservan y una actualización que el proveedor rechaza se muestra como un aviso visible de reconexión, nunca como funciones inactivas en silencio. La revocación funciona desde ambos lados: desconecte aquí o revoque en los ajustes de seguridad del propio proveedor.

A2Escribir semántica y flujo de datos

Cada movimiento de datos es una acción explícita con un resultado registrado. Las escrituras ocurren al hacer clic, o automáticamente solo donde haya habilitado una regla (el envío automático al contratar está desactivado de forma predeterminada, por proveedor). Las lecturas (importaciones de personas, cuentas o archivos) se ejecutan al presionar Importar, eliminan duplicados respecto a lo que ya tiene (clientes por nombre, personas por correo electrónico), omiten en lugar de sobrescribir e informan con precisión lo creado frente a lo omitido, por lo que volver a ejecutar cualquier importación es seguro por diseño.

Cada acción registra una fila en el historial de actividad de la aplicación (ats_app_activity): qué se ejecutó, cuándo, para qué registro y el resultado, incluido el texto de error literal del proveedor cuando algo falla. Los informes de uso dentro del ATS agregan ese mismo registro, por lo que la información de la integración y su funcionamiento real nunca discrepan.

Todo lo que sale de la ruta de la solicitud (difusión de notificaciones, entrega de webhooks, registro de actividad, correo electrónico) se ejecuta en subprocesos en segundo plano desatendidos. Un extremo externo lento nunca puede bloquear la interfaz, y un efecto secundario fallido se registra en lugar de reintentarse silenciosamente generando inconsistencias.

A3Consideraciones operativas

Las conexiones se establecen a nivel de organización y están restringidas a los roles de propietario y administrador; los seleccionadores utilizan las funciones que ofrece una conexión, pero no pueden conectarla, desconectarla ni reconfigurarla. Al desconectar se eliminan de inmediato las credenciales almacenadas y las funciones dependientes se detienen de forma visible, no silenciosa. Los datos ya importados siguen siendo suyos y editables.

Las personas importadas llegan marcadas como importadas con valores de privacidad predeterminados y conservadores: no se asume el consentimiento de nadie que no haya completado su formulario de postulación y se aplican los valores de retención predeterminados. Todo lo registrado es suyo para llevárselo: las exportaciones en CSV y la aplicación Data Export cubren los mismos repositorios que el propio producto consulta. La salida está tan abierta como la entrada — por diseño, no por concesión.

A4Ubicación en la topología de integración

Esta integración ya está activa en el catálogo. One connection per provider unlocks every feature it powers, and the topology grid below shows the neighbouring connectors in the same capability area — statuses come from the same registry that drives the in-app hub, so this page can never claim more than the product does. For anything the catalogue does not cover, Webhooks and Zapier are the generic, documented escape hatch.