¿Cómo configurar un webhook en SIKU?

Los webhooks permiten enviar información automáticamente desde SIKU hacia un sistema externo cuando ocurre un evento específico. Esta funcionalidad facilita la integración entre plataformas al transmitir datos en tiempo real, sin necesidad de realizar consultas manuales.

Para crear un webhook es necesario contar con el permiso INTEGRACIONES - WEBHOOKS.

¿Cómo crear un webhook?

1. Ingresar al módulo INTEGRACIONES.
2. Seleccionar la pestaña CATÁLOGO DE WEBHOOKS.
3. Hacer clic en NUEVO WEBHOOK.
4. Completar la configuración requerida.
5. Guardar los cambios.

¿Qué significa cada campo de configuración?

EVENTO

Corresponde al evento del sistema que activará el envío de información.

URL

Dirección del servicio externo que recibirá la información enviada por SIKU.

TIPO DE OPERACIÓN

Define el método HTTP utilizado para enviar la información.

Opciones disponibles:

• GET
• POST
• PUT
• DELETE
• PATCH

MÁXIMOS INTENTOS

Cantidad de veces que SIKU intentará reenviar la información cuando ocurra un error de comunicación.

Valor recomendado:

• 10 intentos.

TOKEN

Campo opcional utilizado para enviar información de autenticación.

TIPO DE AUTENTICACIÓN

Permite seleccionar el mecanismo de autenticación requerido por el sistema externo.

Opciones disponibles:

• OAuth 2.0
• Token
• X-Token
• Custom Header

FILTROS

Permiten definir condiciones específicas para ejecutar el webhook únicamente cuando se cumplan determinados criterios.

CUERPO DEL REQUEST

Corresponde a la estructura de la información enviada al sistema externo.

Generalmente se utiliza formato JSON.

TIPO DE OBJETO RESPUESTA

Define el formato esperado en la respuesta del servicio externo.

INACTIVO

Cuando esta opción está habilitada, el webhook permanece registrado, pero no ejecutará envíos.

¿Qué eventos pueden activar un webhook?

Expediente

• Actualizar.
• Insertar ficha básica.
• Insertar Pop-Up.

Cita

• Reprogramar.
• Insertar.
• Borrar.
• Marcar como asistida.
• Marcar como 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.