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

Objetivos del artículo

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

Los pasos a continuación te ayudarán a crear un Zap usando un webhook (también llamado catch hook) que active una acción de script de Python. El script envía una llamada a la interfaz de programación de aplicaciones (API) a Klaviyo para suscribir direcciones de correo electrónico y números de teléfono a una lista.

Acerca de las integraciones

Esta guía usa una acción de código de Zapier que ejecuta un script de Python cuando se detecta el activador. Con esta solución, puedes asignar campos a los tipos de datos que requieren los punto de conexión de Klaviyo; específicamente, los puntos de conexión Suscribirse a perfiles y Cancelar la suscripción de perfiles.

Configurar webhook de Zapier

1. Inicia sesión en tu cuenta de Zapier.
2. En la página principal de Zapier, selecciona +Crear y luego selecciona Zap.
3. Ingresa un nombre para tu nuevo Zap (p. ej., webhook de Klaviyo).
4. Busca webhook y luego selecciona Webhooks by Zapier en el menú Disparador.
   

5. En el siguiente menú, selecciona Catch Hook 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 proporciona para enviar las solicitudes.
   

9. Antes de hacer pruebas, tendrás que enviar datos de prueba a tu webhook. Consulta nuestra guía en Cómo enviar datos de prueba a Zapier para obtener más información. Asegúrate de dar el formato correcto a 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 Probar activador (en la pestaña Prueba).
    

11. Si la solicitud se realiza correctamente, verás un mensaje de éxito y los datos de prueba se mostrarán debajo del mensaje de éxito, de forma similar al ejemplo que aparece a continuación:
    

12. Una vez que el activador esté funcionando, haz clic en Continuar con el registro seleccionado.

Configurar una acción de Zapier

1. En el menú Acción, ingresa 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.

Configura la asignación de campos y crea la lógica del script

1. Configura la asignación de campos para correlacionar los datos de entrada de la siguiente tabla con los datos de prueba correctos que enviaste anteriormente.
   

1. Agrega un script como el que se muestra a continuación al cuadro de código:
   

import requests

# configuring sms subscribe or unsubscribe call
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 = { "data": {
        "type": "profile-subscription-bulk-create-job",
        "attributes": {
            "profiles": { "data": [
                    {
                        "type": "profile",
                        "attributes": {
                            "email": input_data["email"],
                            "phone_number": input_data["phone_number"],
                            "subscriptions": {
                                "sms": { "marketing": { "consent": "SUBSCRIBED" } }
                            }
                        }
                    }
                ] }
        },
        "relationships": { "list": { "data": {
                    "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/profile-subscription-bulk-delete-jobs/"
  payload = { "data": {
        "type": "profile-subscription-bulk-delete-job",
        "attributes": {
            "profiles": { "data": [
                    {
                        "type": "profile",
                        "attributes": {
                            "email": input_data["email"],
                            "phone_number": input_data["phone_number"],
                        }
                    }
                ] }
        },
        "relationships": { "list": { "data": {
                    "type": "list",
                    "id": "LIST_ID"
                } } }
    } }
headers = {
    "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=headers)

# Zapier requires an 'output' object
output = {"response text": response.text}

1. Reemplaza your-private-api-keypor tu clave de API privada de Klaviyo.
   

1. Reemplaza el LIST_ID (en ambas ubicaciones) por el ID de lista de Klaviyo al que quieres enviar tus datos de Zapier. Puedes encontrar el ID de lista en Klaviyo; ve a Audiencia > Listas y segmentos > Configuración. Si quieres suscribir a las personas de inmediato sin una 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 Consent dentro de la configuración de la lista).
2. Haz clic en Continuar y luego haz clic en Probar paso.
3. Si la prueba es exitosa, verás una respuesta sin errores, como la que aparece a continuación:
   

4. También puedes comprobar si la prueba se realizó correctamente en Klaviyo; para hacerlo, ve a la lista y asegúrate de que se agregó el perfil.
   

5. Una vez que la prueba sea exitosa, haz clic en Publicar para publicar el zap. Si la prueba no es exitosa, consulta nuestros consejos de solución de problemas para problemas comunes.

Consejos de solución de problemas

Los siguientes son problemas comunes con los que podrías encontrarte al configurar el webhook de Zapier. Si encuentras cualquier otro problema, puedes contactar con la Klaviyo Community para obtener más orientación.

EOL mientras se analizaba el literal de cadena

Si ves este error, falta una comilla alrededor de una de las variables. Revisa el ID de la lista y la clave de API privada para asegurarte de que estén entre comillas por ambos lados.

SyntaxError: sintaxis no válida

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

Recursos adicionales