Guía de instalación y prueba · Read in English

MyReportify para Klaviyo

MyReportify escribe el informe mensual de marketing que las agencias envían a sus clientes. La integración con Klaviyo añade al informe mensual del cliente un apartado de email: cuántas campañas salieron el mes pasado, cuántos correos se entregaron, aperturas y clics únicos, bajas, tasas de apertura y de clic, las mejores campañas y, si la cuenta registra pedidos, los ingresos que Klaviyo atribuye a las campañas, siempre comparado con el mes anterior.

1. Qué necesitas

  • Una cuenta de MyReportify. Se crea gratis en myreportify.com/auth/register, sin tarjeta.
  • Un cliente creado en MyReportify (Clientes → Nuevo cliente).
  • Una cuenta de Klaviyo en la que puedas iniciar sesión (la del cliente o una a la que te haya dado acceso). Si no tiene actividad, las cifras salen a cero.

2. Conectar Klaviyo

  1. Entra en MyReportify en myreportify.com/auth/login.
  2. Abre Clientes, entra en el cliente y pulsa Editar.
  3. Baja hasta Tienda, email y CRM y busca la tarjeta de Klaviyo.
  4. Pulsa Conectar con Klaviyo.
  5. Inicia sesión en Klaviyo, elige la cuenta si te lo pide y acepta los permisos de solo lectura.
  6. Vuelves a MyReportify. La tarjeta dice Conectado con inicio de sesión y el nombre de la cuenta.

3. Comprobar que funciona

  1. En la tarjeta de Klaviyo, pulsa Comprobar. MyReportify lee en ese momento el mes pasado y el anterior y enseña las cifras que usará el próximo informe.
  2. Compáralas con lo que enseña Klaviyo para el mismo mes: deberían coincidir (una cuenta sin actividad sale a cero).
  3. Al generar el informe del mes pasado (Generar informe en la ficha del cliente), las cifras de Klaviyo salen en su propio apartado, en la página del informe y en el PDF.

4. Qué lee MyReportify

  • El nombre, la moneda y la zona horaria de la cuenta (para cortar los meses en su propia hora).
  • Los totales del mes de las métricas propias de Klaviyo: Received Email, Opened Email, Clicked Email y Unsubscribed (agregados de métricas).
  • Las campañas enviadas en el mes (nombre y fecha) y, si la cuenta tiene la métrica Placed Order, el informe de valores de campaña.

Permisos que se piden

  • accounts:read: Nombre, moneda y zona horaria de la cuenta.
  • metrics:read: Totales del mes de las métricas de email de arriba.
  • campaigns:read: Campañas enviadas en el mes y sus resultados.

MyReportify nunca lee perfiles, listas ni ningún dato personal, y nunca crea, envía, cambia ni borra nada en Klaviyo. Solo se guardan los totales del mes, dentro del informe. Los tokens están solo en nuestro servidor y nunca llegan al navegador.

5. Endpoints de la API y permisos

EndpointPara quéPermiso
POST https://a.klaviyo.com/oauth/tokenCambiar el código de autorización (PKCE) y renovar el acceso.—
POST https://a.klaviyo.com/oauth/revokeRevocar el acceso al pulsar Quitar (desinstala la app).—
GET /api/accountsNombre, moneda y zona horaria de la cuenta.accounts:read
GET /api/metricsBuscar los ids de Received Email, Opened Email, Clicked Email, Unsubscribed y Placed Order.metrics:read
POST /api/metric-aggregatesTotales del mes (total y únicos) de esas métricas, en la zona horaria de la cuenta.metrics:read
GET /api/campaignsCampañas de email enviadas en el mes (nombre y fecha).campaigns:read
POST /api/campaign-values-reportsPor campaña: entregados, aperturas, clics e ingresos atribuidos (solo si existe Placed Order).campaigns:read

6. Arquitectura y flujo de datos

Agencia (navegador)Servidor de MyReportifyKlaviyoTokens cifradosInforme mensual (web + PDF)1. Conectar2. Aprobar (OAuth)4. Lee la API (HTTPS)3. Tokens (cifrados)5. Solo totales

La agencia empieza la conexión desde MyReportify; Klaviyo pide aprobar los permisos de solo lectura y devuelve un código a la ruta de vuelta de MyReportify. Nuestro servidor lo cambia por tokens, los cifra (AES-256-GCM) y los guarda en nuestra base de datos, a la que el navegador nunca llega. Cuando la agencia pulsa Comprobar o genera un informe, el servidor lee de la API de Klaviyo, por HTTPS, el mes pasado y el anterior, se queda solo con los totales del mes y los pone en el informe. El navegador solo ve los totales y el nombre de la cuenta. Alojamiento: Vercel (aplicación) y Supabase (base de datos PostgreSQL).

7. Desconectar

  • En MyReportify: en la tarjeta de Klaviyo, pulsa Quitar. Los tokens se borran en el momento.
  • En Klaviyo: Integrations → busca MyReportify → Uninstall (o Settings → Apps).
  • Las cifras que ya están en informes anteriores se quedan en esos informes. Para borrarlo todo, borra el cliente o la cuenta de MyReportify (Ajustes → Eliminar cuenta).

8. Ayuda

Escríbenos a hola@myreportify.com. Política de privacidad: myreportify.com/privacy. Términos: myreportify.com/terms.