Entender los webhooks en el CDP de Klaviyo

Qué aprenderás

Aprenda sobre webhooks, y cómo puede utilizarlos para enviar información a sus aplicaciones de terceros en respuesta a eventos capturados en Klaviyo. Para obtener información más detallada sobre cómo recibir webhooks del sistema, diríjase a nuestro recurso para desarrolladores sobre cómo trabajar con webhooks del sistema.

¿Qué son los webhooks?

Los webhooks permiten a Klaviyo pasar información o "llamar" a otras aplicaciones, herramientas y servidores a través de peticiones HTTP. Pueden enviar información sobre un acontecimiento que se ha producido (por ejemplo, un pedido realizado, la suscripción de un nuevo cliente, etc.) o notificar a sus sistemas externos que el acontecimiento se ha producido.

Klaviyo soporta 2 tipos de webhooks:

1. Webhooks en Klaviyo CDP
   Los Webhooks disponibles como parte de Klaviyo CDP se utilizan para notificar a sus sistemas externos que se ha producido un evento en particular, y le permiten enviar información en respuesta a una amplia gama de eventos sin las limitaciones de estar en un Flujo.
2. Webhooks de Flujos
   Los webhooks de Flujo sólo están disponibles dentro de la interfaz de Flujos, y se activan cuando el Flujo alcanza una determinada etapa o paso. Pueden utilizarse para enviar datos sobre el acontecimiento o el destinatario que desencadenó el Flujo.

Componentes clave de los webhooks

Los webhooks están formados por unos pocos componentes clave:

• Tema
  El evento que hace que se dispare un webhook
• Cuerpo (o "la carga útil")
  Los datos que envía el webhook.
• Encabezados
  Un lugar para pasar información adicional (como la autenticación)

¿En qué se diferencian los webhooks de Klaviyo CDP de los webhooks de Flow?

Puede utilizar webhooks en el CDP de Klaviyo o webhooks de Flow en función de sus necesidades.

Eventos incluidos

El webhook de flujo sólo puede responder a un subconjunto de eventos de Klaviyo, y no asiste a eventos relacionados con mensajes como Unsubscribed, Received correo, o Clicked correo ya que el flujo generalmente termina con la recepción del mensaje en lugar de comenzar con ellos. Por su parte, los webhook de la plataforma de datos de clientes Klaviyo le permiten enviar información en respuesta a cualquier evento de su cuenta.

Entre ellos se incluyen:

• Eventos de correo electrónico (por ejemplo, correo electrónico recibido, correo electrónico pulsado, correo electrónico marcado como spam, anulación de suscripción)
• Eventos SMS (por ejemplo, SMS enviados, SMS recibidos)
• Eventos de notificación push (por ejemplo, push recibido, push rebotado)
• Eventos de integraciones ( es decir, eventos de integraciones de primera parte creadas por Klaviyo)
• Eventos API (por ejemplo, eventos sincronizados a través de las API de Klaviyo)

Carga útil

Los webhooks de flujo le permiten personalizar los datos incluidos en la solicitud, pero debe construir manualmente la carga útil. Mientras tanto, los webhooks en Klaviyo CDP utilizan una carga útil preconstruida que no requiere ningún trabajo manual por su parte, y se utilizan para notificar a sistemas externos que se ha producido un evento.

Limitaciones de caudal

Los webhooks de Flows deben configurarse dentro de la interfaz de Flows, y no permiten utilizar varios desencadenantes a la vez. Los diferentes desencadenantes deben crearse a través de Flujos individuales, y dependen del estado general del Flujo (por ejemplo, un flujo en borrador no enviaría datos a través del webhook del Flujo). Mientras tanto, los webhooks en Klaviyo CDP existen fuera de la interfaz de Flows, y no dependen de la serie de pasos que conducen a la acción del webhook como un webhook de Flow.

Configurar webhooks

Para configurar un webhook en Klaviyo, navegue hasta webhook en plataforma de datos de clientes > Data managment > webhook en Klaviyo.

1. Para añadir un nuevo webhook, pulse el botón Crear webhook.
2. En el modal Crear un webhook, introduzca la información. Esto incluye:
• Nombre
  Cómo identificará su webhook.
• URL del punto final
  La URL asociada al destino para la solicitud del webhook.
• Clave secreta
  Un identificador único para identificar las peticiones webhook de Klaviyo en sus otros sistemas.
• Descripción
  Una descripción opcional para su webhook.
3. En la sección Temas, elija los eventos que desea que activen la notificación webhook.

Una vez que haya creado su webhook, aparecerá en la página de Webhooks junto con el:

• Nombre del webhook
• URL del webhook
• Hora de la última sincronización
• Estado

Puede eliminar o desactivar su webhook utilizando el menú situado junto al elemento.

Probar los webhooks del sistema 

Al configurar un webhook en Klaviyo, puede probarlo para asegurarse de que la conexión se realiza correctamente. Para probar su webhook, utilice el botón Probar webhook después de introducir los campos obligatorios.

Aparecerá un menú en el que podrá seleccionar un tema y enviar una prueba a su URL de devolución de llamada. 

Tras realizar la prueba, verá un mensaje indicando si ha tenido éxito, junto con la cabecera y el cuerpo de la solicitud rellenados en la pestaña Respuesta.

Ejemplo de carga útil

A continuación se muestra un ejemplo de la carga útil para una solicitud de webhook en respuesta al tema Correo electrónico entregado. 

{
 " meta": {
    "timestamp": "2023-08-10T07:25:23.700369+00:00",
    "klaviyo_webhook_id": "ID",
    "version": "2023-06-03"
  },
 " datos": [
 {
 " tema": "evento: correo",
 " external_id": "ID",
 " payload": {
 " datos": {
 " id": "ID",
 " type": "event",
 " links": {
            "self": "https://a.klaviyo.com/api/events/ID/"
          },
 " atributos": {
 " uuid: "96150200-374e-11ee-8001-a163313bc6c2",
 " datetime": "2023-08-10 07:21:56+00:00",
 " timestamp": 1691652116 ,
 " event_properties": {
 " $ESP": 0,
 " Asunto": "? Alerta Swag gratuita (¡Genial!)",
 " $message": "01H7F525FKR31P27Y7PNGVBBKK",
 " $event_id": "01H7F525FKR31P27Y7PNGVBBKK:125423419905414052533228990613763937641",
 " $group_ids": [
 " V7adxq"
 ],
 " $attribution": {
                "$send_ts": 0,
                "$attributed_event_id": ""
              },
 " correo Dominio": "Klaviyo-demo.com",
              campaña Name": "Boletín diario: 2023-08-10",
 " Inbox proveedor": "Amazon SES Inbound",
 " $_cohort$message_send_cohort": "1691652081:01H7F525FKR31P27Y7PNGVBBKKK"
 }
         },
 " relaciones": {
 " métrica": {
 " datos": {
                "id": "ID",
                "type": "metric"
              },
 " enlaces": {
                "self": "https://a.klaviyo.com/api/events/ID/relationships/metric/",
                "related": "https://a.klaviyo.com/api/events/ID/metric/"
              }
            },
 " perfil": {
 " datos": {
                "id": "ID",
                "type": "profile"
              },
 " enlaces ": {
                "self": "https://a.klaviyo.com/api/events/ID/relationships/profile/",
                "related": "https://a.klaviyo.com/api/events/ID/profile/"
              }
            }
          }
        }
      }
    },
  

Recursos adicionales

Cómo añadir una acción webhook a un Flow

Comprender los webhooks de Klaviyo

Trabajar con webhooks del sistema (API de Webhooks de Klaviyo)