Cómo funcionan los Webhooks en Siku

Un webhook permite que una aplicación envíe datos automáticamente a otra en tiempo real, sin necesidad de realizar consultas manuales. Es utilizado para facilitar la integración entre sistemas, permitiendo recibir actualizaciones instantáneas sobre eventos relevantes.

Creación de Webhooks en Siku

1. El usuario debe tener el acceso al permiso de Integraciones - Webhooks

2. Ir al menú superior y seleccionar Integraciones.

3. Dentro de Integraciones, ingresar a Catálogo de webhooks

4. Hacer clic en el botón Nuevo webhook.

Requisitos para configurar un webhook

• SERVIDOR RECEPTOR: Debe existir un servidor o endpoint web que pueda recibir y procesar solicitudes HTTP enviadas por el webhook.

• URL ACCESIBLE: La URL de destino debe ser pública y accesible desde internet, y estar configurada para aceptar solicitudes HTTP.

• FORMATO DE DATOS: El servidor debe ser capaz de interpretar el formato de los datos enviados, usualmente JSON.

• SEGURIDAD:

  • Usar HTTPS para cifrar las comunicaciones.

  • Implementar mecanismos como validación de firmas, autenticación por token, filtrado de IPs, entre otros.

• MANEJO DE RESPUESTAS: El servidor receptor debe responder con un código HTTP válido (como 200 OK) para confirmar la recepción correcta. En caso de error, la plataforma puede reintentar el envío.

• CONFIGURACIÓN DE EVENTOS: Es posible elegir los eventos específicos que se desean recibir mediante el webhook, por ejemplo: pagos, cambios de estado, actualizaciones de inventario, entre otros.

Eventos para los cuales se disparan Webhooks en Siku:

    Expediente:

• Actualizar

• Insertar ficha básica

• Insertar Pop-Up

  Cita:

• Reprogramar

• Insertar

• Borrar

• Marcar como asistida / no asistida

• Actualizar en directorio

• Insertar en directorio

• Borrar en directorio

• Insertar en sincronización

• Editar en sincronización

• Borrar en sincronización

  Facturación:

• Nueva

• Anular abono

• Agregar abono

• Cotización

• Compra nueva

       Gastos:

• Compra electrónica

Cómo agregar seguridad a los webhooks en Siku

Siku permite configurar diferentes mecanismos de autenticación para proteger el acceso al webhook:

• OAUTH 2.0

• TOKEN

• API KEY (X-TOKEN)

• CUSTOM HEADER