Módulos

Integraciones

Conexiones con sistemas externos, más de 99 conectores listos, autenticación y protección de salida.

En esta página

Las integraciones conectan la Aptabit Platform con los sistemas de su organización y de sus socios. Cada conexión se registra una vez, con sus recursos y credenciales, y la reutilizan los flujos.

Conexiones

En Integraciones, registre una conexión por sistema. Tipos disponibles:

Tipo Uso en los flujos
REST API Ejecutada por el bloque de integración.
GraphQL Ejecutada por el bloque de integración, sobre HTTP.
Webhook Llamada HTTP a una URL receptora del sistema de destino, realizada por el bloque de integración cuando el flujo llega a él.
Base de datos Registro y prueba de conectividad.
Cola de mensajes Registro y prueba de conectividad.
Transferencia de archivos Registro y prueba de conectividad.
gRPC y WebSocket Registro y prueba de conectividad.
Otro Registro libre.

Cada conexión lista recursos con nombre (rutas, con método y payload de ejemplo) y ofrece una prueba de conexión. Para bases de datos, la prueba valida el inicio de sesión y una consulta en PostgreSQL y una conexión TCP en las demás; para colas, Redis responde a PING y las demás reciben una prueba TCP; para SFTP, la prueba lee la identificación del servidor SSH.

Los flujos ejecutan solo conexiones HTTP: REST API, GraphQL y Webhook (una llamada que hace el flujo, no un envío automático de eventos de la plataforma). Las conexiones de bases de datos, colas, transferencia de archivos, gRPC y WebSocket quedan registradas y verificadas, pero los flujos no las ejecutan. Para datos de bases de datos y hojas de cálculo, utilice los contextos de datos de Almacenamiento.

Autenticación

Método Detalle
Ninguno Para API públicas o protegidas por la red.
Clave de API Enviada en un encabezado.
Bearer Token fijo en el encabezado Authorization.
Básica Usuario y contraseña.
OAuth 2.0 client credentials Token obtenido y almacenado en caché por la plataforma.
OAuth 2.0 refresh token Renovación automática; el nuevo refresh token se guarda antes de usarse.

Algunas plantillas de integración tienen firma propia del proveedor, como la firma HMAC-SHA256 de TikTok Shop, las sesiones de Veeam y el OAuth de HPE OpsRamp.

Las credenciales se guardan cifradas en la base de datos (XChaCha20-Poly1305), se descifran solo en el momento de la llamada y nunca llegan al navegador.

Plantillas de integración

El catálogo ofrece más de 99 conectores listos. Ejemplos por categoría:

Categoría Sistemas
E-commerce Amazon Selling Partner, Mercado Livre, Shopify, Meta Product Catalog y TikTok Shop.
Mensajería WhatsApp Cloud API, Telegram Bot API, Twilio y Slack.
Productividad Microsoft 365 (Graph) y Google Workspace.
ERP TOTVS Protheus.
CRM Salesforce.
DevOps Atlassian Jira y Confluence.
ITOM HPE OpsRamp.
Backup Veeam Enterprise Manager.
Seguridad Netskope.
Datos de mercado AwesomeAPI Economia.
Base de datos SAP HANA (registro y prueba de conectividad).

Una plantilla de integración completa la URL base, la autenticación y los recursos más utilizados. Usted proporciona las credenciales y ajusta lo que necesite. Los sistemas fuera del catálogo se registran como conexión personalizada.

Uso en los flujos

  1. Registre la conexión y ejecute la prueba.
  2. En el flujo, agregue un bloque Integración y elija la conexión y el recurso.
  3. Mapee los campos del paso anterior al cuerpo de la solicitud.
  4. Utilice la respuesta en los bloques siguientes, por ejemplo en un bloque de Decisión o de Escritura de datos.

Los sistemas y dispositivos conectados por API participan en los flujos de la misma forma.

Protección de salida

Toda URL que un usuario puede influir (conexiones, URL de proveedores y servidores de inferencia) pasa por una protección contra SSRF:

  • Las direcciones privadas, de loopback, link-local, CGNAT y de metadatos de nube se bloquean de forma predeterminada.
  • Las llamadas de integración no siguen redirecciones.
  • Los hosts internos que la instalación necesita alcanzar, como un sistema de la red corporativa, se habilitan explícitamente en la variable APTABIT_SSRF_ALLOWED_HOSTS de la API, separados por comas.

Capacidades planificadas

Planificado: servidores MCP (Model Context Protocol), scripts en contenedor y webhooks de eventos de la plataforma con firma HMAC. Hoy, la llamada de entrada a un flujo se realiza mediante el endpoint del flujo.

Documentaciónv3.7