Configurar Klaviyo o Mailchimp

Wavize sincroniza contactos hacia una audiencia específica

Klaviyo y Mailchimp tienen páginas de configuración separadas. Cada integración requiere una clave API, un ID de lista/audiencia, un modo de sincronización y un estado activo. Al modificar, dejar el campo de clave vacío mantiene el secreto ya registrado.

Perfil solo crea o actualiza el perfil sin solicitar consentimiento de marketing. El doble opt-in inicia el proceso de confirmación del proveedor: el contacto se suscribe solo tras la acción esperada.

Seguridad común
Cree una clave dedicada para Wavize, cópiela una vez en el formulario cifrado, no la envíe por correo ni capturas, y révoquela si se expone.

Configurar Klaviyo con una clave privada

Wavize usa endpoints de servidor: la clave pública de seis caracteres, llamada Site ID, no es válida.

1. Crear clave

   En Klaviyo: Settings > API keys > Private API Keys > Create Private API Key. Se requiere rol Owner, Admin o Manager. Asigne el nombre Wavize y copie el valor que inicia con pk_ al crearla.

2. Elegir scopes

   La verificación lee cuentas y lista; la sincronización crea/actualiza perfiles y, en doble opt-in, suscripciones. Otorgue al menos lectura de accounts/lists y escritura de profiles/subscriptions para los endpoints.

3. Encontrar el identificador de lista

   Abra Audience > Lists & Segments y seleccione la lista objetivo. Copie el ID de la lista desde sus ajustes o URL, no su nombre mostrado. Wavize lo valida con /lists/{id}.

Configurar Mailchimp con clave y Audience ID

La clave Mailchimp Marketing API normalmente contiene el centro de datos tras un guion, p.ej. -us21.

1. Crear clave

   En Mailchimp: icono Perfil > Profile > Extras > API keys > Create A Key. Nómbrala Wavize, genera y copia inmediatamente: Mailchimp solo muestra su nombre y caracteres iniciales luego.

2. Mantener sufijo datacenter

   Wavize extrae el sufijo tras el último guion para llamar al host API correcto. Una clave sin -usXX no puede enrutar correctamente.

3. Encontrar Audience ID

   En Audience > All contacts > Settings > Audience name and defaults, copie Audience ID. No es el nombre público ni un ID de campaña.

Elegir perfil solo o doble opt-in

El modo debe ajustarse a su base legal y el texto mostrado en el widget.

• Perfil solo

  Klaviyo recibe un perfil; Mailchimp usa estado transactional. El contacto no se presenta como suscriptor de marketing y puede usarse para fines autorizados no promocionales.

• Doble opt-in

  Klaviyo inicia tarea de suscripción de perfil; Mailchimp deja al miembro en pending. La dirección debe confirmar según el proveedor antes de estar activa para marketing.

• Campos sincronizados

  Correo válido obligatorio, teléfono E.164 cuando existe, nombre, apellidos, organización, localización y propiedades útiles de Wavize. Los campos Mailchimp FNAME/LNAME deben existir o ser compatibles en la audiencia.

Verificar y probar un contacto real de prueba

Wavize prueba primero la cuenta y audiencia antes de activar la sincronización.

1. Verificación Klaviyo

   El servidor llama a /accounts y luego /lists/{id}. Un 403 suele indicar scope faltante; un 404, un ID de lista incorrecto para la cuenta.

2. Verificación Mailchimp

   El servidor llama a /ping y luego /lists/{id}. Error de datacenter suele deberse al sufijo de clave; audiencia no encontrada, a un ID incorrecto.

3. Contacto de prueba

   Envíe una dirección del equipo desde el widget, verifique su creación en Wavize y llegada al proveedor. En doble opt-in, abra y confirme el mensaje antes de concluir.

Rotación e incidente

Una clave nueva no reemplaza automáticamente la antigua en Wavize.

• Crear — Nueva clave dedicada con permisos mínimos iguales.
• Actualizar y probar — Ingrese valor nuevo, mantenga audiencia y modo, luego verifique.
• Revocar — Elimine la clave antigua solo en el proveedor después de prueba exitosa.