Webhooks en Itcons.app: configuración y eventos

Los webhooks de Itcons.app permiten avisar automáticamente a otro sistema cuando ocurre una acción relevante dentro de la plataforma. Son útiles para conectar Itcons.app con ERPs, CRMs, herramientas internas, plataformas de automatización o cualquier aplicación que pueda recibir una petición HTTP en una URL destino.

Dónde se activan los webhooks

Los webhooks se configuran desde el panel de configuración del sitio:

1. Entra en Configuración.
2. Abre la sección Integraciones.
3. Selecciona Webhook.
4. Crea o edita el webhook que quieras activar.

URL destino obligatoria

Para que un webhook funcione, debes indicar la URL destino. Esta URL es el endpoint externo al que Itcons.app enviará la información cuando se produzca el evento configurado.

La URL destino debe pertenecer al sistema que va a recibir el aviso. Por ejemplo, puede ser una URL de tu ERP, una aplicación propia, un escenario de Make, un Zap de Zapier o un servicio intermedio preparado para procesar la información.

Ejemplo de URL destino:
https://tu-dominio.com/webhooks/itcons

Webhooks por modelo

Itcons.app permite configurar webhooks vinculados a los modelos. De esta forma, puedes lanzar automatizaciones cuando un documento o flujo asociado a un modelo cambia de estado.

Los eventos disponibles por modelo son:

• Enviado: se activa cuando el modelo o documento se envía.
• Aceptado: se activa cuando el modelo o documento queda aceptado.
• Rechazado: se activa cuando el modelo o documento se rechaza.
• Firmado: se activa cuando el modelo o documento queda firmado.

Estos eventos son especialmente útiles cuando necesitas que otro sistema se entere de forma automática de que un parte, albarán, documento o proceso ha cambiado de estado.

Webhooks para otras entidades

Además de los eventos por modelo, los webhooks pueden utilizarse con otras entidades importantes de Itcons.app:

• Proyectos: para comunicar altas, cambios o información relacionada con proyectos.
• Clientes: para sincronizar datos de clientes con otros sistemas.
• Recursos: para integrar información de empleados, operarios, equipos u otros recursos gestionados en la plataforma.
• Órdenes de trabajo: para conectar la creación, actualización o evolución de órdenes de trabajo con herramientas externas.

Para qué sirven en la práctica

Los webhooks evitan tener que revisar manualmente Itcons.app para saber si algo ha cambiado. En lugar de consultar una y otra vez, el sistema externo recibe un aviso cuando ocurre el evento.

• Enviar a un ERP la información de un albarán firmado.
• Avisar a un CRM cuando se crea o actualiza un cliente.
• Activar una automatización cuando una orden de trabajo cambia de estado.
• Registrar en otro sistema que un documento ha sido enviado, aceptado, rechazado o firmado.

Buenas prácticas

• Utiliza una URL destino estable y accesible desde internet.
• Comprueba que el sistema receptor puede procesar la información que envía Itcons.app.
• Evita usar URLs temporales en automatizaciones críticas.
• Protege el endpoint destino si contiene información sensible.
• Revisa los webhooks activos cuando cambien tus procesos internos o tus integraciones externas.

Resumen

Para configurar un webhook en Itcons.app, entra en Configuración → Integraciones → Webhook, selecciona el tipo de evento que quieres automatizar e indica la URL destino del sistema que recibirá la información. Puedes trabajar con eventos por modelo como enviado, aceptado, rechazado o firmado, y también con entidades como proyectos, clientes, recursos y órdenes de trabajo.