Guía de instalación y prueba · Read in English
MyReportify para Mailchimp
MyReportify escribe el informe mensual de marketing que las agencias envían a sus clientes. La integración con Mailchimp añade al informe mensual del cliente un apartado de email: campañas enviadas el mes pasado, correos entregados, aperturas y clics únicos, bajas, tasas de apertura y de clic, las mejores campañas y el número de suscriptores, 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 Mailchimp 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 Mailchimp
- Entra en MyReportify en myreportify.com/auth/login.
- Abre Clientes, entra en el cliente y pulsa Editar.
- Baja hasta Tienda, email y CRM y busca la tarjeta de Mailchimp.
- Pulsa Conectar con Mailchimp.
- Inicia sesión en Mailchimp, elige la cuenta si te lo pide y acepta los permisos de solo lectura.
- Vuelves a MyReportify. La tarjeta dice Conectado con inicio de sesión y el nombre de la cuenta.
3. Comprobar que funciona
- En la tarjeta de Mailchimp, pulsa Comprobar. MyReportify lee en ese momento el mes pasado y el anterior y enseña las cifras que usará el próximo informe.
- Compáralas con lo que enseña Mailchimp para el mismo mes: deberían coincidir (una cuenta sin actividad sale a cero).
- Al generar el informe del mes pasado (Generar informe en la ficha del cliente), las cifras de Mailchimp salen en su propio apartado, en la página del informe y en el PDF.
4. Qué lee MyReportify
- El nombre y la zona horaria de la cuenta.
- Los informes de las campañas enviadas en el mes y en el anterior.
- El número total de suscriptores de las audiencias de la cuenta (una cifra, no los contactos).
Permisos que se piden
OAuth: Mailchimp no tiene permisos por partes; MyReportify solo llama a las lecturas de arriba.
MyReportify nunca lee contactos ni direcciones de email, y nunca envía, crea, cambia ni borra nada en Mailchimp. 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
| Endpoint | Para qué | Permiso |
|---|---|---|
POST https://login.mailchimp.com/oauth2/token | Cambiar el código de autorización (el acceso no caduca). | — |
GET https://login.mailchimp.com/oauth2/metadata | El centro de datos de la cuenta (p. ej. us21), para el host de la API. | — |
GET /3.0/ | Nombre y zona horaria de la cuenta. | — |
GET /3.0/reports | Informes de las campañas enviadas en el mes y en el anterior. | — |
GET /3.0/lists | Número de suscriptores de las audiencias (solo totales). | — |
6. Arquitectura y flujo de datos
La agencia empieza la conexión desde MyReportify; Mailchimp 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 Mailchimp, 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 Mailchimp, pulsa Quitar. Los tokens se borran en el momento.
- En Mailchimp: Perfil → Extras → Connected apps (o Registered apps) → MyReportify → Revoke.
- 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.