Los webhooks le permiten ampliar las capacidades de automatización de Omnisend conectando sistemas y servicios externos. Le permiten activar eventos en otras plataformas o enviar datos en tiempo real, mejorando la funcionalidad de sus flujos de trabajo de automatización.

En esta guía, le mostraremos cómo configurar y usar webhooks en las automatizaciones de Omnisend, con ejemplos y casos de uso.

⚠️ Disponibilidad del Plan: Los webhooks en Automatizaciones están disponibles solamente en planes de pago. Para usar esta función, actualice su Plan en Configuración de la Tienda → Facturación.

⚠️ Importante: La implementación de webhooks requiere un esfuerzo significativo de su parte y a menudo requiere la participación de un desarrollador. Es posible que necesite preparar puntos finales de API dedicados, manejar payloads y asegurar una Integración adecuada entre Omnisend y sistemas externos.

¿Qué son los webhooks?

Los webhooks son devoluciones de llamada HTTP que envían datos en tiempo real desde Omnisend a otros servicios cuando ocurren eventos de automatización específicos. Esto le permite:

Notificar a sistemas de terceros sobre eventos de automatización.
Envía mensajes personalizados a través de plataformas como WhatsApp.
Trigger flujos de trabajo personalizados en CRMs, herramientas de gestión de proyectos o plataformas de comunicación como Slack.

Analogía 💡 Un sistema de avisador de restaurante

Imagine que está en un restaurante y le dan un avisador para notificarle cuando su mesa esté lista. Este avisador es como un webhook, que le alerta sobre eventos específicos sin que tenga que comprobarlo manualmente.

Comprendiendo la estructura y los componentes de los webhooks

Al configurar webhooks en Omnisend, es crucial comprender los componentes clave involucrados en la configuración de una solicitud de webhook.

Esta sección desglosa la estructura y los componentes que encontrará al editar un webhook en Omnisend:

Componente 1. URL de webhook

La URL es el punto final de destino donde se enviarán los datos de su webhook. Este es típicamente un sistema o servicio externo que manejará y procesará los datos enviados desde Omnisend.
Ejemplo: https://api.yourservice.com/webhook-endpoint

¡Importante! ⚠️Asegúrese de que esta URL sea correcta y accesible. Si el servicio receptor requiere comunicación segura, asegúrese de que la URL comience con https:// for encrypted transmission.

Componente 2. Encabezados

Los webhooks le permiten incluir encabezados adicionales con su solicitud. Los encabezados son pares clave-valor que contienen metadatos sobre la solicitud de webhook o sirven como autenticación para el sistema receptor.
Clave. El nombre del encabezado (p. ej., Autorización, Content-Type).
Valor. El valor asociado con la clave del encabezado (p. ej., Bearer your_access_token, application/json).
Ejemplo de encabezados:
- Authorization: Bearer your_access_token
- Content-Type: application/json
Caso de uso común. Si su servicio receptor requiere autenticación, como una Clave API o un token, lo pasaría en los encabezados.

Consejo 💡 Siempre valide que los encabezados necesarios estén configurados correctamente para evitar solicitudes no autorizadas o fallidas.

Componente 3. Cuerpo

El Cuerpo es donde se envían los datos reales (carga útil). Contiene la información relevante que desea pasar al sistema externo, como detalles del cliente, información del pedido o activadores de eventos específicos.
Formato. El cuerpo suele estar estructurado en formato JSON, lo que permite a la mayoría de los servicios manejarlo y leerlo fácilmente.

Ejemplo de cuerpo (carga JSON):

{ "customer_name": "[[contact.first_name]]", "email": "[[contact.email]]", "order_value": "[[event.raw._total_price]]", "purchase_time": "[[event.raw.created_at]]" }

Personalizando el cuerpo. Puede adaptar la carga útil para incluir solo los datos específicos que necesita el servicio receptor. Omnisend proporciona variables (p. ej., [[contact.email]]) que inserta datos dinámicamente de su automatización en la carga útil. Más detalles sobre qué datos están disponibles aquí

⚠️ Importante! Asegúrese de que la estructura del cuerpo coincida con lo que espera el punto final receptor. Esto incluye el formato adecuado (JSON, XML, etc.) y los nombres de los campos.

Probando el webhook

Después de configurar la URL, los encabezados y el cuerpo, es esencial probar el webhook para verificar que los datos se envían correctamente. Asegúrese siempre de que la respuesta del sistema receptor sea la esperada y de que no haya errores en la transmisión.

Cómo configurar webhooks en las automatizaciones de Omnisend

Paso 1. Crear un Flujo de Automatización
Comience creando una nueva automatización o editando una existente dentro de Omnisend.

Paso 2. Añadir una acción de webhook
En su flujo de automatización, arrastre y suelte un bloque 'Webhook' en el punto donde desea que se active el evento externo.

Paso 3. Configurar la URL y los encabezados del webhook
Introduzca la URL del webhook del sistema externo, que recibirá los datos. Esto podría ser un CRM, una herramienta de comunicación o un servicio de API como la API de WhatsApp Business. Los encabezados son pares clave-valor que contienen metadatos sobre la solicitud de webhook o sirven como autenticación para el sistema receptor.

Paso 4. Mapear la carga útil
Personalice la carga de datos que desea enviar con el webhook. Omnisend le permite pasar detalles del cliente, información del pedido u otros datos relevantes.

Paso 5. Probar el webhook
Después de configurarlo, pruebe el webhook para asegurarse de que el sistema externo envía y recibe datos correctamente.

Verifique:

El sistema externo recibe los datos.
El código de respuesta es 200 OK.
No aparecen errores en Omnisend ni en los registros externos.

Poner en lista blanca las IP estáticas de webhook

Para mejorar la seguridad de sus integraciones de webhook, Omnisend utiliza un conjunto dedicado de direcciones IP estáticas para todas las solicitudes de webhook salientes. Puede incluir estas IP en la lista blanca de su firewall, puerta de enlace de API o configuración de endpoint para asegurarse de que solo se acepten las solicitudes de Omnisend.

¿Por qué poner en lista blanca las IP de webhook?

Poner en lista blanca las IP estáticas de Omnisend proporciona una capa de seguridad adicional al:

Prevenir solicitudes no autorizadas – Solo el tráfico de las IP de Omnisend puede llegar a su punto final de webhook.
Reducir los riesgos de suplantación de identidad – Bloquea a los actores maliciosos que intentan imitar las llamadas de webhook de Omnisend.
Cumplir con los requisitos de cumplimiento – Admite políticas de seguridad empresariales que requieren control de acceso basado en IP.

Lista de IP estáticas de Webhook de Omnisend

Añada las siguientes IP a su configuración de lista blanca:

34.170.162.11 
34.56.62.59 
34.56.108.215 
34.133.59.36 
34.58.66.146 
35.184.130.5 
35.232.14.89

Importante ⚠️ Estas IP son utilizadas exclusivamente por Omnisend para solicitudes de webhook enviadas desde los flujos de trabajo de automatización. Asegúrese de que su firewall o la configuración de su API permita el tráfico entrante desde estas direcciones.

Nota: Si no está seguro de cómo configurar el IP whitelisting, consulte a su equipo de desarrollo o al administrador del sistema.

Enviar un mensaje a través de Slack usando webhooks

Slack se puede integrar con Omnisend para enviar notificaciones a canales específicos cuando ocurre un evento de automatización.

Paso 1. Crear un webhook entrante en Slack.

Vaya a Slack API y configure un webhook entrante.
Elija un canal donde se enviarán los mensajes.
Copie la URL del webhook proporcionada por Slack.
Activadores de Webhook en Slack

Paso 2. Añadir el Webhook a la Automatización de Omnisend.

En su flujo de Omnisend, inserte el bloque de webhook en el punto deseado de su automatización.
Introduzca la URL del webhook de Slack.
Personalice el Payload. Defina el formato del mensaje que le gustaría enviar. Para Slack, el payload podría verse así:

{ "text": "A new subscriber has joined! ðŸŽ‰", "attachments": [ { "title": "Subscriber Details", "text": "Name: [[contact.first_name]] \n Email: [[contact.email]]" } ] }

Probar la Integración. Habilite la automatización y revise el canal de Slack para confirmar que el mensaje se envió correctamente.

Envío de contactos a Postscript desde Omnisend a través de Webhooks de Automatización

Paso 1. Obtención de su Clave API de Postscript

Diríjase a su cuenta de Postscript.
Haga clic en su nombre en la esquina superior derecha y elija API.
- Si aún no ha creado un par de Claves API, haga clic en Crear par de Claves de seguridad para generar uno.
- Copie la Clave privada y guárdela en un lugar seguro, ya que la necesitará más tarde.

Paso 2. Creación de una palabra clave en Postscript

En Postscript, haga clic en Palabras clave en el lado izquierdo.
Haga clic en Crear palabra clave en la esquina superior derecha.
Nombra tu palabra clave y decide si incluir un cupón en la respuesta.
Para editar la respuesta:
- Haga clic en el cuadro morado Responder o cree una respuesta automática haciendo clic en Añadir acción, luego personalice el mensaje de respuesta.
- Esta Respuesta por Palabra Clave se enviará inmediatamente cuando un usuario se suscribe mediante su palabra clave.

Paso 3. Obtener el ID de palabra clave

Visite la documentación de la API de Postscript: Postscript Get Keywords.
Introduzca su Clave privada en el encabezado y haga clic en Probar para encontrar el ID de palabra clave que desea utilizar para los contactos procedentes de Omnisend.

Paso 4. Configuración de la Automatización en Omnisend

Trigger de Automatización. Utilice el trigger "Contacto Entra en Segmento" para pasar contactos a Postscript.
Bloque de Webhook.
- Añada un bloque de Webhook a su flujo de automatización.
- Para URL, use: https://api.postscript.io/api/v2/subscribers.
- Para Encabezados, añada:
  - Authorization: Bearer
  - accept: application/json

Cuerpo. Incluya la siguiente información en el cuerpo de la solicitud:

{ "origin": "other", "properties": { "VIP": true }, "phone_number": "[[contact.phone_number]]", "email": "[[contact.email]]", "keyword_id": "<keywordID obtained previously>", "tags": [ "source:omnisend" ] }

Reemplace con su ID de palabra clave real.
Puede usar "origin": "website", "social" o "other".

Paso 5. Habilitar la Automatización

Habilite la automatización y pruébela añadiendo un contacto de prueba con un número de teléfono a su segmento.
Verifique si los contactos en el flujo se están pasando correctamente a Postscript.

Siguiendo estos pasos, podrá enviar contactos desde Omnisend a Postscript a través de webhooks de automatización.

Envío de mensajes de WhatsApp mediante Webhooks

La integración de WhatsApp requiere el uso de la API de WhatsApp Business o un servicio de terceros. A continuación se detallan los pasos para integrar la mensajería de WhatsApp mediante webhooks.

Paso 1. Configurar la API de WhatsApp Business.

Regístrese para la API de WhatsApp Business a través de Facebook.
Siga el proceso de configuración, que incluye alojar la API en su servidor o usar un servicio de terceros.
Obtenga las credenciales de la API requeridas.

Paso 2. Configure Webhooks en Omnisend.

Añada un bloque de webhook en su flujo de automatización de Omnisend.
Introduzca la URL del punto final de la API de WhatsApp Business como el webhook.

Construye la solicitud HTTP.Para enviar mensajes a través de WhatsApp, construye una solicitud HTTP POST con la carga útil necesaria. Ejemplo usando cURL:

curl -X POST https://graph.facebook.com/v14.0/YOUR_PHONE_NUMBER_ID/messages \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "messaging_product": "whatsapp", "to": "RECIPIENT_PHONE_NUMBER", "type": "text", "text": { "body": "Hello, this is a test message from the WhatsApp Business API." } }'

Paso 3. Prueba la Integración. Ejecuta tu automatización para asegurar que el mensaje de WhatsApp se envíe correctamente.

Envío de Datos a un Endpoint de API Personalizado

En algunos casos, es posible que desee enviar datos de eventos a un endpoint de API personalizado, como su propio sistema CRM o plataforma de gestión de pedidos.

Paso 1. Crear un Endpoint de API Personalizado. Trabaje con su equipo de desarrollo para crear un endpoint de API que pueda recibir datos de webhook de Omnisend.

Paso 2. Añada el Webhook en Omnisend. Inserte el bloque de webhook en la automatización deseada e introduzca la URL del endpoint de API personalizado.

Personalice la Carga Útil. La carga útil puede incluir cualquier dato disponible de la automatización, como detalles del cliente, información del pedido o datos de la campaña. Ejemplo:

{ "customer_name": "[[contact.first_name]]", "email": "[[contact.email]]", "order_value": "[[event.raw._total_price]]", "purchase_time": "[[event.raw.created_at]]" }

Paso 3. Probar y Activar. Pruebe el webhook para asegurarse de que los datos se envían correctamente a su endpoint de API personalizado.

Uso de Webhooks para Notificaciones de Acción

Estas instrucciones le ayudarán a configurar webhooks para recibir notificaciones de diversas acciones, como cuando un cliente compra un producto específico, solicita un reembolso o hace clic en un enlace particular en un correo electrónico. Los webhooks le permiten crear eventos personalizados en función de las acciones de sus contactos. Así es como suele funcionar:

Contacto realiza una acción: Un contacto activa un evento, por ejemplo, al hacer clic en un enlace en un correo electrónico.
Entrada a la Automatización: El contacto entra en un flujo de automatización. Esto puede comenzar cuando entra en un segmento específico.
Webhook envía evento personalizado: Un webhook envía un evento personalizado sobre la acción realizada por el primer contacto a una dirección de correo electrónico interna especificada.
Segunda Automatización Activada: El contacto especificado entra en una segunda automatización, en la que usted recibe notificaciones sobre la acción realizada por el primer contacto.

Ejemplo

En nuestro ejemplo, nos enviaremos una notificación por correo electrónico cada vez que alguien haga clic en un enlace específico dentro de un correo electrónico.

Paso 1. Configuración de la Primera Automatización

Definir la Acción:
- Configure su trigger para la automatización. Esto puede incluir cualquier acción, como entrar en un segmento o hacer clic en un botón promocional.
- Para nuestro ejemplo, queremos saber cuándo alguien hace clic en un botón específico en una actividad de marketing.
Añadir un bloque de Webhook:
- En su flujo de automatización, añada un bloque Webhook para enviar un evento personalizado al contacto especificado.

Configuración de Webhook

URL:
https://api.omnisend.com/v5/events
Encabezados:
- Clave: x-api-key
- Valor: (reemplace con su Clave API real)
Cuerpo:

{ 
"eventName": "Click notification",
"origin": "api",
"contact": {
 "email": "[email protected]"
 }, 
"properties": {
"clicker_email":"[[contact.email]]",
"clicker_fname":"[[contact.first_name]]",
"clicker_lname":"[[contact.last_name]]"
}}

Nota importante sobre la configuración del cuerpo:

eventName: Puede nombrar este evento como desee. Se utilizará para activar la segunda automatización.
origen: Debe establecerse en "api".
Contacto → correo electrónico: Esto especifica el contacto que recibirá el evento personalizado y la notificación sobre la acción realizada por el primer contacto.
properties: Esta es una lista opcional de detalles que puede incluir sobre el primer contacto. En este caso, estamos recopilando su dirección de correo electrónico, nombre y apellido.

Paso 2. Configuración de la Segunda Automatización

Selecciona el Trigger:
- Elija el eventName del paso anterior como el trigger de automatización.
Añadir detalles de la notificación:
- En esta automatización, puede configurar una notificación por correo electrónico o SMS utilizando los detalles recopilados de la primera automatización, como el correo electrónico y el nombre del contacto.

Esta configuración de webhook le permite notificar a un solo contacto sobre acciones específicas realizadas por cualquier otro contacto dentro de Omnisend. Si tiene alguna otra pregunta o necesita ayuda, póngase en contacto con nuestro equipo de soporte.

Los webhooks ofrecen flexibilidad para extender sus automatizaciones de Omnisend, permitiendo la comunicación con plataformas externas en tiempo real. Ya sea que esté enviando mensajes a través de Slack, WhatsApp o plataformas de SMS como Postscript, el proceso es similar - configurando una URL de webhook, definiendo un payload y probando la integración. Sin embargo, tenga en cuenta que la integración de webhooks a menudo requiere recursos de desarrollo, especialmente para configuraciones de API personalizadas.

Tenga en cuenta 💡 La integración de webhooks a menudo requiere recursos de desarrollo, especialmente para configuraciones de API personalizadas, así que asegúrese de contar con el soporte necesario.

Preguntas Frecuentes

¿Cuándo debo usar webhooks vs. integraciones nativas?
Utilice webhooks para plataformas sin una Integración directa con Omnisend o cuando necesite mapeo de datos personalizado.

¿Puedo probar los webhooks antes de habilitar la automatización?
Sí – Probar el Webhooko herramientas como Postman para enviar solicitudes de prueba.

Hay límites de velocidad?
Los límites dependen del servicio externo; consulte su documentación de API.

¿Puedo poner en lista blanca las IPs de webhook de Omnisend para seguridad?
Sí. Omnisend utiliza un conjunto dedicado de direcciones IP estáticas para todas las solicitudes de webhook enviadas desde los flujos de trabajo de Automatización. Añadir estas IP a la lista blanca añade una capa de seguridad adicional al asegurar que solo Omnisend pueda acceder a su punto final. Ver la lista completa de IP

¿Qué datos puedo usar en las cargas útiles de webhook?
Puede utilizar cualquier atributo de contacto o dato de un evento que active la automatización. Para más información, consulte aquí

¿Qué plan necesito para usar webhooks en Automatizaciones?

Los webhooks están disponibles en todos los planes de pago. Si está en el plan gratuito y quiere usar webhooks, necesita actualizar primero. Vaya a Configuración de la Tienda → Facturación para gestionar su Plan.

Si necesita ayuda para configurar sus webhooks, no dude en ponerse en contacto con nuestro galardonado equipo de Soporte al Cliente. Puede encontrarnos a través del chat en la aplicación o en [email protected].

Usar Webhooks en Automatización