Ir al contenido
Rex, tu asistente de IA: él se encarga del trabajo pesado, las ideas son tuyas 👉 Conoce a Rex

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

    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

    Una videollamada gratuita de 30 minutos con nuestro equipo: una demostración, ideas para campañas o ayuda con tu configuración.

  • Escríbenos

    Escribe a contact@scratcher.io y te responderemos.