Saltar al contenido

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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  1. 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.

  2. 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.

  3. 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.

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