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.

  • Ejemplo: https://api.yourservice.com/webhook-endpoint

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.

    Disparadores de Webhook en 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 provienen de Omnisend.

Paso 4. Configurando la 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.

Enviando mensajes de WhatsApp usando 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 el mensajería de WhatsApp utilizando webhooks.

Paso 1. Configurar la API de WhatsApp Business.

  • Regístrate para la API de WhatsApp Business a través de Facebook.

  • Sigue el proceso de configuración, que incluye alojar la API en tu servidor o usar un servicio de terceros.

  • Obtén las credenciales de API requeridas.

Paso 2. Configurar Webhooks en Omnisend.

  • Agrega un bloque de webhook en tu flujo de automatización de Omnisend.

  • Introduce la URL del endpoint de la API de WhatsApp Business como el webhook.

Construir la solicitud HTTP. Para enviar mensajes a través de WhatsApp, construya 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 endpoint 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 endpoint API personalizado. Trabaja con tu equipo de desarrollo para crear un endpoint API que pueda recibir datos del webhook de Omnisend.

Paso 2. Agrega el Webhook en Omnisend.Inserta el bloque de webhook en la automatización deseada e introduce la URL del endpoint API personalizado.

  • Personaliza 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. Prueba el webhook para asegurarte de que los datos se envían correctamente a tu endpoint API personalizado.

Usando 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 generalmente funciona:

  1. 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 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 respecto a la acción realizada por el primer contacto a una dirección de correo electrónico interna especificada.

  4. Segunda Automatización Activada: 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 tu flujo de automatización, añade un bloque 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: Puedes nombrar este evento como desees. 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 puedes incluir sobre el primer contacto. En este caso, estamos recopilando su correo electrónico, nombre y apellido.

Paso 2. Configurando la Segunda Automatización.

  1. Selecciona el Trigger:

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

  2. Agregar Detalles de Notificación:

    • En esta automatización, puedes 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, ten en cuenta que integrar webhooks a menudo requiere recursos de desarrollo, especialmente para configuraciones de API personalizadas.

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

FAQ

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

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

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

¿Puedo incluir en la lista blanca las IPs del webhook de Omnisend por razones de 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 del 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 Ajustes de la Tienda Facturaci 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].

Artículos relacionados
¿Ha quedado contestada tu pregunta?