Ir al contenido principal

Usar Webhooks en Automatización

Los Webhooks envían datos en tiempo real desde Omnisend a sistemas externos como Slack, WhatsApp o CRMs. Aprenda cómo configurar, probar y usar webhooks en flujos de trabajo de automatización.

Escrito por Ira

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.

4a1 Analogeda: Un sistema de paginacin 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.

f6a8 Importante:a0 Asegrate de que esta URL sea correcta y accesible. Si el servicio receptor requiere comunicacin segura, asegrate de que la URL comience conhttps:// 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.

4e1 Consejo:Siempre valida 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. Encuentra más detalles sobre qué datos están disponibles

f6a8 Importante:a0 Asegrate 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. Siempre asegrate de que la respuesta del sistema receptor sea la esperada y de que no haya errores en la transmisin.

Cómo configurar Webhooks en las automatizaciones de Omnisend

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

Paso 2. Agregar una acción de Webhook
En tu flujo de automatización, arrastra y suelta un bloque de 'Webhook' en el punto donde deseas que el evento externo se active.

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 del webhook o sirven como autenticacin para el sistema receptor.

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

Paso 5. Probar el Webhook
Después de configurarlo, prueba el webhook para asegurarte de que el sistema externo esté enviando y recibiendo datos correctamente.

Verificar:

  • 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. Puedes agregar estas IPs a la lista blanca en tu firewall, puerta de enlace API o configuración de endpoint para asegurar que solo se acepten solicitudes de Omnisend.

¿Por qué incluir las IPs de Webhook en la lista blanca?

La inclusión en la lista blanca de las IPs estáticas de Omnisend proporciona una capa adicional de seguridad al:

  • Prevenir solicitudes no autorizadas Solo el tráfico de las IPs de Omnisend puede alcanzar tu punto final de webhook.

  • Reducir riesgos de suplantación Bloquea a actores maliciosos que intentan imitar las llamadas de webhook de Omnisend.

  • Cumplir con los requisitos de cumplimiento Soporta políticas de seguridad empresarial que requieren control de acceso basado en IP.

Lista de IPs estáticos de Webhook de Omnisend

Agrega las siguientes IPs a tu 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 IPs son utilizadas exclusivamente por Omnisend para solicitudes de webhook enviadas desde Automatización Workflows. Asegúrate de que tu firewall o configuración de API permita el tráfico entrante desde estas direcciones.

Nota: Si no estás seguro de cómo configurar la lista blanca de IP, consulta a tu equipo de desarrollo o al administrador del sistema.

Enviando 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 de entrada en Slack.

  • Ve a la API de Slack y configura un webhook entrante.

  • Elige un canal donde se enviarán los mensajes.

  • Copia la URL del webhook proporcionada por Slack.

Paso 2. Agrega el Webhook a la Automatización de Omnisend.

  • En tu flujo de Omnisend, inserta el bloque de webhook en el punto deseado de tu automatización.

  • Ingresa la URL del webhook de Slack.

  • Personaliza la Carga Útil.a0 Define el formato del mensaje que deseas enviar. Para Slack, la carga útil podría verse así:

{ "text": "A new subscriber has joined! 🎉", "attachments": [ { "title": "Subscriber Details", "text": "Name: [[contact.first_name]] \n Email: [[contact.email]]" } ] }
  • Prueba la Integración. Habilita la automatización y verifica el canal de Slack para confirmar que el mensaje se envió correctamente.

Enviando contactos a Postscript desde Omnisend a través de Webhooks de Automatización.

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

  1. Navega a tu cuenta de Postscript.

  2. Haz clic en tu nombre en la esquina superior derecha y elige API.

    • Si aún no ha creado un par de claves API, haga clic en Crear par de claves de seguridad para generar uno.

    • Copia la Clave Privada y guárdala en un lugar seguro, ya que la necesitarás más tarde.

      3038

Paso 2. Crear una Palabra Clave en Postscript

  1. En Postscript, haz clic en Palabras Clave en el lado izquierdo.

  2. Haz clic en Crear Palabra Clave en la esquina superior derecha.

  3. Nombra tu palabra clave y decide si incluir un cupón en la respuesta.

  4. Para editar la respuesta:

    • Haz clic en la caja Responder morada o crea una respuesta automática haciendo clic en Agregar Acción, luego personaliza el mensaje de respuesta.

    • Esta Respuesta de Palabra Clave se enviará inmediatamente cuando un usuario se suscriba a través de tu palabra clave.

Paso 3. Obtener el ID de la Palabra Clave

  1. Visita la documentación de la API de Postscript: Postscript Obtener Palabras Clave.

  2. Ingresa tu Clave Privada en el encabezado y haz clic en Probar para encontrar el ID de Palabra Clave que deseas usar para los contactos que vienen de Omnisend.

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

  1. Trigger de Automatización. Utilice el trigger "Contacto Entra en Segmento" para pasar contactos a Postscript.

  2. Bloque de Webhook.

  3. Cuerpo. Pasa 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" ] }
    • Reemplaza con tu ID de palabra clave real.

    • Puedes usar "origin": "website", "social", o "other".

Paso 5. Habilitando la Automatización.

  1. Habilita la automatización y pruébala añadiendo un contacto de prueba con un número de teléfono a tu segmento.

  2. Verifica si los contactos en el flujo se están pasando correctamente a Postscript.

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

4a1 Una prueba exitosa confirma que el punto final es alcanzable en este momento.Si se vuelve no disponible más tarde, consulte la FAQ a continuación.

Envío de mensajes de WhatsApp utilizando webhooks

La integración de WhatsApp requiere el uso de la API de WhatsApp Business o un servicio de terceros. A continuación se presentan los pasos para integrar la mensajería de WhatsApp utilizando 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 utilizar un servicio de terceros.

  • Obtenga las credenciales de API requeridas.

Paso 2. Configurar webhooks en Omnisend.

  • Agregue 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 asegurarte de que el mensaje de WhatsApp se envíe correctamente.

Enviando datos a un punto final de API personalizado

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

Paso 1. Crear un punto final de API personalizado. Trabaje con su equipo de desarrollo para crear un punto final de API que pueda recibir datos de webhook de Omnisend.

Paso 2. Agregar el webhook en Omnisend. Inserte el bloque de webhook en la automatización deseada e introduzca la URL del punto final de API personalizado.

  • Personalizar 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 punto final 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 funciona normalmente:

  1. Un Contacto Toma una Acción: Un contacto desencadena un evento al, por ejemplo, hacer clic en un enlace en un correo electrónico.

  2. Entrando en la automatización: El contacto entra en un flujo de automatización. Esto puede comenzar cuando ingresan a un segmento específico.

  3. 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.

  4. Segunda Automatización Desencadenada: El contacto especificado entra en una segunda automatización, en la que recibes 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. Configurando la primera automatización

  1. Definir la acción:

    • Configure su trigger para la automatización. Esto puede incluir cualquier acción, como ingresar a 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.

  2. Agregar un bloque de webhook:

    • En su flujo de automatización, agregue un bloque de webhook para enviar un evento personalizado al contacto especificado.

Configuración del webhook

{ 
"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.

  • propiedades: 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. Configurando la segunda automatización

  1. Seleccionar el Trigger:

    • Elija el eventName del paso anterior como el trigger de automatización.

  2. Agregar detalles de 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 integrar webhooks a menudo requiere recursos de desarrollo, especialmente para configuraciones de API personalizadas.

4a1 Tenga en cuenta: Integrar webhooks a menudo requiere recursos de desarrollo, especialmente para configuraciones de API personalizadas, así que asegúrese de tener el soporte necesario.

FAQ

¿Cuándo debo usar webhooks en lugar de integraciones nativas?
Utilice webhooks para plataformas sin una integración directa de Omnisend o cuando necesite un mapeo de datos personalizado.

¿Puedo probar los webhooks antes de habilitar la automatización?
Yes – o herramientas como Postman para enviar solicitudes de prueba.

¿Qué sucede si mi URL de webhook se vuelve inalcanzable?
Si Omnisend no puede alcanzar tu URL de webhook, por ejemplo, porque no se puede encontrar el dominio o el servidor está temporalmente no disponible, volveremos a intentar la solicitud automáticamente varias veces durante un período de 24 horas, con intervalos más largos entre cada intento.Si la solicitud aún no se puede entregar después de 24 horas, se descarta y se marca comoFallido en las estadísticas del webhook.

Esto puede suceder incluso si el webhook funcionó cuando lo configuró por primera vez.Por ejemplo, el dominio puede expirar, los ajustes de DNS pueden cambiar o el punto final puede ser desactivado.Si ves webhooks fallidos, verifica que tu URL siga activa y accesible, y que las IPs estáticas de Omnisend estén en la lista blanca.

¿Existen límites de tasa?
Los límites dependen del servicio externo – consulta su documentación de API.

¿Puedo poner en la lista blanca las IPs de webhook de Omnisend por seguridad?
Yes. Omnisend uses a dedicated set of static IP addresses for all webhook requests sent from Automation workflows. Whitelisting these IPs adds an extra security layer by ensuring only Omnisend can reach your endpoint.
​
​¿Qué datos puedo usar en las cargas útiles de webhook?
You can use any contact attributes or data from an event that triggers the automation. For more information, see

¿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. Ve a Configuración de la Tienda Facturación para gestionar tu plan.


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

¿Ha quedado contestada tu pregunta?