Comprender los webhooks en los flujos

Qué aprenderás

Conozca los webhooks en los flujos y cómo envían información desde Klaviyo a sus herramientas y aplicaciones de terceros. Es importante tener en cuenta que la configuración de los webhooks puede ser compleja. Se aconseja tener conocimientos o recursos de desarrollo para completar correctamente esta configuración. Si busca estas direcciones de desarrollo, aprenda a añadir una acción de webhook a un flujo.

¿Qué son los webhooks?

En pocas palabras, los webhooks crean una forma integral de que todas tus herramientas de marketing y datos se comuniquen entre sí. Como ejemplo, imaginemos cómo funcionan la banca online y la protección contra el fraude en tu tarjeta de crédito. Si alguien utiliza fraudulentamente tu tarjeta, esa transacción se registra en el comercio y luego se envía a tu banco, que la analiza y te avisa por teléfono o correo electrónico cuando hay un problema con tu tarjeta. Esta compra hizo que una serie de sistemas se comunicaran, movieran estos datos y, en última instancia, te alertaran. Lo más probable es que estos sistemas utilicen webhooks para transmitir estos datos. webhook:

• Permite que tu aplicación pase información o "llame" a otras aplicaciones, herramientas y servidores a través de una petición HTTP.
• Envía información sobre un evento que se ha producido (por ejemplo, un pedido realizado, un nuevo cliente suscrito, etc.).
• Puede indicar a tu sistema que se ha producido un suceso o notificártelo.

Esta información sobre el evento se entregará en la forma y lugar que elijas. En otras palabras, los webhooks proporcionan formas valiosas de compartir datos e información desde dentro de Klaviyo, a tus otras herramientas de marketing y de la forma que creas conveniente.

Componentes clave de los webhooks

Los webhooks se componen de varias piezas:

• Activador
  El evento que hace que se dispare un webhook
• Mensaje (o "la carga útil")
  Lo que envía el webhook, como detalles clave sobre la URL del evento desencadenante donde se envía el mensaje o la URL del sistema que recibe el mensaje
• Cabeceras
  Un lugar para pasar información adicional (como la autenticación)

Webhooks en los flujos

Actualmente, los webhook sólo están disponibles dentro de flujo, y se envían cuando un flujo alcanza una determinada etapa o paso. El webhook enviará entonces una petición POST con datos sobre el evento o destinatarios que desencadenaron el flujo.

Es importante tener en cuenta que sólo un evento puede iniciar el envío del webhook. Cuando un suscriptor cumpla los criterios de activación, el webhook se disparará, enviando el mensaje a la URL designada. Además, sólo puedes enviar webhook a partir de eventos desencadenados por flujo, es decir, eventos que puedan utilizarse como desencadenantes de flujo. Por ejemplo, no puedes enviar un webhook a partir de un cambio de Propiedades de perfil, ya que un flujo no puede dispararse directamente a partir de cambios de perfil.
Algunos ejemplos de acontecimientos en Klaviyo son:

• Pedido realizado
• Pago iniciado
• Suscripción a la lista

casos de uso de webhook

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

Algunos ejemplos son:

• Enviar un mensaje para reinteractuar con un cliente caducado.
• Envía un mensaje el día del cumpleaños de tu cliente y dale un regalo en forma de puntos de fidelidad.
• Enviando el webhook cada vez que un nuevo suscriptor se une a tu lista. Puedes enviar sus datos del perfil a otra plataforma.
• Enviar a un cliente una encuesta NPS para saber más sobre tu suscriptor.
• Envío de un mensaje o solicitud POST que se activa al añadir un suscriptor a un segmento o lista. Sin embargo, ten en cuenta que no asistimos al evento "Recibido Email" como activador de flujo.

Ejemplo real

Decides conectar Klaviyo a tu herramienta de correo directo para poder comunicarte con el cliente online y por correo. Tu nuevo cliente Shah entró en tu sitio web y compró algunos artículos en tu tienda de comercio electrónico. Quieres enviar a Shah un catálogo impreso de tu colección completa en el futuro.

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

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

¿Qué no pueden hacer los webhooks de Klaviyo?

Los webhooks no están pensados para ser una sincronización bidireccional de datos. Esto significa que, aunque puedes conectar otras plataformas a Klaviyo para enviarles datos desde nosotros, no puedes volver a pasar datos a Klaviyo. La información fluirá de Klaviyo a los sistemas o aplicaciones designados a los que te hayas conectado, pero no podrá fluir en sentido contrario. webhook, a diferencia de API's, sólo funcionará de esta manera unidireccional.

También es importante tener en cuenta los eventos que elijas para solicitar tu información, la frecuencia con la que esto ocurrirá y dónde van a parar esos datos en última instancia en tu sistema. Klaviyo proporcionará el marco para conectar tus datos de flujo a una plataforma, pero el valor final depende de adónde vaya esa información después de salir de Klaviyo, y de lo que potencialmente suscite. Por lo tanto, Klaviyo sólo puede monitorizar si webhook funciona y no a dónde van los datos o qué hacen después de salir de nuestro sistema.

Por último, es importante tener en cuenta los datos que Klaviyo puede y no puede enviar a través de un webhook. Klaviyo no puede enviar determinados puntos de datos a través de un webhook basándose en la forma en que funcionan nuestros activadores de flujo. Por ejemplo, no podemos enviar datos de interacción de correo electrónico abierto cada vez que un suscriptor abre un correo electrónico, ya que no se puede activar un flujo basado en aperturas.

Del mismo modo, aunque puedes utilizar variables dinámicas basadas en eventos en tu carga útil webhook en un flujo desencadenado por evento, las variables disponibles están conectadas al evento original que desencadenó el flujo (es decir, igual que con el flujo correo electrónico). Por ejemplo, si tienes un flujo carrito abandonado activado por el evento Página de pago iniciada, puedes utilizar variables dinámicas de ese evento en la carga útil del webhook. Pero, si en el mismo flujo también estás utilizando un filtro de flujo o una división que utiliza una métrica de Añadido a la cesta, no puedes incluir estos datos adicionales en la carga útil del webhook.

Así pues, al configurar tu webhook, es importante tener en cuenta qué flujo puede asistir para los puntos de datos y qué buscas conseguir en tu configuración de webhook.

Actualmente, los códigos de cupón, los feeds web y los feeds de producto no son compatibles con los webhooks de flujo.

¿Quién debe configurar los webhooks?

Como se ha indicado anteriormente, los sistemas que conectas a Klaviyo, la forma en que se empaqueta la información o los datos, y qué datos o información decides coger, quedan totalmente a tu discreción.

Teniendo esto en cuenta, recomendamos encarecidamente que un recurso de desarrollo configure el webhook para garantizar que se envían los eventos correctos desde Klaviyo y se publican correctamente en tu aplicación. Klaviyo también te proporcionará errores si falla algún webhook. Sin embargo, puede que no seamos capaces de diagnosticar problemas más profundos con la configuración del webhook, o cómo los datos se publican finalmente en tu aplicación. 

Requisitos y consideraciones

Además de asegurarte de que dispones de un recurso de desarrollador para configurar correctamente tu webhook y probarlo en tu sistema de acompañamiento, Klaviyo tiene algunos requisitos clave para utilizar esta funcionalidad:

• Sólo los roles de usuario que tienen acceso a crear flujos pueden configurar webhooks en Klaviyo. Esto incluye los roles de Gestor, Admin y Propietario.
• Para mayor seguridad, la autenticación en dos pasos debe estar activada en su cuenta para poder utilizar webhooks o añadir nuevas acciones webhook dentro de un flujo existente.

¿Listo para instalarse?

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

Recursos adicionales

• Comprender los activadores y filtros de flujo
• Cómo previsualizar la configuración de un activador de flujo
• Cómo añadir una acción webhook a un flujo