Cómo funcionan los webhooks en flujos

Objetivos del artículo

Obtén información sobre los webhooks en flujos y cómo envían información de Klaviyo a tus herramientas y aplicaciones de terceros. Es importante tener en cuenta que configurar webhooks puede ser complejo. Se recomienda tener conocimientos de desarrollo o recursos de desarrollo para completar esta configuración correctamente. Si estás buscando estas indicaciones de desarrollo, descubre cómo agregar una acción de webhook a un flujo.

¿Qué son los webhooks?

En pocas palabras, los webhooks crean una forma integral para que todas tus herramientas de marketing y datos se comuniquen entre sí. Como ejemplo, imaginemos cómo funcionan la banca en línea y la protección contra fraude en la tarjeta de crédito. Si alguien usa tu tarjeta de forma fraudulenta, esa transacción se registra en el comercio y después se envía a tu banco, que luego la analiza y te alerta por teléfono o correo electrónico cuando hay un problema con tu tarjeta. Esta compra generó que una serie de sistemas se comunicaran, trasladaran estos datos y, finalmente, te alertaran. Es probable que estos sistemas usen webhooks para transferir estos datos. webhook:

• Permite que tu aplicación transmita información o «llame» a otras aplicaciones, herramientas y servidores mediante una solicitud HTTP.
• Envía información sobre un evento que ocurrió (p. ej., un pedido realizado, un cliente nuevo que se suscribió, etc.).
• Puede indicarle al sistema que ocurrió un evento o notificarte sobre ese evento.

Esta información del evento se entregará de la forma y en el lugar que elijas. En otras palabras, los webhook ofrecen formas valiosas de compartir datos e información desde Klaviyo hacia tus otras herramientas de marketing, y hacerlo de la manera que consideres más adecuada.

Componentes clave de los webhook

Los webhook se componen de algunas partes:

• Disparador
  El evento que hace que se active un webhook
• Mensaje (o “la carga útil”)
  Lo que envía el webhook, como detalles clave sobre el evento que lo activa, la URL a la que se envía el mensaje o la URL del sistema que recibe el mensaje
• Encabezados
  Un lugar para pasar información adicional (como autenticación)

Webhooks en flujos

Actualmente, los webhook solo están disponibles en los flujos y se envían cuando un flujo alcanza una determinada fase o paso. El webhook enviará entonces una solicitud POST con datos sobre el evento o el destinatario que activó el flujo.

Es importante tener en cuenta que solo un evento puede iniciar el envío del webhook. Cuando un suscriptor cumpla los criterios de activación, el webhook se activará y enviará el mensaje a la URL designada. Además, solo puedes enviar webhooks desde eventos activados por un flujo, es decir, eventos que se pueden usar como activador de un flujo. Por ejemplo, no puedes enviar un webhook a partir del cambio de una propiedad del perfil, ya que un flujo no se puede activar directamente a partir de cambios en el perfil.
Algunos ejemplos de eventos en Klaviyo incluyen:

• Pedido realizado
• Proceso de Pago Iniciado
• Con suscripción a la lista

Casos de uso de webhook

Es clave comprender los activadores de flujo que pueden generar webhooks, así como algunos casos de uso prácticos sobre cómo implementarlos con otras aplicaciones.

Los ejemplos incluyen:

• Enviar un mensaje para volver a involucrar a clientes inactivos.
• Enviar un mensaje en el cumpleaños de los clientes y darles un regalo en forma de puntos de lealtad.
• Enviar el webhook cada vez que se una un nuevo suscriptor a tus listas. Puedes enviar sus datos de perfil a otra plataforma.
• Enviar una encuesta NPS a un cliente para obtener más información sobre tus suscriptores.
• Enviar un mensaje o una solicitud POST que se activa cuando se agrega un suscriptor a un segmento o lista. Sin embargo, ten en cuenta que no admitimos el evento "Received Email" como activador de flujo.

Ejemplo real

Decides conectar Klaviyo a la herramienta de correo directo para que puedas comunicarte con los clientes en línea y por correo. Tu nuevo cliente, Shah, fue a tu sitio web y compró algunos artículos en tu tienda de ecommerce. Quieres enviarle a Shah un catálogo impreso de toda tu colección en el futuro.

Aquí es donde el webhook puede unir estas experiencias. Ya tendrías la tienda de ecommerce integrada en Klaviyo. En Klaviyo, configuras un flujo para que se active en función del evento Pedido realizado. Luego, nos proporcionarías el webhook de la herramienta de correo directo e incluirías detalles como el nombre y la dirección del cliente, y lo que pidió en el mensaje (es decir, la carga útil).

Ahora, cada vez que alguien (como Shah) realiza un pedido, un evento podría iniciar el envío de un catálogo impreso a su dirección. El evento de compra del webhook solicitará que se envíe información a tu herramienta de correo directo en un posible tiempo real directamente desde Klaviyo (es decir, el mensaje o la carga útil).

¿Qué no pueden hacer los webhooks de Klaviyo?

Los webhook no están pensados para una sincronización bidireccional de datos. Esto significa que, aunque puedes conectar otras plataformas a Klaviyo para enviarles datos desde Klaviyo, no puedes enviar datos de vuelta a Klaviyo. La información fluirá desde Klaviyo hacia los sistemas o aplicaciones designados que hayas conectado, pero no puede fluir en sentido contrario. Los webhook, a diferencia de la interfaz de programación de aplicaciones (API), solo funcionarán de esta manera unidireccional.

También es importante tener en cuenta los eventos que elijas para activar el aviso de tu información, con qué frecuencia ocurrirá esto y a dónde van esos datos finalmente en tu sistema. Klaviyo proporcionará el marco para conectar los datos de tu flujo a una plataforma, pero el valor final depende de a dónde vaya esa información después de salir de Klaviyo y qué es lo que podría activar. Por lo tanto, Klaviyo solo puede monitorear si el webhook funciona, y no a dónde van los datos ni qué hacen después de salir de nuestro sistema.

Por último, es importante considerar los datos que Klaviyo puede y no puede enviar mediante un webhook. Klaviyo no puede enviar ciertos puntos de datos a través de un webhook según la forma en que funcionan nuestros activadores de flujo. Por ejemplo, no podemos enviar datos de interacción de aperturas de correo electrónico cada vez que un suscriptor abre un correo electrónico, ya que no se puede activar un flujo en función de las aperturas.

Del mismo modo, aunque puedes usar variables dinámicas basadas en eventos en la carga útil de tu webhook en un flujo activado por eventos, las variables disponibles están conectadas con el evento original que activó el flujo (es decir, igual que con los correos electrónicos de flujo). Por ejemplo, si tienes un flujo de carrito abandonado activado por el evento Inicio de pago, puedes usar variables dinámicas de ese evento en la carga útil de los webhook. Pero, si en el mismo flujo también usas un filtro de flujo o una división con una métrica de Agregado al carrito, no puedes incluir estos datos adicionales en la carga útil del webhook.

Por lo tanto, al configurar los webhooks, es importante considerar qué puede admitir cada flujo para los puntos de datos y qué buscas lograr con la configuración de webhooks.

Actualmente, los códigos de cupón, los feeds web y las fuentes de productos no son compatibles en webhooks de flujo.

¿Quién debe configurar webhooks?

Como se mencionó arriba, los sistemas que conectes a Klaviyo, la forma en que se empaqueta la información o los datos y qué datos o información elijas obtener quedan completamente a tu discreción.

Teniendo esto en cuenta, recomendamos encarecidamente contar con un recurso de desarrollo para configurar webhooks y garantizar que los eventos correctos se envíen desde Klaviyo y se publiquen correctamente en tu aplicación. Klaviyo también te proporcionará errores si algún webhook falla. Sin embargo, es posible que no podamos diagnosticar problemas más profundos con la configuración del webhook, o con la forma en que los datos finalmente se publican en tu aplicación.

Requisitos y consideraciones

Además de asegurarte de tener un recurso de desarrollo para configurar correctamente tu webhook y probarlo en tu sistema correspondiente, Klaviyo tiene algunos requisitos clave para usar esta funcionalidad:

• Solo los roles de usuario que tienen acceso para crear flujos pueden configurar webhook en Klaviyo. Esto incluye los roles de Gerente, Administrador y Propietario.
• Para mayor seguridad, se debe habilitar la autenticación en dos pasos en tu cuenta para poder usar webhooks o agregar nuevas acciones de webhook en un flujo existente.

¿Todo listo para configurar?

Los webhooks proporcionan mecanismos potentes para comunicar datos de Klaviyo a tus otros sistemas o aplicaciones externas. Si estás listo para configurar tus webhooks, puedes leer nuestra guía de documentación para desarrolladores sobre Cómo añadir una acción de webhook a un flujo.

Recursos adicionales