Inicio
EN · View in English

Proyecto de trabajo

Snapshots del CRM

Los módulos de Zoho CRM en PostgreSQL, listos para analizar

Un servicio que copia en bloque los módulos de Zoho CRM a PostgreSQL para analizarlos con SQL fuera del CRM, y deja registro de cada corrida.

Recreación de un cliente SQL sobre la base de snapshots, con una tabla por módulo del CRM, una consulta al registro de corridas y otra de oportunidades por etapa, con el último snapshot de cada módulo completado. (abrir la imagen en tamaño completo)
Recreación con datos ficticios, porque el sistema real es privado.

De qué se trata

Para analizar el CRM con SQL, el servicio exporta cada módulo con la Bulk Read API de Zoho y lo carga en PostgreSQL. Cada corrida vacía la tabla del módulo y la vuelve a llenar, así que la base tiene siempre la copia más reciente.

Empezó en 2025 como un script por módulo y en 2026 pasó a ser un servicio en FastAPI con autenticación y métricas.

Qué hace

  • Usa la Bulk Read API de Zoho para pedir la exportación de cada módulo, esperar el archivo ZIP, descomprimirlo y cargar el CSV en PostgreSQL.
  • Cubre los módulos que necesita el análisis de una institución, entre ellos leads, oportunidades, contactos, campañas, notas y usuarios.
  • Cada corrida queda en una tabla de registro con el módulo, la fecha, el cliente y su estado.
  • La versión actual es una API en FastAPI con autenticación por clave y métricas para Prometheus, desplegada en Docker.

Cómo funciona

Del CRM a PostgreSQL

Los datos van de Zoho al servicio y del servicio a PostgreSQL.

  1. Zoho CRM

    • Bulk Read API por módulo
    • Exportaciones en ZIP con CSV

  2. Servicio

    • API en FastAPI
    • Autenticación por clave
    • Métricas para Prometheus

  3. PostgreSQL

    • Tablas por módulo
    • Registro de cada corrida
    • Consultas y tableros

Decisiones y sus costos

  1. Exportaciones masivas en vez de consultas

    La API normal obliga a paginar un módulo registro por registro.

  2. Un registro por corrida

    Sin un registro, saber qué tan reciente es cada copia obliga a revisar los logs.

Stack

Elige una tecnología para ver qué proyectos la usan.

Relacionado

Certificaciones que se aplican aquí