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
- Registre la conexión y ejecute la prueba.
- En el flujo, agregue un bloque Integración y elija la conexión y el recurso.
- Mapee los campos del paso anterior al cuerpo de la solicitud.
- 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_HOSTSde 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.
