# Integración de Klaviyo La integración Klaviyo te permite conectar tu chatbot Botpress con Klaviyo, una plataforma líder de datos de clientes y automatización de marketing. Con esta integración, tu chatbot puede crear clientes potenciales, actualizar la información de los clientes y suscribir perfiles a SMS y Email marketing. ## Acciones disponibles ### Crear Perfil Crear un nuevo perfil de cliente en Klaviyo. Esta acción te permite añadir nuevos contactos a tu base de datos de Klaviyo con información completa del perfil. **Campos Requeridos:** - Ya sea **dirección de correo electrónico** O **número de teléfono** (en formato E.164 como +15005550006) **Campos opcionales - Nombre** y **apellido** - Organización** y **cargo**. - Configuración regional** (en formato IETF BCP 47 como en-US, fr-FR) - Localización** (detalles de la dirección, incluidas las líneas de dirección, la ciudad, el país, la región y el código postal) - Propiedades personalizadas** (pares clave-valor para almacenar datos adicionales del perfil) **Salida:** Devuelve el perfil creado con su ID único de Klaviyo. ### Actualizar Perfil Actualiza un perfil de cliente existente en Klaviyo usando el ID único del perfil. Esta acción le permite modificar cualquier información del perfil después de la creación. **Campos Requeridos - ID del perfil** (el identificador único de Klaviyo del perfil a actualizar) **Campos opcionales - **Dirección de correo electrónico** (actualiza el correo electrónico del perfil) - Número de teléfono** (en formato E.164) - Nombre** y **apellido** - Organización** y **cargo**. - Localización** (en formato IETF BCP 47) - Localización** (información completa sobre la dirección) - Propiedades personalizadas** (pares clave-valor) **Salida:** Devuelve el perfil actualizado con toda la información actual. ### Obtener perfil Recupera el perfil de un cliente específico de Klaviyo usando su ID único. Esta acción es útil para buscar información de clientes individuales. **Campos Requeridos:** - ID del perfil** (el identificador único de Klaviyo del perfil a recuperar) **Salida:** Devuelve la información completa del perfil incluyendo ID, email, teléfono, nombre y todos los demás datos almacenados. ### Obtener Perfiles Busca y recupera múltiples perfiles de clientes desde Klaviyo utilizando filtros y opciones de ordenación. Esta acción es perfecta para encontrar grupos de clientes basados en criterios específicos. **Opciones de filtro:** - Campo de filtro:** Elija entre `id`, `email`, `phone_number`, `external_id`, `created`, o `updated`. - Operador del filtro:** Utilice operadores de comparación como "igual", "contiene", "mayor que", "menor que", "empieza por" o "termina por". - Valor del filtro:** El valor a buscar (admite cadenas y fechas) **Paginación y ordenación:** - Tamaño de página:** Número de perfiles a devolver (1-100, por defecto: 20) - Ordenar:** Ordenar por cualquier campo con orden descendente opcional (prefijo con `-`) **Ejemplos de uso - Buscar todos los perfiles creados después de una fecha específica - Buscar perfiles con direcciones de correo electrónico que contengan un dominio - Obtener perfiles ordenados por fecha de creación (el más reciente primero) **Salida:** Devuelve una matriz de perfiles que coinciden con sus criterios. ### Suscribir Perfiles Suscribe múltiples perfiles de clientes a listas de marketing por email y/o SMS en Klaviyo. Esta acción procesa las suscripciones de forma asíncrona y puede manejar hasta 1.000 perfiles a la vez. **Campos Requeridos - Suscripciones de perfiles:** Conjunto de perfiles con información de consentimiento - ID del perfil** (o correo electrónico/teléfono para identificación) - Consentimiento por correo electrónico:** Booleano que indica el consentimiento para el marketing por correo electrónico - Consentimiento SMS:** Booleano que indica el consentimiento para el marketing por SMS **Campos opcionales - ID de lista:** Lista específica de Klaviyo a la que añadir perfiles suscritos - Importación histórica:** Booleano para importar perfiles históricos **Notas importantes - Máximo 1.000 perfiles por solicitud - Se requiere al menos un perfil - Las banderas de consentimiento determinan a qué canales de marketing se suscribirá el perfil - La operación es procesada de forma asíncrona por Klaviyo **Salida:** Devuelve un booleano de éxito que indica si el trabajo de suscripción se programó correctamente.
