Conecta tu cuenta de Klaviyo a Goodweek para gestionar perfiles, listas, segmentos, campañas, flujos y eventos directamente desde tu espacio de trabajo de IA.
ℹ️ Nota sobre la gobernanza
Goodweek nunca superará los niveles de acceso concedidos al usuario dentro de Klaviyo, garantizando la alineación con las políticas de gobernanza de tu organización. Los resultados y las funciones disponibles pueden variar según los permisos específicos y el acceso autenticado de cada usuario.
📋 Requisitos previos
Antes de que cualquier usuario pueda ver y conectar la integración de Klaviyo, el administrador de tu organización debe habilitarla primero desde el Panel de administración de Goodweek, en la pestaña Integraciones.
Configuración del administrador
La integración de Klaviyo utiliza una clave de API. No se requiere ningún flujo OAuth ni aprobación a nivel de administrador dentro de Klaviyo. El usuario que realiza la conexión debe generar una clave de API privada desde su cuenta de Klaviyo.
⚠️ Solo los usuarios con acceso a claves de API pueden conectarse
En Klaviyo, solo los usuarios con el rol de Propietario, Administrador o Gestor pueden crear claves de API privadas. Los usuarios estándar (Analista, Visualizador o roles personalizados sin acceso a la API) no pueden generar una clave y no podrán conectarse.
Si un usuario estándar necesita conectarse, pide a un propietario o administrador de tu cuenta de Klaviyo que genere una clave de API privada en su nombre y la comparta de forma segura.
Generar una clave de API privada de Klaviyo
Antes de conectarte en Goodweek, debes generar una clave de API privada desde tu cuenta de Klaviyo:
Inicia sesión en Klaviyo.
Ve a Configuración → Cuenta → Claves de API.
Desplázate hasta Claves de API privadas y haz clic en Crear clave de API privada.
Asigna a la clave un nombre descriptivo (por ejemplo, Goodweek).
Selecciona Clave personalizada y concede como mínimo Acceso completo a los ámbitos relevantes para tu caso de uso (Perfiles, Listas, Segmentos, Campañas, Eventos, Flujos).
Haz clic en Crear y copia la clave inmediatamente: Klaviyo solo la muestra una vez.
Conexión del usuario
En Goodweek, ve a Integraciones.
Busca Klaviyo y haz clic en Conectar.
Pega tu clave de API privada de Klaviyo en el campo proporcionado.
Haz clic en Conectar para completar la configuración.
Notas importantes
Cada usuario debe conectarse usando su propia clave de API.
La clave de API hereda los permisos del usuario que la creó.
Si la clave de API se revoca o elimina en Klaviyo, la integración dejará de funcionar. Genera una nueva clave y vuelve a conectarte.
Puedes revocar el acceso de Goodweek en cualquier momento eliminando la clave de API desde Klaviyo → Configuración → Cuenta → Claves de API → Claves de API privadas.
Herramientas disponibles
Herramienta | Descripción | Tipo |
Obtener perfiles | Recupera una lista paginada de perfiles en la cuenta de Klaviyo. | Lectura |
Obtener perfil | Recupera un perfil específico de Klaviyo por su ID. | Lectura |
Crear perfil | Crea un nuevo perfil en la cuenta de Klaviyo. | Escritura |
Actualizar perfil | Actualiza los atributos de un perfil de Klaviyo existente. | Escritura |
Obtener listas | Recupera todas las listas de la cuenta de Klaviyo. | Lectura |
Obtener lista | Recupera los detalles de una lista específica de Klaviyo. | Lectura |
Crear lista | Crea una nueva lista en la cuenta de Klaviyo. | Escritura |
Añadir perfiles a la lista | Añade perfiles a una lista de Klaviyo mediante IDs de perfil o direcciones de correo electrónico. | Escritura |
Obtener perfiles de la lista | Recupera todos los perfiles que son miembros de una lista específica de Klaviyo. | Lectura |
Obtener segmentos | Recupera todos los segmentos de la cuenta de Klaviyo. | Lectura |
Obtener segmento | Recupera los detalles de un segmento específico de Klaviyo. | Lectura |
Obtener perfiles del segmento | Recupera los perfiles que pertenecen a un segmento específico de Klaviyo. | Lectura |
Obtener campañas | Recupera una lista de campañas en la cuenta de Klaviyo. | Lectura |
Obtener campaña | Recupera los detalles de una campaña específica de Klaviyo. | Lectura |
Crear campaña | Crea una nueva campaña en Klaviyo para correo electrónico o SMS. | Escritura |
Asignar plantilla de mensaje de campaña | Crea una versión no reutilizable de una plantilla y la asigna a un mensaje de campaña. | Escritura |
Obtener flujos | Recupera todos los flujos configurados en la cuenta de Klaviyo. | Lectura |
Obtener flujo | Recupera los detalles de un flujo específico de Klaviyo. | Lectura |
Obtener acciones del flujo | Recupera las acciones dentro de un flujo específico de Klaviyo. | Lectura |
Obtener métricas | Recupera todas las métricas disponibles en la cuenta de Klaviyo. | Lectura |
Obtener métrica | Recupera los detalles de una métrica específica de Klaviyo. | Lectura |
Crear eventos de cliente en lote | Registra la actividad de perfiles creando varios eventos. | Escritura |
Obtener plantillas | Recupera todas las plantillas de correo electrónico de la cuenta de Klaviyo. | Lectura |
Obtener plantilla | Recupera una plantilla de correo electrónico específica. | Lectura |
Crear plantilla | Crea una nueva plantilla de correo electrónico en la cuenta de Klaviyo. | Escritura |
Eliminar lista | Elimina permanentemente una lista de Klaviyo. | ⚠️ Destructiva |
Eliminar campaña | Elimina permanentemente una campaña de Klaviyo. | ⚠️ Destructiva |
Eliminar plantilla | Elimina permanentemente una plantilla de correo electrónico de Klaviyo. | ⚠️ Destructiva |
Casos de uso
Revisar y actualizar perfiles bajo demanda. Recupera perfiles específicos por correo electrónico o ID, comprueba sus atributos y membresías de lista, y actualiza sus datos desde Goodweek.
Comprobar la pertenencia a listas y segmentos. Recupera los perfiles de una lista o segmento específico desde Goodweek para verificar la composición de la audiencia antes de lanzar una campaña.
Revisar el estado de campañas y flujos. Obtén los detalles de una campaña o comprueba qué flujos están activos en tu cuenta desde una conversación de Goodweek.
Rastrear eventos y supervisar métricas. Accede a las métricas de Klaviyo para revisar qué eventos se están rastreando y usa esos datos para orientar decisiones de segmentación o campañas.
Solución de problemas
No puedo generar una clave de API en Klaviyo
Solo los usuarios de Klaviyo con roles de Propietario, Administrador o Gestor pueden crear claves de API privadas. Si no tienes uno de estos roles, pide a un propietario o administrador que genere una clave en tu nombre.
La integración deja de funcionar después de conectarse
Es posible que la clave de API se haya eliminado o revocado en Klaviyo. Ve a Klaviyo → Configuración → Cuenta → Claves de API y verifica que la clave siga activa. Si no es así, genera una nueva y vuelve a conectarte en Goodweek.
La integración no aparece en Goodweek
Asegúrate de que el administrador de tu organización haya habilitado la integración de Klaviyo desde el Panel de administración de Goodweek, en la pestaña Integraciones.