Información sobre los webhooks en los flujos

Qué aprenderás

Obtén más información sobre los webhooks en los 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 instrucciones de desarrollo, descubre cómo añadir una acción de webhook a un flujo.

¿Qué son los webhook?

En pocas palabras, los webhooks crean una forma completa de que todas tus herramientas de marketing y de datos se comuniquen entre sí. Como ejemplo, imaginemos cómo funcionan la banca en línea y la protección contra el fraude de tu tarjeta de crédito. Si alguien usa tu tarjeta de forma fraudulenta, esa transacción se registra en el minorista y luego se envía a tu banco, que entonces la analiza y te avisa por teléfono o email cuando hay un problema con tu tarjeta. Esta compra hizo que una serie de sistemas se comunicaran, trasladaran estos datos y, en última instancia, te avisaran. Lo más probable es que estos sistemas estén usando webhooks para transmitir 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 ha ocurrido (p. ej., un pedido realizado, un nuevo cliente que se ha suscrito, etc.).
• Puede indicar al sistema que se ha producido un evento o notificarte ese evento.

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

Componentes clave de los webhook

Los webhooks se componen de varias partes:

• Activador
  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 desencadenante, 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)

Webhook en flujo

Los webhook solo están disponibles actualmente en los flujos y se envían cuando un flujo llega a 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 webhook a partir de eventos activados por un flujo, lo que significa eventos que se pueden usar como activador de un flujo. Por ejemplo, no puedes enviar un webhook a partir del cambio de las propiedades de perfil, ya que un flujo no puede activarse directamente a partir de cambios de perfil.
Algunos ejemplos de eventos en Klaviyo son:

• Pedido Realizado
• Pago iniciado
• Suscrito a Lista

Casos de uso de webhook

Es fundamental entender los activadores de flujo que pueden generar webhook, así como algunos casos de uso prácticos sobre cómo implementarlos con tus otras aplicaciones.

Aquí tienes algunos ejemplos:

• Enviar un mensaje para volver a captar a los clientes inactivos.
• Enviar un mensaje el día del cumpleaños de tus clientes y darles un regalo en forma de puntos de fidelidad.
• Enviar el webhook cada vez que un nuevo suscriptor se une a tus listas. Puedes enviar los datos de su perfil a otra plataforma.
• Enviar a un cliente una encuesta NPS para saber más sobre tus suscriptores.
• Enviar un mensaje o una solicitud POST que se activa cuando se añade 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 tu herramienta de correo postal para poder comunicarte con los clientes online y por correo. Tu nuevo cliente, Shah, fue a tu sitio web y compró algunos artículos de tu tienda de comercio electrónico. Quieres enviarle a Shah un catálogo impreso de toda tu colección en el futuro.

Aquí es donde el webhook puede vincular 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 Placed Order. 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) realice 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, potencialmente en tiempo real, directamente desde Klaviyo (es decir, el mensaje o carga útil).

¿Qué no pueden hacer los webhooks de Klaviyo?

Los webhooks no están diseñados para ser una sincronización bidireccional de datos. Esto significa que, aunque puedes conectar otras plataformas a Klaviyo para enviar datos desde Klaviyo hacia ellas, no puedes devolver datos a Klaviyo. La información fluirá desde Klaviyo a los sistemas o aplicaciones designados a los que te hayas conectado, pero no podrá fluir en sentido contrario. Los webhook, a diferencia de las API, solo funcionarán de esta forma unidireccional.

También es importante tener en cuenta los eventos que eliges para pedir la información, con qué frecuencia ocurrirá y adónde van esos datos finalmente en tu sistema. Klaviyo proporcionará el marco para conectar los datos de tu flujo con una plataforma, pero el valor final depende de adónde vaya esa información después de salir de Klaviyo y de lo que pueda desencadenar. Por lo tanto, Klaviyo solo puede supervisar si el webhook funciona, no adónde van los datos ni 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 mediante un webhook. Klaviyo no puede enviar determinados puntos de datos a través de un webhook debido al funcionamiento de nuestros activadores de flujos. Por ejemplo, no podemos enviar datos de compromiso de aperturas de email cada vez que un suscriptor abre un email, ya que no puedes 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 al evento original que activó el flujo (es decir, igual que con los emails del flujo). Por ejemplo, si tienes un flujo de carrito abandonado activado por el evento Started Checkout, puedes usar variables dinámicas de ese evento en la carga útil de los webhooks. Pero, si en el mismo flujo también estás usando un filtro de flujo o una división mediante una métrica de Added to Cart, no puedes incluir estos datos adicionales en la carga útil del webhook.

Por tanto, al configurar tus webhook, es importante tener en cuenta qué flujos pueden ser compatibles con los puntos de datos y qué quieres conseguir con la configuración de tu webhook.

Actualmente, los códigos de cupón, los feeds web y los feeds de productos no se admiten en los webhook de flujo.

¿Quién debería configurar webhooks?

Tal y como se señaló anteriormente, los sistemas que conectes a Klaviyo, la forma en que se empaquete la información o los datos y qué datos o información elijas obtener están completamente a tu discreción.

Con esto en mente, recomendamos encarecidamente contar con un recurso de desarrollo para configurar webhooks y asegurarte de que se envían los eventos correctos desde Klaviyo y de que se publican correctamente en tu aplicación. Klaviyo también te proporcionará errores si falla algún webhook. Sin embargo, es posible que no podamos diagnosticar problemas más profundos con la configuración del webhook o con la forma en que, en última instancia, los datos se publican 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 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 Mánager, Administrador y Propietario.
• Para mayor seguridad, la autenticación en dos pasos debe estar habilitada en tu cuenta para poder usar webhooks o añadir nuevas acciones de webhook en un flujo existente.

¿Todo listo para configurarlo?

Los webhooks proporcionan mecanismos eficaces para comunicar datos desde Klaviyo a tus otros sistemas o aplicaciones externos. 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