¿Cómo enviar los datos de los Modales de Sitios a otro sistema mediante un Webhook?

Los Modales de Sitios permiten recolectar información de los usuarios a través de distintos formularios y almacenar esos datos en icomm. Además, es posible utilizar Webhooks para enviar automáticamente la información recolectada a otro sistema.
Esta funcionalidad permite conectar los formularios de captura de icomm con CRMs, ERPs, plataformas de automatización, bases de datos propias u otros sistemas externos que puedan recibir solicitudes HTTP.
El envío se realiza automáticamente cada vez que un usuario completa un formulario, sin necesidad de realizar exportaciones o cargas manuales de información.

¿En qué Modales puedo utilizar un Webhook?

Los Webhooks pueden utilizarse en los Modales que permiten capturar datos de los usuarios, por ejemplo:

Pop-up de suscripción: para enviar los nuevos registros a un CRM o plataforma de gestión de leads.
Modal embebido: para conectar los formularios integrados dentro del sitio con otros sistemas.
Pop-up de carrito abandonado: para enviar los datos capturados de usuarios que dejaron productos en su carrito.
Otros modales que cuenten con un formulario de captura de información.

De esta manera, la información recolectada desde diferentes puntos del sitio puede llegar automáticamente al sistema donde el negocio necesita gestionarla.

¿Qué beneficios tiene utilizar un Webhook?

Configurar un Webhook permite:

Automatizar el envío de datos: la información se transmite automáticamente cada vez que se completa un formulario.
Evitar cargas manuales: no es necesario exportar e importar periódicamente los contactos.
Conectar diferentes sistemas: permite integrar los datos capturados en Sitios con herramientas externas.
Actuar rápidamente sobre los datos: el sistema receptor puede utilizar la información inmediatamente después de recibirla.
Centralizar procesos: los datos captados desde diferentes formularios pueden alimentar los sistemas que utiliza el negocio para gestionar sus contactos y clientes.
Crear flujos automatizados: la recepción de un nuevo registro puede utilizarse como disparador para acciones posteriores en el sistema externo.

Casos de uso

Captación de nuevos suscriptores:

Un usuario completa el Pop-up de suscripción para recibir novedades de la marca.
Con el Webhook, sus datos pueden enviarse automáticamente al CRM del cliente para que el equipo comercial o de marketing pueda continuar trabajando ese nuevo lead.
Ejemplo:

Usuario completa el formulario → icomm recibe los datos → Webhook los envía al CRM → el contacto ingresa automáticamente al proceso de gestión de leads.

Integración con un CRM:

Una empresa utiliza un formulario embebido para captar datos de potenciales clientes.
Al completar el formulario, la información puede enviarse directamente al CRM para crear o actualizar el registro del contacto.
Esto permite que el equipo comercial tenga acceso a los datos sin depender de una carga manual.

Gestión de carritos abandonados:

Un usuario agrega productos al carrito y, antes de finalizar la compra, completa el formulario del Pop-up de carrito abandonado.
Los datos capturados pueden enviarse a otro sistema para activar procesos adicionales, como la creación de un registro, una notificación interna o una acción comercial.

Conectar formularios con una herramienta propia:

Si el cliente cuenta con un sistema desarrollado internamente, puede utilizar el Webhook para enviarle los datos capturados desde Sitios y procesarlos según sus propias reglas de negocio.

¿Qué necesitas para configurar un Webhook?

Antes de realizar la configuración, necesitas contar con:

Una URL o endpoint público del sistema que recibirá la información.
Un sistema preparado para recibir solicitudes HTTP POST.
Definir qué información del formulario necesita recibir el sistema externo.
Contar con las credenciales o información de autenticación que requiera el sistema receptor, en caso de que corresponda.

Importante: El sistema externo debe estar preparado para recibir y procesar la información enviada por icomm. La configuración del endpoint y su procesamiento corresponde al sistema receptor.

¿Cómo configurar un Webhook?

Una vez creado y configurado el Modal:

Ingresa a Personalización > Sitios > Modales.
Selecciona el Sitio donde se encuentra el Modal que deseas configurar.
Ingresa a la configuración del Modal.
Dirígete a la sección Webhooks.
Activa el interruptor de Webhooks.
Haz clic en Agregar webhook.
Completa los siguientes campos:

Nombre: ingresa un nombre que te permita identificar el Webhook.
Por ejemplo: CRM - Nuevos suscriptores.
URL: ingresa la URL del endpoint que recibirá los datos.
La URL debe comenzar con https://.

Guarda la configuración del Modal.

A partir de ese momento, cada vez que un usuario complete el formulario, icomm enviará automáticamente la información capturada a la URL configurada.
Puedes configurar más de un Webhook si necesitas enviar la información a diferentes sistemas.

Seguridad

Las solicitudes enviadas mediante Webhook incluyen encabezados que permiten al sistema receptor validar que la solicitud proviene de icomm:

Webhook-Id: identificador único de la solicitud, utilizado para evitar procesamientos duplicados.
Webhook-Timestamp: fecha del envío en formato Unix seconds.
Webhook-Signature: firma HMAC-SHA256 codificada en Base64.

La firma se calcula utilizando:

{Webhook-Id}.{Webhook-Timestamp}.{cuerpo JSON original}

El sistema receptor debe utilizar el secreto proporcionado para calcular la firma HMAC-SHA256 y compararla con la firma recibida.
Como buenas prácticas de seguridad, se recomienda:

Rechazar solicitudes cuyo Webhook-Timestamp tenga más de 5 minutos de diferencia.
No procesar dos veces el mismo Webhook-Id.
Validar la firma utilizando el cuerpo HTTP original, antes de parsear o volver a serializar el JSON.

Webhook vs. Registrar contacto en CDP

Es importante diferenciar ambas funcionalidades:

Funcionalidad	¿Para qué sirve?
Registrar contacto en CDP	Incorpora los datos capturados al ecosistema de datos de icomm para centralizarlos y utilizarlos dentro de la plataforma.
Webhook	Envía los datos capturados a un sistema externo para que ese sistema pueda procesarlos.
Ambas opciones pueden utilizarse de manera complementaria, dependiendo de la estrategia y las necesidades de integración del cliente.