Integración con Klaviyo — sincronizar audiencias con listas y enviar eventos

×

Haga clic en cualquier lugar o pulse Esc para cerrar

Klaviyo gestiona sus flujos de email y SMS; Personyze sabe lo que hace cada visitante en su sitio. Una vez conectados, las audiencias que crea Personyze alimentan a Klaviyo: los visitantes que coinciden pasan a listas de Klaviyo, y la actividad de las campañas llega como eventos a sus perfiles — así, una serie de bienvenida, un flujo de recuperación o de nutrición puede reaccionar a comportamientos en el sitio como “visitó dos veces la página de precios, tiene email y no ha comprado.”

Instalar la integración

1. En el panel de Personyze, vaya a Configuración → Integraciones, abra la tarjeta Klaviyo y haga clic en Conectar con Klaviyo.
2. Se abre una ventana emergente con la pantalla de consentimiento de Klaviyo. Apruebe los permisos solicitados:
   • accounts:read — una única llamada de prueba de conexión al conectar.
   • lists:read, lists:write, profiles:read, profiles:write — la automatización “Añadir a lista de Klaviyo”.
   • events:write — la automatización “Enviar evento”.
3. La ventana muestra Acceso concedido y el panel lateral muestra Conectado. Ya está — sin claves de API, nada que rotar.

Uso 1 — añadir las audiencias coincidentes a una lista de Klaviyo

1. En Klaviyo, cree (o elija) una lista y anote su ID de lista de seis caracteres — abra la lista en Lists & Segments y copie el ID de la URL.
2. En Personyze, cree una campaña de Automatización (Campañas → Nueva → Automatización) y defina la audiencia — las reglas que quiera: páginas visitadas, productos vistos, campos del CRM, “tiene dirección de email”.
3. Añada la acción Añadir a lista de Klaviyo y pegue el ID de la lista. Publique.
4. A medida que los usuarios coinciden con la audiencia, sus perfiles aparecen en la lista de Klaviyo — insertados o actualizados por email y deduplicados por Klaviyo, así que volver a coincidir nunca crea duplicados. La coincidencia se ejecuta aproximadamente cada 20 minutos; el paso QA de la campaña tiene un botón Comprobar ahora para ejecutarla de inmediato.

Cuelgue su flujo de Klaviyo de esa lista, y la segmentación de Personyze en el sitio lo pondrá en marcha.

Uso 2 — enviar eventos a los perfiles de Klaviyo

1. En la misma automatización (o en cualquier otra), añada Enviar evento a analítica (Automatización) y marque Klaviyo.
2. Ponga nombre al evento — p. ej. Personyze Audience Matched — y, si quiere, añada propiedades. Los valores de las propiedades pueden tomarse del perfil de Personyze de la persona (sector, fase del ciclo de vida, cualquier campo personalizado) y de métricas de la campaña en directo.
3. Cuando se activa la automatización, el evento aparece en el feed de actividad del perfil coincidente en Klaviyo — listo para activar flujos o crear segmentos.

También funciona sin conectar

• Eventos en la página — la acción normal (en el sitio) Enviar evento a analítica puede enviar eventos onsite de Klaviyo a través de klaviyo.js en su página, sin necesidad de conectar la cuenta.
• Formularios de captación de leads — el paso Adónde van los datos de un formulario de Personyze puede enviar cada envío a Klaviyo como un evento Personyze Form Submitted en el perfil que coincide con el email enviado (esta vía antigua usa una clave privada pegada con permiso de escritura de Events; los formularios sin campo de email se omiten).

Conectar mediante OAuth es lo que habilita las automatizaciones a nivel de cuenta descritas arriba, sin claves en ningún formulario.

Desconectar

Configuración → Integraciones → Klaviyo → Desconectar (o Revocar acceso en la ventana de conexión). Todas las llamadas a la API se detienen de inmediato; al volver a conectar se restablecen. Klaviyo guarda su propio registro de las apps instaladas — para quitarla también allí, vaya a Settings → API keys & apps en Klaviyo y desinstale Personyze.

Notas de seguridad

La autorización usa el código de autorización de OAuth 2.0 con PKCE (S256). Los tokens de acceso y de actualización se guardan solo en el servidor y nunca se exponen al navegador; los tokens de actualización rotan en cada renovación.

Resolución de problemas

• El perfil no aparece en la lista — la persona debe tener una dirección de email en su perfil de Personyze (es la clave con la que Klaviyo inserta o actualiza). Compruebe que el ID de lista es el de seis caracteres de la URL, y use Comprobar ahora en el paso QA en lugar de esperar al ciclo de unos 20 minutos.
• El evento no aparece — los eventos se asocian al perfil coincidente; confirme que la misma persona existe en Klaviyo (la acción de lista la crea, así que ejecútela primero o junto con los eventos).
• El panel lateral dice que no está conectado después de aprobar — la ventana verifica la autorización con una llamada GET /api/accounts/ ; si su usuario de Klaviyo no tiene permiso para instalar apps, la autorización falla ahí. Vuelva a conectar con un inicio de sesión de Klaviyo de propietario o administrador.

Relacionado

• Segmentación de campañas — las reglas de audiencia con las que funcionan las automatizaciones.
• Integración con Google Analytics — la misma acción de eventos puede informar a GA4, Segment, Tealium y la capa de datos de GTM.
• Enviar evento a analítica — todos los destinos a los que puede llegar la misma acción, y lo que necesita cada uno.
• Integración con ActiveCampaign — la misma acción otra vez, solo en su versión Automatización: etiqueta un contacto en lugar de enviar un evento.