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 (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.