01IA e integraciones · módulo
REST API automática y webhooks
REST API basada en metadatos para cada entidad, con documentación OpenAPI y webhooks incluidos
- Webhook
- Clave de API
- Token de acceso personal
- Registro de accesos
- 10
- capacidades
- 4
- tipos de registro
- 3
- automatizaciones
- 4
- integraciones y herramientas de IA
02Qué hace el módulo
Menos rutina. Más valor.
Draivix genera automáticamente una REST API para cada entidad a partir de los metadatos, sin necesidad de programar endpoints individuales. En cuanto añade un campo, una relación o una entidad, tanto la API como su documentación OpenAPI están disponibles de inmediato, siempre adaptadas a los permisos de quien realiza la llamada. Su empresa puede conectar su tienda online, sus informes o una aplicación a medida a exactamente los mismos datos y reglas que rigen la aplicación.
- API generada automáticamenteLa REST API —la interfaz para conectar sistemas externos— se crea para cada entidad sin programar, incluidas las entidades y campos añadidos por un administrador. Cualquier campo nuevo está disponible de inmediato.
- Operaciones de registro controladasLa API admite listados, vistas de detalle, creación, actualizaciones y borrado lógico, en el que un registro simplemente se marca como eliminado. Los permisos se aplican tanto a nivel de registro como de campo.
- Sin ediciones simultáneas sobrescritasEl bloqueo optimista basado en la versión del registro evita que una actualización sobrescriba otra. Cuando dos sistemas modifican el mismo registro al mismo tiempo, nunca pisan los datos del otro.
- Cambios masivos en una sola transacciónCree hasta 100 registros, actualice hasta 500 y elimine hasta 100 de forma masiva. Los cambios combinados se ejecutan en una única transacción, por lo que nunca se guardan actualizaciones a medias.
- Filtrado sin fugas de informaciónFiltre consultas con cinco notaciones, búsqueda de texto completo y rangos de fechas predefinidos. La API rechaza campos desconocidos, campos sin acceso de lectura u operadores no permitidos, de modo que los filtros nunca exponen datos no autorizados.
- Documentación adaptada a los permisosLa especificación OpenAPI 3.1.2 se genera en función de los permisos del solicitante. Los desarrolladores solo ven las entidades y operaciones que están autorizados a utilizar.
- Autenticación pensada también para agentesObtenga un token iniciando sesión con autenticación de doble factor o firmando con una clave SSH. La segunda opción es ideal para agentes de línea de comandos.
- Límites de tráfico y registro completo de llamadasEl límite es de 240 peticiones por minuto por empresa y usuario, y el registro de accesos guarda cada llamada. Así mantiene una visibilidad total sobre todo el tráfico de la API.
- Envíe datos a donde lo necesiteUn flujo de trabajo envía un webhook —un mensaje automatizado a un sistema externo— mediante una plantilla de cuerpo personalizada. Las URL de destino pasan por protección SSRF para evitar que se abuse del servidor con peticiones a direcciones no autorizadas.
- Datos entrantes verificadosUn webhook entrante recibe datos en un endpoint dedicado y protegido por un secreto compartido en la cabecera. Cada llamada se registra junto con su resultado, para que siempre vea qué ha llegado.
03Cómo funciona
Cómo funciona paso a paso.
Cómo funciona la API automática
La API no tiene código específico por entidad. Un único conjunto de rutas genéricas da servicio a todas las entidades que conoce el sistema. Cuando un administrador añade una entidad, un campo o una relación —o cuando se despliega un nuevo módulo—, la API, la validación y la documentación existen al instante, acotadas a esa empresa y a los permisos del usuario que realiza la llamada.
Leer en detalle
Tres comprobaciones determinan si una entidad es accesible: el indicador de API en la entidad, el módulo habilitado para la empresa y los permisos del solicitante, incluida la política de la clave de API. Una entidad oculta responde con «no encontrado» y ni siquiera revela su existencia. El gestor de contraseñas y las preferencias de usuario no son accesibles a través de la API. Tanto una sesión iniciada en el navegador como un token en la cabecera funcionan bajo las mismas reglas y el mismo registro de auditoría que la aplicación.
Qué puede hacer la API
Cada entidad admite listado, consulta de detalle, creación, actualización total o parcial y borrado lógico. Las actualizaciones parciales admiten bloqueo optimista por versión de registro, lo que evita que dos ediciones simultáneas se sobrescriban mutuamente. También puede consultar la descripción de la entidad (campos, relaciones, acciones), obtener una lista de ID para un conjunto filtrado (hasta 500) y exportar registros (hasta 1.000).
Leer en detalle
De forma masiva, puede crear hasta 100 registros, actualizar hasta 500 y eliminar hasta 100; un lote combinado de creaciones, actualizaciones y eliminaciones se ejecuta en una única transacción. Las agregaciones devuelven sumas, promedios y otras métricas o recuentos agrupados por campo. La API también gestiona relaciones (vincular, desvincular, sincronizar), paneles de registros relacionados, historial de cambios, registros de auditoría, archivos adjuntos, acciones sobre un registro o una selección, conversiones de registros con vista previa, listas de valores y búsqueda global.
Los estados gestionados solo pueden modificarse mediante acciones.
Consultas y filtros
Los filtros pueden escribirse de varias maneras: notación de corchetes, grupos OR, un árbol anidado, expresiones abreviadas como amount>=10000, JSON o un filtro guardado. Se admiten búsqueda de texto completo, ordenación, paginación (20 por defecto, hasta 200 registros por página), selección de campos y carga anticipada de registros relacionados.
Leer en detalle
Los operadores cubren comparaciones, contiene, empieza por, rangos, valores vacíos, selección de múltiples valores, ajustes predefinidos de fecha como este mes o los últimos 30 días, y vínculos con el usuario actual o su equipo. La API rechaza campos desconocidos, campos sin permiso de lectura u operadores no permitidos, de modo que los filtros no pueden utilizarse para sondear datos que el solicitante no tiene permiso para ver.
Documentación, autenticación y límites de peticiones
La especificación OpenAPI 3.1.2 se genera en tiempo de ejecución a partir de los metadatos y desde la perspectiva del solicitante: las entidades y operaciones que no tiene permiso para utilizar se omiten. Los administradores pueden consultarla en el panel de administración mediante el visor Scalar. La validación y la documentación comparten las mismas definiciones, por lo que nunca divergen en las rutas cubiertas.
Leer en detalle
Puede obtener un token iniciando sesión (incluido un código de segundo factor si está habilitado) o firmando con una clave SSH para agentes de línea de comandos. Los usuarios gestionan las claves de API y los tokens MCP en su perfil. El límite de frecuencia es de 240 peticiones por minuto por empresa y usuario; tras 10 intentos fallidos con token por minuto, la dirección IP se limita temporalmente. Cada llamada autenticada mediante token queda registrada en el registro de accesos.
Webhooks
Un webhook saliente es una acción dentro de un flujo de trabajo de Automatización. Se dispara cuando se modifica o elimina un registro, según una programación, manualmente o por un evento de dominio. Envía una petición POST, PUT o PATCH con cabeceras personalizadas y una plantilla de cuerpo. La URL de destino se comprueba mediante protección SSRF, las redirecciones están deshabilitadas y el tiempo de espera máximo es de 30 segundos. Las peticiones no van firmadas; las llamadas fallidas se registran y solo se reintentan en flujos de trabajo atómicos o en acciones configuradas para detenerse ante un error.
Leer en detalle
Un webhook entrante recibe datos en un endpoint dedicado y protegido mediante un secreto compartido en la cabecera. Lo procesa un manejador registrado por el módulo, por ejemplo para captar oportunidades o leads de CRM, grabaciones de llamadas o eventos push de Mattermost. Cada llamada queda registrada junto con su resultado.
04Qué se ejecuta automáticamente
Automatizaciones que ahorran tiempo.
La documentación se mantiene sincronizada con la API
La documentación OpenAPI se genera en tiempo de ejecución a partir de los metadatos y los permisos del solicitante. La validación y la documentación comparten las mismas definiciones, por lo que los endpoints cubiertos nunca quedan desfasados.
Registro automático de accesos
Cada llamada autenticada mediante token se anota automáticamente en el registro de accesos. Al diagnosticar una integración, dispone de una trazabilidad de auditoría fiable.
Webhooks disparados en el momento oportuno
Un flujo de trabajo del módulo de Automatización envía un webhook ante eventos como actualizaciones o eliminaciones de registros, según una programación o manualmente, manteniendo informados a los sistemas externos en tiempo real.
Integraciones externas
- Conecte sus propios sistemasCualquier sistema externo puede conectarse a través de la REST API mediante HTTPS cifrado utilizando un token. Su tienda online, sus herramientas de informes o sus aplicaciones a medida trabajan exactamente con los mismos datos y reglas que la aplicación principal.
- Reciba datos de sistemas de tercerosLos sistemas de terceros envían datos a un webhook entrante, donde un manejador registrado por el módulo los procesa, como oportunidades de CRM entrantes, grabaciones de llamadas o notificaciones push de Mattermost.
- Los flujos de trabajo llaman a sistemas de destinoUn flujo de trabajo envía una petición POST, PUT o PATCH a un sistema de destino con cabeceras personalizadas y una plantilla de cuerpo, notificando al sistema externo cada vez que se produce un cambio relevante.
Lo que gestiona el agente de IA
Las mismas reglas para la IA
Tanto el asistente de IA integrado como los agentes conectados mediante MCP (Model Context Protocol) utilizan las mismas operaciones genéricas sobre entidades que la REST API, aplicando exactamente las mismas comprobaciones de permisos.
Una persona aprueba siempre que haya dinero, un cliente o una excepción de por medio.
05Preguntas frecuentes
¿Dispone Draivix de una REST API?
Sí. La API se genera automáticamente para cada entidad a partir de los metadatos, incluidos los campos y entidades personalizados añadidos por un administrador, y respeta siempre los permisos del solicitante.
¿Dónde puedo encontrar la documentación de la API?
El endpoint /api/openapi.json devuelve una especificación OpenAPI 3.1.2 que los administradores también pueden consultar en el panel de administración. Incluye únicamente las entidades y operaciones que el solicitante tiene permiso para utilizar.
¿Admite Draivix webhooks?
Sí. Los webhooks salientes los envían los flujos de trabajo del módulo de Automatización, mientras que los webhooks entrantes se reciben en un endpoint dedicado protegido mediante un secreto compartido.
¿Cuáles son los límites de peticiones de la API?
El límite es de 240 peticiones por minuto por empresa y usuario, una página de listado devuelve hasta 200 registros y una exportación devuelve hasta 1.000 registros.
- Automatización y flujos de trabajoReglas sin código «cuando ocurra X, haz Y» y registros recurrentes programados
- MCP para agentes de IA externosConecte Claude Code, Codex y otros agentes a su ERP bajo los permisos de un usuario específico
- Asistente de IA en DraivixUn asistente integrado que busca datos, prepara borradores de cambios y los guarda cuando usted lo confirma
- OAuth2 y OIDC para complementosInicio de sesión seguro de complementos en Draivix mediante OAuth2 y OpenID Connect con PKCE
- CRM y pipeline de ventasProspectos, leads y oportunidades de venta con fases controladas, previsiones y flujo de caja
- Asistente de voz y transcripción de voz a textoDicte consultas, transcriba grabaciones y trabaje con su ERP por voz a través del asistente de IA
- Importación de tienda online desde WooCommerceCarga su catálogo, clientes y pedidos desde WooCommerce y envía las descripciones de productos de vuelta a la tienda online
- Migración y ejecución en paralelo con EspoCRMCompara y sincroniza registros con EspoCRM durante la migración o el funcionamiento en paralelo
- GitLab y tareas de desarrolloVincula commits y merge requests de GitLab con las tareas y pasa las tareas a revisión
Empecemos juntos
Cuéntenos cómo funciona su empresa.
Le mostraremos cómo podría ser un sistema que asuma parte de ese trabajo.
Reservar una consulta