Los Servicios de Integración de Ágora se activan desde la Administración del servicio siguiendo la siguiente ruta: Estado del servidor de Ágora → Herramientas → Activar módulos adicionales → Módulo de servicios de integración Una vez activado este módulo, estarán disponibles las siguientes opciones de configuración:

Opciones de configuración del módulo

Habilitar integración

Al marcar esta opción, Ágora habilita su API HTTP para la importación y exportación de datos con sistemas externos.

• Clave Se debe definir una clave o token de autenticación, que será obligatoria en todas las peticiones realizadas contra la API. Este token actúa como mecanismo de seguridad y control de acceso.

Sistemas de fidelización

Esta opción permite integrar Ágora con un sistema externo de fidelización de clientes. Incluye los siguientes endpoints configurables:

• URL para validación de participantes Endpoint al que Ágora realizará una llamada para validar si un cliente forma parte del sistema de fidelización (por ejemplo, identificación por tarjeta, teléfono o código).
• URL para envío de facturas Endpoint al que Ágora enviará la información de las facturas generadas para su tratamiento en el sistema de fidelización (acumulación de puntos, recompensas, etc.).

Creación de documentos con sistemas externos

Esta funcionalidad permite a Ágora delegar la creación o validación de documentos en un sistema externo, mediante el uso de webhooks.

• URL para envío y validación de documentos Endpoint externo al que Ágora enviará la información del documento (factura, albarán o pedido).

Funcionamiento del webhook

1. Ágora envía el documento al sistema externo mediante una llamada HTTP.
2. El sistema externo procesa la información.
3. Ágora espera la respuesta del sistema externo para continuar el flujo.
4. En función de la respuesta recibida, Ágora confirma, rechaza o modifica el documento.

Este mecanismo permite integrar lógica externa como:

• Validaciones fiscales
• Numeraciones propias
• Integraciones contables
• Flujos de aprobación

Tipos de documentos

Dentro de esta integración se puede seleccionar qué documentos serán enviados al sistema externo:

• ⬜ Enviar facturas
• ⬜ Enviar albaranes
• ⬜ Enviar pedidos

Cada tipo de documento genera su correspondiente llamada al webhook configurado.