Para poder incluir acciones externas en los flujos de acciones, primero se debe conectar el generador de acciones con el sistema externo.

¿Qué plan tengo?
Suite, todas las versiones Team, Growth, Professional, Enterprise o Enterprise Plus
Support Team, Professional o Enterprise

Resumen: ◀▼

Los flujos de acciones se pueden conectar a Klaviyo mediante una clave de API para automatizar la administración de perfiles de clientes, hacer seguimiento de los eventos, enumerar las suscripciones y crear campañas. Esta integración se puede usar para crear, actualizar y buscar perfiles, administrar listas y métricas y manejar campañas. Use una cuenta de servicio exclusiva para proteger las conexiones y revisar los permisos cuidadosamente con el fin de mantener el control sobre los datos y las acciones que se realizan a través de la integración.

Si el generador de acciones se conecta con sistemas externos, como Klaviyo, los administradores pueden integrar Zendesk con sistemas externos en los flujos de trabajo automatizados, lo que mejora la colaboración y mantiene una experiencia fluida en las distintas plataformas.
Nota: Los pasos asociados a los sistemas externos en los flujos de acciones se denominan colectivamente acciones externas.
En este artículo se tratan los siguientes temas:
  • Conectar Klaviyo con el generador de acciones
  • Usar las acciones de Klaviyo en los flujos de acciones

Conectar Klaviyo con el generador de acciones

Para poder incluir acciones externas en los flujos de acciones, primero se debe conectar el generador de acciones con el sistema externo.

Las siguientes prácticas son las más recomendadas a la hora de conectarse a sistemas externos para usarlos en flujos de acciones:
  • Todas las acciones externas realizadas por un flujo de acciones se atribuyen al usuario que conectó el sistema externo. Por esta razón, cuando vaya a conectarse a cada sistema externo, lo que conviene es usar una cuenta dedicada exclusivamente a este servicio, y no una cuenta que emplee credenciales personales.
  • Todas las integraciones solicitan acceso a los ámbitos necesarios. Sin embargo, es importante que revise y valide los ámbitos antes de autorizar la conexión al sistema externo.
  • Cuando necesite administrar credenciales para herramientas que funcionan con claves API (como OpenAI), lo mejor es guardar las claves en una bóveda o con un administrador de credenciales.

Para crear una clave de API

La conexión de Klaviyo requiere una clave de API para la autenticación. Si desea obtener instrucciones detalladas, consulte la documentación sobre las credenciales de API de Klaviyo.
Importante: Guarde su clave de API en un lugar seguro y no la comparta. La clave da acceso a su cuenta de Klaviyo y permite que los flujos de acciones realicen operaciones en su nombre.
  1. Inicie sesión en su cuenta de Klaviyo.
  2. Vaya a Configuración > Claves API.
  3. Copie la clave con este formato: Klaviyo-API-Key {your_key}
  4. Guarde la clave de API o mantenga abierta la ventana para poder copiarla y pegarla en Zendesk.

    La necesitará para conectar Klaviyo con el generador de acciones.

Para conectar el generador de acciones con Klaviyo
  1. En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione Acciones > Flujos de acciones.
  2. Cree o edite un flujo de acciones.
  3. Abra la barra lateral de pasos.
  4. En Acciones externas, haga clic en Klaviyo.
  5. Haga clic en Conectar.
  6. Siga las indicaciones para ingresar su clave de API de Klaviyo y completar la conexión. Pegue la clave completa, incluido el prefijo.

    Una vez que autorice la conexión, se le redirigirá a Klaviyo para otorgar permisos a su cuenta de Zendesk.

    La conexión de Klaviyo utiliza OAuth 2.0 con el tipo de concesión de código de autorización. Examine los permisos cuidadosamente antes de autorizar la conexión. Gracias a ellos, los flujos de acciones pueden crear y modificar páginas, agregar comentarios, administrar artículos de la base de datos y actualizar el contenido en su espacio de trabajo de Klaviyo en su nombre.

    Nota: Todas las acciones externas realizadas por un flujo de acciones se atribuyen al usuario que conectó el sistema externo. Por esta razón, cuando vaya a conectarse a cada sistema externo, lo que conviene es usar una cuenta dedicada exclusivamente a este servicio, y no una cuenta que emplee credenciales personales.

Después de conectarse al sistema, verá un indicador de conexión y detalles sobre la instancia a la que está conectado, así como las acciones disponibles para Klaviyo.

Usar las acciones de Klaviyo en los flujos de acciones

Están disponibles las siguientes acciones de Klaviyo:
  • Crear perfil
  • Actualizar perfil
  • Buscar perfil
  • Crear evento
  • Suscribir perfil a la lista
  • Eliminar perfil de la lista
  • Buscar lista
  • Listas
  • Crear lista
  • Buscar métrica
  • Lista de métricas
  • Crear campaña
  • Buscar campaña
  • Mostrar campañas

Crear un perfil

Utilice la acción Crear perfil para crear un nuevo perfil de cliente en Klaviyo con la información y los atributos de contacto.

Esta acción tiene las siguientes entradas y salidas:

  Variables
Entrada Opcional: Email, Phone number, First name, Last name, Organization, Title, Image URL, Address line 1, Address line 2, City, Region/State, Country, Zip/Postal code

Los números de teléfono deben seguir el formato E.164 con un signo +, el código de país y el número de abonado sin espacios ni caracteres especiales (p. ej., +15551234567).
Salida Devuelve un objeto con ID de perfil, correo electrónico, número de teléfono, primer nombre, apellido, organización, título, imagen, marcas de tiempo de creación y actualización y el objeto ubicación (con dirección1, dirección2, ciudad, región, país, código postal).

Actualizar un perfil

Utilice la acción Actualizar perfil para actualizar el perfil de un cliente existente en Klaviyo añadiéndole nueva información.

Esta acción tiene las siguientes entradas y salidas:

  Variables
Entrada Requerido: Profile ID

Opcional: Email, Phone number, First name, Last name, Organization, Title, Image URL, Address line 1, Address line 2, City, Region/State, Country, Zip/Postal code

Los números de teléfono deben seguir el formato E.164 con un signo +, el código de país y el número de abonado sin espacios ni caracteres especiales (p. ej., +15551234567).
Salida Devuelve un objeto con ID de perfil, correo electrónico, número de teléfono, primer nombre, apellido, organización, título, imagen, marcas de tiempo de creación y actualización y el objeto ubicación (con dirección1, dirección2, ciudad, región, país, código postal).

Buscar un perfil

Utilice la acción Buscar perfil para obtener un solo perfil de cliente por ID, correo electrónico o número de teléfono.

Esta acción tiene las siguientes entradas y salidas:

  Variables
Entrada Requerido: Identity profile by, Profile identifier

Los perfiles se pueden identificar por ID, correo electrónico o número de teléfono. El campo Identificador de perfil se hace visible después de seleccionar el método de identificación.
Salida Devuelve un objeto con ID de perfil, correo electrónico, número de teléfono, primer nombre, apellido, organización, título, imagen, marcas de tiempo de creación y actualización y el objeto ubicación (con dirección1, dirección2, ciudad, región, país, código postal).

Crear un evento

Utilice la acción Crear evento en Klaviyo para gatillar flujos y medir la interacción.

Esta acción tiene las siguientes entradas y salidas:

  Variables
Entrada Requerido: Metric name, Profile ID

Opcional: Properties, Timestamp

Las propiedades deben proporcionarse como pares clave-valor en formato JSON. La marca de tiempo debe seguir el formato ISO 8601 (p. ej., 2025-01-15T14:30:00Z) y, si no se facilita, adopta la hora actual.
Salida Devuelve un objeto con nombre de métrica, ID de perfil y el objeto propiedades.

Suscribir un perfil a una lista

Utilice la acción Suscribir perfil a la lista para agregar un perfil a una lista con dos parámetros opcionales: consentimiento para recibir correo electrónico y consentimiento para recibir SMS.

Esta acción tiene las siguientes entradas y salidas:

  Variables
Entrada Requerido: List

Opcional: Email, Phone number, Profile ID, Email consent, SMS consent

Los números de teléfono deben seguir el formato E.164. Las opciones de consentimiento para recibir correo electrónico y consentimiento para recibir SMS incluyen Sí - Suscribirse al correo electrónico/a SMS (suscrito) o No - No suscribirse al correo electrónico/a SMS (ninguno).
Salida Devuelve un objeto con el estado de éxito (booleano) y un mensaje.

Eliminar un perfil de una lista

Utilice la acción Eliminar perfil de la lista para eliminar un perfil de una lista específica en Klaviyo.

Esta acción tiene las siguientes entradas y salidas:

  Variables
Entrada Requerido: List, Profile ID
Salida Devuelve un objeto con el estado de éxito (booleano) y un mensaje.

Buscar una lista

Utilice la acción Buscar lista para obtener los detalles de una lista específica por ID o nombre.

Esta acción tiene las siguientes entradas y salidas:

  Variables
Entrada Requerido: Identify list by, List identifier

Las listas se pueden identificar por ID o Nombre. El campo Identificador de lista se vuelve visible después de seleccionar el método de identificación.
Salida Devuelve un objeto con ID de lista, nombre, marcas de tiempo de creación y actualización y el proceso de consentimiento.

Listas

Utilice la acción Listas para obtener todas las listas en Klaviyo con filtrado de nombre y paginación opcionales.

Esta acción tiene las siguientes entradas y salidas:

  Variables
Entrada

Opcional: Name, Page cursor
Salida Devuelve un objeto con matriz de listas (cada una con ID, nombre, marcas de tiempo de creación y actualización y el proceso de consentimiento), así como un cursor de página siguiente para la paginación.

Crear listas

Utilice la acción Crear lista para crear una nueva lista en Klaviyo para los perfiles organizadores.

Esta acción tiene las siguientes entradas y salidas:

  Variables
Entrada

Requerido: Name
Salida Devuelve un objeto con ID de lista, nombre, marcas de tiempo de creación y actualización y el proceso de consentimiento.

Buscar una métrica

Utilice la acción Buscar métrica para obtener los detalles de una métrica específica por ID.

Esta acción tiene las siguientes entradas y salidas:

  Variables
Entrada

Requerido: Metric ID
Salida Devuelve un objeto con ID de métrica, nombre, marcas de tiempo de creación y actualización y un objeto de integración (con ID, nombre y categoría).

Lista de métricas

Utilice la acción Lista de métricas para obtener todas las métricas en Klaviyo con filtrado y paginación opcionales. Utilice esta acción para descubrir métricas de eventos disponibles para hacer seguimiento del comportamiento del cliente.

Esta acción tiene las siguientes entradas y salidas:

  Variables
Entrada

Opcional: Integration name, Integration category, Page cursor
Salida Devuelve un objeto con matriz de métricas (cada una con ID, nombre, marcas de tiempo de creación y actualización y un objeto integración con ID, nombre y categoría), así como un cursor de página siguiente para la paginación.

Crear campañas

Utilice la acción Crear campaña para crear una nueva campaña de marketing en Klaviyo con el canal de correo electrónico o SMS.

Esta acción tiene las siguientes entradas y salidas:

  Variables
Entrada

Requerido: Name, List, Channel, Send strategy

Opcional: Subject, Preview text, From email, From name, Reply-to email

Hay dos opciones de canal: correo electrónico o SMS.

Las opciones para la estrategia de envío son: inmediato, programado (estático), acelerado o tiempo de envío inteligente. La línea de asunto es obligatoria para las campañas de correo electrónico.
Salida Devuelve un objeto con ID de campaña, nombre, estado, canal, marcas de tiempo de creación y actualización y la hora de envío.

Buscar una campaña

Utilice la acción Buscar campaña para obtener los detalles de una campaña específica por ID o nombre.

Esta acción tiene las siguientes entradas y salidas:

  Variables
Entrada

Requerido: Identify campaign by, Campaign identifier

Cuando la búsqueda se hace por Nombre (contiene), se devuelve la primera coincidencia.

El campo Identificador de campaña se vuelve visible después de seleccionar el método de identificación.
Salida Devuelve un objeto con ID de campaña, nombre, estado, canal, marcas de tiempo de creación y actualización, hora de envío y estado de archivado (booleano).

Mostrar campañas

Utilice la acción Mostrar campañas para obtener campañas en Klaviyo con filtrado y paginación opcionales.

Esta acción tiene las siguientes entradas y salidas:

  Variables
Entrada

Requerido: Channel

Opcional: Name, Status, Archived, Page cursor

Las opciones para el estado son borrador, programado, enviado o cancelado.

El filtro Archivado acepta Sí o No.
Salida Devuelve un objeto con matriz de campañas (cada una con ID, nombre, estado, canal, marca de tiempo de creación y actualización, hora de envío y estado de archivado), así como un cursor de página siguiente para la paginación.
Tecnología de Zendesk