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
- 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».
- 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.
- Ponle a la clave un nombre que reconozcas, por ejemplo «Scratcher».
- Revisa los permisos (consulta la lista más abajo) y haz clic para crear la clave.
- 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
- 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».
- Haz clic en Instalar integración. Scratcher verifica que la clave pueda leer tus listas.
Paso 3: Actívala en una campaña
- En el editor, ve a Conectar > Integraciones > Klaviyo y haz clic en Activar.
- Si conectaste más de una cuenta de Klaviyo, elígela en Seleccionar cuenta.
- En Lista externa, elige la lista de Klaviyo.
- 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».
- En Filtrar por permisos (opcional), elige tu casilla de consentimiento de marketing.
- 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.