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?¿Qué son los webhooks?
En pocas palabras, los webhooks crean una forma integral para que todas sus herramientas de marketing y datos se comuniquen entre sí. A modo de ejemplo, imaginemos cómo funciona la banca en línea y la protección contra el fraude en su tarjeta de crédito. Si alguien utiliza su tarjeta de forma fraudulenta, esa transacción se registra en el minorista y luego se envía a su banco, que la analiza y le avisa por teléfono o correo electrónico cuando hay un problema con su tarjeta. Esta compra provocó que una serie de sistemas se comunicaran, movieran estos datos y, en última instancia, le alertaran. Lo más probable es que estos sistemas utilicen webhooks para transmitir estos datos.
Los webhooks permiten a su aplicación pasar información o "llamar" a otras aplicaciones, herramientas y servidores a través de una solicitud HTTP. Los webhooks envían información sobre un evento que se ha producido (por ejemplo, un pedido realizado, la suscripción de un nuevo cliente, etc.). Los webhooks pueden indicar a su sistema que se ha producido un evento o notificárselo.
Esta información sobre el evento se entregará entonces en la forma y el lugar que usted elija. En otras palabras, los webhooks proporcionan formas valiosas de compartir datos e información desde dentro de Klaviyo, hacia fuera a su otra comercialización y herramientas de la manera que usted considere conveniente.
No debe utilizar webhooks para suscribir perfiles a nuevas listas.
Componentes clave de los webhooks
Los webhooks se componen de varias piezas:
-
Disparador
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 webhooks sólo están disponibles dentro de los flujos, y se envían cuando un flujo alcanza una determinada etapa o paso. A continuación, el webhook enviará una solicitud POST con datos sobre el evento o el destinatario que desencadenó 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 puede enviar webhooks a partir de eventos desencadenados por flujo, es decir, eventos que puedan utilizarse como desencadenantes de flujo. Por ejemplo, no puede enviar un webhook a partir del cambio de una propiedad del perfil, ya que un flujo no puede activarse directamente a partir de los cambios del perfil.
Algunos ejemplos de eventos en Klaviyo son:
- Pedido realizado
- Pago iniciado
- Suscripción a la lista
Casos de uso de webhooks
Es clave comprender los desencadenantes de flujo que pueden generar webhooks, así como algunos casos prácticos de uso sobre cómo implementarlos con sus otras aplicaciones.
Algunos ejemplos son:
- Enviar un mensaje para volver a captar a los clientes antiguos
- Enviar un mensaje el día del cumpleaños de sus clientes y obsequiarles con puntos de fidelidad
- Envíe el webhook cada vez que un nuevo suscriptor se una a sus listas. Puede enviar los datos de sus perfiles a su CDP o CRM, para tener siempre un registro completo de los abonados en su cuenta
- Enviar a un cliente una encuesta NPS para conocer mejor a sus abonados
- Envío de un mensaje o solicitud POST que se activa en función de que un suscriptor se añada a un segmento o lista (por ejemplo, un cliente que realiza un pedido). Sin embargo, tenga en cuenta que no admitimos el evento "Correo electrónico recibido" como activador de flujo
Ejemplo del mundo real
Decide conectar Klaviyo a su herramienta de correo directo para poder comunicarse con los clientes en línea y por correo. Su nuevo cliente Shah entró en su sitio web y compró algunos artículos en su tienda de comercio electrónico. Quiere enviar a Shah un catálogo impreso de su colección completa en el futuro.
Aquí es donde el webhook puede unir estas experiencias. Usted ya tendría su tienda de comercio electrónico integrada en Klaviyo. En Klaviyo, usted configura un flujo para que se active en función del evento Pedido realizado. A continuación, nos proporcionaría el webhook de la herramienta de correo directo e incluiría detalles 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 su herramienta de correo directo en tiempo real potencial directamente desde Klaviyo (es decir, el mensaje o carga útil).
¿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 puede conectar otras plataformas a Klaviyo para enviar datos de nosotros a ellas, no puede pasar datos de vuelta a Klaviyo. La información fluirá desde Klaviyo hacia los sistemas o aplicaciones designados a los que se haya conectado, pero no podrá fluir en sentido contrario. Los webhooks, a diferencia de las API, sólo funcionarán de esta manera unidireccional.
También es importante que tenga en cuenta los eventos que elige para solicitar su información, la frecuencia con la que esto ocurrirá y el lugar al que van a parar finalmente esos datos en su sistema. Klaviyo proporcionará el marco para conectar los datos de sus flujos 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 supervisar si el webhook está funcionando 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 ciertos 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 compromiso de apertura de correo electrónico por 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 puede utilizar variables dinámicas basadas en eventos en la carga útil de su webhook en un flujo desencadenado por eventos, las variables disponibles están conectadas al evento original que desencadenó el flujo (es decir. al igual que con los correos electrónicos de flujo). Por ejemplo, si tiene un flujo de Carrito Abandonado activado por el evento Pedido Iniciado, puede utilizar variables dinámicas de ese evento en la carga útil de los webhooks. Pero, si en el mismo flujo también está utilizando un filtro de flujo o una división utilizando una métrica de Añadido a la cesta, no puede incluir estos datos adicionales en la carga útil del webhook.
Por lo tanto, cuando configure sus webhooks, es importante que tenga en cuenta qué flujos pueden soportar los puntos de datos y qué pretende conseguir con la configuración de sus webhooks.
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 usted conecte a Klaviyo, la forma en que se empaquete la información o los datos, y qué datos o información decida coger, quedan totalmente a su discreción.
Teniendo esto en cuenta, recomendamos encarecidamente un recurso de desarrollo para configurar webhooks para asegurar que los eventos correctos se envían desde Klaviyo y se publican correctamente en su aplicación. Klaviyo también le 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 cómo los datos se están enviando en última instancia a su aplicación. Le sugerimos que revise nuestra guía Cómo añadir una acción Webhook a un flujo para asegurarse de que ha configurado correctamente la acción.
Requisitos y consideraciones de Klaviyo Webhooks
Además de asegurarse de que dispone de un recurso de desarrollador para configurar correctamente su webhook y probarlo en su 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 sus otros sistemas o aplicaciones de marketing externos. Si está listo para configurar sus webhooks, puede leer nuestra guía de documentación para desarrolladores sobre Cómo añadir una acción de webhook a un flujo.
Recursos adicionales