---
title: "Conecta Klaviyo"
description: "Crea una clave de API privada en Klaviyo con los permisos adecuados, conéctala y suscribe a los nuevos registros a una lista de Klaviyo."
url: https://scratcher.io/es-419/help/integrations/klaviyo
language: es-419
---

1. [Centro de ayuda](https://scratcher.io/es-419/help)
2. [Integraciones](https://scratcher.io/es-419/help/integrations)
3. Conecta Klaviyo

# Conecta Klaviyo

Crea una clave de API privada en Klaviyo con los permisos adecuados, conéctala y suscribe a los nuevos registros a una lista de Klaviyo.

Con la integración de Klaviyo, cada persona que se registra se crea o actualiza como perfil en Klaviyo, se agrega a la lista que elijas y se suscribe al email marketing.

## Qué necesitas

- Una cuenta de Klaviyo. El plan gratuito funciona.
- Un usuario de Klaviyo que pueda crear claves de API privadas (en Klaviyo, normalmente es un **Owner**, **Admin** o **Manager**).

## Paso 1: Crea una clave de API privada en Klaviyo

1. En Scratcher, ve a **Configuración** > **Integraciones**, haz clic en **Klaviyo** y revisa la **Guía de configuración**: «Crea una clave de API privada. Los permisos correctos ya vienen preseleccionados».
2. Haz clic en el enlace **Crear una clave de API privada**. Klaviyo se abre con los permisos correctos ya seleccionados. Inicia sesión si Klaviyo te lo pide.
3. Ponle a la clave un nombre que reconozcas, por ejemplo «Scratcher».
4. Revisa los permisos (consulta la lista más abajo) y haz clic para crear la clave.
5. Copia la clave. Empieza con «pk\_». Klaviyo muestra la clave completa una sola vez, así que mantén la pestaña abierta hasta que la hayas pegado.

Si prefieres crear la clave tú mismo: en Klaviyo, abre el menú debajo del nombre de tu cuenta, ve a **Settings** > **API keys** y haz clic en **Create Private API Key**. Elige **Custom Key** y configura los permisos que se indican abajo.

## Permisos que necesita la clave

La clave necesita exactamente estos permisos (texto de ayuda de Scratcher: «La clave de API necesita acceso de lectura y escritura a "Lists" y "Profiles", y acceso de escritura a "Subscriptions"»).

- **Lists**: lectura y escritura. Para mostrar tus listas y agregar personas a ellas.
- **Profiles**: lectura y escritura. Para crear y actualizar perfiles.
- **Subscriptions**: escritura. Para suscribir personas al email marketing.

Todos los demás permisos pueden quedarse en **No Access**.

## Paso 2: Conecta Klaviyo con Scratcher

1. En el cuadro de diálogo de Klaviyo en Scratcher, pega la clave en **Clave de API privada**. El recuadro **Permisos de acceso** muestra lo que Scratcher puede hacer: «Acceso de lectura y escritura a Contactos y Listas» y «Sincronización automática en segundo plano de los participantes de la campaña».
2. Haz clic en **Instalar integración**. Scratcher verifica que la clave pueda leer tus listas.

## Paso 3: Actívala en una campaña

1. En el editor, ve a **Conectar** > **Integraciones** > **Klaviyo** y haz clic en **Activar**.
2. Si conectaste más de una cuenta de Klaviyo, elígela en **Seleccionar cuenta**.
3. En **Lista externa**, elige la lista de Klaviyo.
4. En **Asignación de campos**, agrega los datos adicionales que quieras en el perfil. Aquí escribes tú mismo el nombre de la propiedad en Klaviyo (**Nombre del campo externo**), por ejemplo «favourite\_product» o «Campaign».
5. En **Filtrar por permisos (opcional)**, elige tu casilla de consentimiento de marketing.
6. Haz clic en **Guardar** y luego en **Probar**.

## Asignación de campos

- El correo electrónico, el número de teléfono, el nombre y el apellido se envían automáticamente a los campos de perfil propios de Klaviyo. No necesitas asignarlos.
- Todo lo que asignes se guarda como propiedad personalizada en el perfil, con el nombre que escribiste. Si la propiedad todavía no existe, Klaviyo la crea.
- Klaviyo solo acepta números de teléfono con + y código de país. Asegúrate de que el campo de teléfono de tu formulario incluya el código de país.

## Consentimiento

Scratcher suscribe al email marketing de Klaviyo a todas las personas que envía, con «Scratcher» como origen. Por eso es importante el filtro de consentimiento: elige tu casilla de marketing en **Filtrar por permisos (opcional)** si es opcional en tu formulario.

Si tu lista de Klaviyo usa doble opt-in, Klaviyo envía su propio correo de confirmación y las personas solo quedan suscritas cuando confirman. Después puedes iniciar un flujo de bienvenida en Klaviyo cuando se agreguen personas a la lista.

## Qué se envía y cuándo

Los nuevos registros se envían en uno o dos minutos. Al activar la integración, también se envían los leads que ya tiene la campaña. Cuando alguien vuelve a participar, su perfil se actualiza.

## Solución de problemas

Los envíos fallidos aparecen en **Configuración** > **Integraciones** > **Estado de envío**.

- «The API key used does not have the correct API Scopes.»: a la clave le falta alguno de los permisos indicados arriba. Edita la clave en Klaviyo, o crea una nueva con el enlace de configuración y conéctala con **Agregar nueva cuenta**.
- «Conflict: Duplicate profile detected.»: Klaviyo encontró dos perfiles que coinciden, por ejemplo uno con el correo electrónico y otro con el mismo número de teléfono. Combina o corrige los perfiles en Klaviyo y vuelve a enviar.
- Se rechaza un número de teléfono: el número no tiene código de país. Agrega un selector de país al campo de teléfono de tu formulario.
- No llega nada después de instalar: verifica que haya una lista seleccionada en **Lista externa** dentro de la campaña y que hayas hecho clic en **Guardar**.

Integraciones

- [Cómo funcionan las integraciones](https://scratcher.io/es-419/help/integrations/how-integrations-work)
- [Todas las integraciones](https://scratcher.io/es-419/help/integrations/other-integrations)
- [Revisa el estado de envío y reenvía leads](https://scratcher.io/es-419/help/integrations/delivery-status)
- [Conecta HubSpot](https://scratcher.io/es-419/help/integrations/hubspot)
- [Conecta Salesforce Marketing Cloud](https://scratcher.io/es-419/help/integrations/salesforce-marketing-cloud)
- [Conecta Microsoft Dynamics 365 con Zapier](https://scratcher.io/es-419/help/integrations/microsoft-dynamics-365)
- [Conecta Emarsys](https://scratcher.io/es-419/help/integrations/emarsys)
- [Conecta Klaviyo](https://scratcher.io/es-419/help/integrations/klaviyo)
- [Conecta Mailchimp](https://scratcher.io/es-419/help/integrations/mailchimp)
- [Conecta ActiveCampaign](https://scratcher.io/es-419/help/integrations/activecampaign)
- [Conecta Apsis One](https://scratcher.io/es-419/help/integrations/apsis-one)
- [Conecta Drip](https://scratcher.io/es-419/help/integrations/drip)
- [Conecta HeyLoyalty](https://scratcher.io/es-419/help/integrations/heyloyalty)
- [Conecta Peytz](https://scratcher.io/es-419/help/integrations/peytz)
- [Conecta Marketingplatform](https://scratcher.io/es-419/help/integrations/marketingplatform)
- [Conecta Campaign Monitor con Zapier](https://scratcher.io/es-419/help/integrations/campaign-monitor)
- [Conecta ActiveTrail con Zapier](https://scratcher.io/es-419/help/integrations/activetrail)
- [Conecta Bloomreach](https://scratcher.io/es-419/help/integrations/bloomreach)
- [Conecta Iterable](https://scratcher.io/es-419/help/integrations/iterable)
- [Conectar Mapp](https://scratcher.io/es-419/help/integrations/mapp)
- [Conecta Agillic](https://scratcher.io/es-419/help/integrations/agillic)
- [Conecta Ortto](https://scratcher.io/es-419/help/integrations/ortto)
- [Conecta Emarketeer](https://scratcher.io/es-419/help/integrations/emarketeer)
- [Conecta Shopify](https://scratcher.io/es-419/help/integrations/shopify)
- [Conecta Hello Retail](https://scratcher.io/es-419/help/integrations/hello-retail)
- [Conecta más de 8.000 apps con Zapier](https://scratcher.io/es-419/help/integrations/zapier)
- [Conecta monday.com con Zapier](https://scratcher.io/es-419/help/integrations/monday-com)
- [Conecta Asana con Zapier](https://scratcher.io/es-419/help/integrations/asana)
- [Conecta Podio con Zapier](https://scratcher.io/es-419/help/integrations/podio)
- [Conecta Intercom con Zapier](https://scratcher.io/es-419/help/integrations/intercom)

Sigue aprendiendo

## Artículos relacionados

- [Cómo funcionan las integraciones](https://scratcher.io/es-419/help/integrations/how-integrations-work): Conecta tu herramienta de email o CRM una sola vez, actívala en cada campaña, elige una lista, asigna tus campos y envía solo a las personas que dieron su consentimiento.
- [Revisa el estado de envío y reenvía leads](https://scratcher.io/es-419/help/integrations/delivery-status): Consulta qué leads se enviaron a tus herramientas, entiende los mensajes de error, soluciona el problema y vuelve a enviarlos.
- [Solicita el consentimiento y agrega términos y condiciones](https://scratcher.io/es-419/help/forms/consent-and-permissions): Agrega casillas de consentimiento para newsletters, enlaza tus términos, elige qué casilla suscribe a las personas y envía a tu herramienta de email solo a quienes dijeron que sí.

¿Necesitas ayuda?

## ¿Sigues necesitando ayuda?

Hay personas reales para ayudarte. Si ya usas Scratcher, lo más rápido es el chat dentro de la plataforma.

- **[Chatea con nosotros](https://platform.scratcher.io/es-419/login)**

    Inicia sesión y haz clic en el botón del chat, abajo a la derecha. Rex responde al instante y nuestro equipo está a un clic.
- **[Agenda una reunión](https://scratcher.io/es-419/book-a-meeting)**

    Una videollamada gratuita de 30 minutos con nuestro equipo: una demostración, ideas para campañas o ayuda con tu configuración.
- **[Escríbenos](mailto:contact@scratcher.io)**

    Escribe a contact@scratcher.io y te responderemos.
