Cómo enviar el consentimiento a Klaviyo a través de Zapier

Objetivos de aprendizaje

Aprende a crear un Zapier personalizado webhook para enviar consentimiento para enviar SMS a Klaviyo. Puedes modificar fácilmente las instrucciones de esta guía para enviar también el consentimiento por correo electrónico. 

Los pasos siguientes te ayudarán a crear un Zap utilizando un webhook (también llamado gancho de captura) que desencadena una acción de script de Python. El script envía una llamada de interfaz de programación de aplicaciones (API) a Klaviyo para suscribir correo electrónico y números de teléfono a una lista.

Sobre las integraciones

Esta guía utiliza una acción de código Zapier que ejecuta un script Python cuando se detecta el activador. Con esta solución, puedes mapear los campos a los tipos de datos que Klaviyo punto de conexión requiere; en concreto, el perfil suscribirse y el perfil cancelar la suscripción punto de conexión.

Configurar el webhook Zapier

1. iniciar sesión en tu cuenta Zapier.
2. En la página principal de Zapier, selecciona +Crear y, a continuación, selecciona Zap.
3. Introduce un nombre para tu nuevo Zap (por ejemplo, Klaviyo webhook).
4. Busca webhook y, a continuación, selecciona webhook de Zapier en el menú Activador.
   
5. En el siguiente menú, selecciona Enganchar en las opciones de Evento desencadenante.
   
6. Haz clic en Continuar.
7. Selecciona la pestaña Prueba.
8. Copia la URL del webhook que Zapier te proporciona para enviar tus peticiones.
   
9. Antes de realizar la prueba, tendrás que enviar datos de prueba a tu webhook. Consulta nuestra guía Cómo enviar datos de prueba a Zapier para obtener más información. Asegúrate de formatear correctamente los números de teléfono cuando envíes datos de prueba.
10. Una vez que hayas enviado los datos de prueba al webhook, haz clic en Activar prueba (en la pestaña Prueba ).
    
11. Si la solicitud tiene éxito, verás un mensaje de éxito, y los datos de la prueba se rellenarán debajo del mensaje de éxito, de forma similar al ejemplo siguiente:
    
12. Cuando tu activador funcione, haz clic en Continuar con el registro seleccionado.

Configurar acción Zapier

1. En el menú Acción, introduce Code by Zapier en el cuadro de búsqueda y selecciona la opción de la lista.
   
2. Haz clic en Elegir un evento > Ejecutar Python.
   
3. Haz clic en Continuar.

Configurar la asignación de campos y crear la lógica del script

1. Configura el mapeo de campos para correlacionar los datos de entrada de la tabla siguiente con los datos de prueba correctos que enviaste previamente. 
   

   Datos de entrada	Datos de prueba mapeados
   correo electrónico	1. correo electrónico: <Correo electrónico de prueba> <Test email>
   número_teléfono	1. Número de teléfono: <Número de teléfono de prueba> <Test phone number>
   consentimiento_sms	1. Sms_consentimiento: true
   nombre	1. Nombre: <Test name>

   
2. Añade un script como el siguiente a la caja de código:
   

   importar solicitudes
   
   # configurar SMS suscribirse o cancelar la suscripción llamar a
   if (input_data["sms_consent"] == "true" or input_data["sms_consent"] == "True" or input_data["sms_consent"] == "TRUE"):
    url = "https://a.klaviyo.com/api/profile-subscription-bulk-create-jobs/"
     payload = { "datos": {
    " tipo": "perfil-suscripción-bulk-crear-trabajo",
    " atributos": {
    " datos del perfil": [
    {
    " tipo": "perfil",
    " atributos": {
    " correo electrónico": input_data["correo electrónico"],
    " número_teléfono": input_data["número_teléfono"],
    " suscripciones" : {
    " marketing por SMS": { "consent": "SUBSCRIBED" } }
                               }
                           }
                       }
                   ] }
          },
    " relaciones": { "lista": { "datos": {
                       "type": "list",
                       "id": "LIST_ID"
                   } } }
       } }
   
   elif (input_data["sms_consent"] == "false" or input_data["sms_consent"] == "False" or input_data["sms_consent"] == "FALSE"):
     url = "https://a.klaviyo.com/api/perfil-subscription-bulk-delete-jobs/"
     payload = { "datos": {
    " tipo": "perfil-subscription-bulk-delete-job",
    " atributos": {
    " datos del perfil": [
    {
    " tipo": "perfil",
    " atributos": {
                               "email": input_data["email"],
                               "phone_number": input_data["phone_number"],
                           }
                       }
                   ] }
          },
    " relaciones": { "lista": { "datos": {
                       "type": "list",
                       "id": "LIST_ID"
                   } } }
       } }
   
   cabeceras = {
       "accept": "application/json",
       "revision": "2024-05-15",
       "content-type": "application/json",
       "Authorization": "Klaviyo-API-Key your-private-api-key"
   }
   
   response = requests.post(url, json=payload, headers=cabeceras)
   
   # Zapier requiere un objeto 'output'
   output = {"response text": response.text}
   

3. Sustituye tu-clave-privada-de-APIportu Klaviyo clave-privada-de-API.
   

   Trata las claves de API privadas como contraseñas: guárdalas en un lugar seguro y nunca las expongas al público.

4. Sustituye el LIST_ID (en ambas ubicaciones) por el ID de la lista de Klaviyo a la que quieres enviar tus datos de Zapier. Puedes encontrar tu ID de lista en Klaviyo navegando a Audiencia > lista & segmento > Configuración. Si deseas suscribir inmediatamente a las personas sin confirmación (lo que puede ser útil durante las pruebas), asegúrate de que tu lista está configurada como opt-in único (se encuentra en la pestaña Consentimiento dentro de la configuración de la lista). 
5. Haz clic en Continuar y, a continuación, en Paso de prueba.
6. Si tu prueba tiene éxito, verás una respuesta sin errores, como la que aparece a continuación:
   
7. También puedes comprobar si la prueba se ha realizado correctamente en Klaviyo navegando a tu lista y asegurándote de que se ha añadido el perfil.
   
8. Una vez que tu prueba haya tenido éxito, haz clic en Publicar para publicar tu zap. Si tu prueba no tiene éxito, paga nuestros consejos para solucionar los problemas más comunes.

Tips de solución de problemas

Los siguientes son problemas comunes que puedes encontrarte al configurar el webhook Zapier. Si te encuentras con cualquier otro problema, puedes alcanzar a los Klaviyo Community para obtener más orientación.

EOL al escanear cadena literal

Si ves este error, es que te falta una comilla alrededor de una de tus variables. Comprueba la lista ID y la clave privada de API para asegurarte de que están entrecomilladas por ambos lados.

SyntaxError: sintaxis no válida

Si aparece este error, elimina los comentarios del código Python (cualquier línea que empiece por #).

Recursos adicionales

• Cómo recoger el consentimiento para enviar SMS a través de la interfaz de programación de aplicaciones (API)
• Referencia de personalización de mensajes
• Cómo gestionar la clave de API de tu cuenta
• Cómo enviar datos de prueba a Zapier