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

MyReportify para HubSpot

MyReportify escribe el informe mensual de marketing que las agencias envían a sus clientes. La integración con HubSpot añade al informe mensual del cliente un apartado del CRM: cuántos contactos y negocios se crearon el mes pasado, cuántos negocios se ganaron y su importe total, 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 HubSpot 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 HubSpot

  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 HubSpot.
  4. Pulsa Conectar con HubSpot.
  5. Inicia sesión en HubSpot, 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 HubSpot, 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 HubSpot 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 HubSpot salen en su propio apartado, en la página del informe y en el PDF.

4. Qué lee MyReportify

  • El ID de la cuenta, su zona horaria y su moneda (información de la cuenta).
  • El número de contactos creados en el mes (búsqueda del CRM, solo el total).
  • El número de negocios creados en el mes (búsqueda del CRM, solo el total).
  • De los negocios ganados en el mes: solo su importe, para sumar el total.

Permisos que se piden

  • oauth: Obligatorio en HubSpot para las apps con OAuth.
  • crm.objects.contacts.read: Contar los contactos creados en el mes.
  • crm.objects.deals.read: Contar los negocios creados y ganados en el mes y sumar el importe ganado.

MyReportify nunca lee propiedades de los contactos, nombres de negocios ni ningún dato personal, y nunca crea, cambia ni borra nada en HubSpot. 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://api.hubapi.com/oauth/v1/tokenCambiar el código de autorización y renovar el acceso (30 min).—
DELETE /oauth/v1/refresh-tokens/{token}Revocar el acceso al pulsar Quitar.—
GET /account-info/v3/detailsID de la cuenta, zona horaria y moneda.oauth
POST /crm/v3/objects/contacts/searchContar los contactos creados en el mes (limit 1, solo el total).crm.objects.contacts.read
POST /crm/v3/objects/deals/searchContar los negocios creados en el mes y sumar el importe de los ganados.crm.objects.deals.read

6. Arquitectura y flujo de datos

Agencia (navegador)Servidor de MyReportifyHubSpotTokens 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; HubSpot 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 HubSpot, 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 HubSpot, pulsa Quitar. Los tokens se borran en el momento.
  • En HubSpot: Configuración → Integraciones → Aplicaciones conectadas → MyReportify → Desinstalar.
  • 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.