ooligo
claude-skill

Reporte semanal de pipeline desde HubSpot con Claude

Dificultad
intermedio
Tiempo de setup
30min
Para
revops
RevOps

Stack

Una skill de Claude que extrae cada deal abierto de HubSpot, lo segmenta por stage y owner, y escribe un reporte de pipeline para el lunes en la mañana que tu líder de ventas puede leer en tres minutos. La salida es markdown, la entrada es un token de la API de HubSpot, y el loop se puede automatizar entero.

Lo que vas a necesitar

  • HubSpot Sales Hub Pro o Enterprise con deals habilitado
  • Un token de Private App de HubSpot con scope crm.objects.deals.read y crm.objects.owners.read
  • Claude.ai o Claude Code con la Skill instalada
  • Un mapa de ownership (CSV o owner IDs de HubSpot) para que Claude sepa quién le reporta a quién

Setup

  1. Instala la Skill. Coloca weekly-pipeline.skill en tu proyecto de Claude. Expone fetch_open_pipeline, segment_by_owner y render_report.
  2. Agrega credenciales. Configura HUBSPOT_TOKEN en el entorno de la Skill. La Skill pagina la API de deals y respeta los rate limits, así que un pipeline de mil deals tarda alrededor de un minuto.
  3. Configura la segmentación. La Skill acepta un archivo YAML que describe la estructura de tu equipo: regiones, segmentos, mapeo de managers. Sin él, recibes un reporte plano por owner.
  4. Ajusta la forma del reporte. Secciones por defecto: pipeline por stage, movimiento semana contra semana, deals con más de treinta días en stage, top diez por monto, owners sin movimiento esta semana. Edita la plantilla del prompt para agregar o quitar secciones.
  5. Córrelo el lunes a las seis. Pipe a Slack #pipeline-review o email a la lista de distribución de liderazgo.

Cómo funciona

La Skill jala todos los deals abiertos, hace join con los registros de owner, y los acomoda por stage y segmento. Después Claude escribe la narrativa alrededor de los números: no solo “el pipeline en stage dos es de dos punto cuatro millones”, sino “stage dos subió dieciséis por ciento semana contra semana, impulsado completamente por el equipo de Mid-Market que sumó ocho oportunidades nuevas”.

La historia semana contra semana requiere un snapshot. La Skill escribe un CSV en tu store designado en cada corrida, así que de la segunda corrida en adelante hay datos de comparación. La primera corrida se lee como “todavía no hay datos históricos” y eso está bien.

Cuídate de

  • Deals zombies. La mitad de cualquier pipeline en HubSpot son deals muertos que nadie cerró-perdido. La sección “treinta días en stage” del reporte los marca agresivamente. Los líderes de ventas van a empujar de regreso. Mantén la línea.
  • Reasignaciones de owner. Los cambios de ownership a mitad de trimestre rompen las matemáticas de semana contra semana. La Skill puede seguir al deal o seguir al owner; elige un lado y documéntalo.
  • Moneda del monto del deal. El mismo gotcha que Salesforce. Usa hs_deal_amount_in_home_currency si trabajas con más de una.
  • Stages personalizados. Si tu equipo renombró los stages por defecto, actualiza el YAML. La Skill no infiere el orden de stage desde las etiquetas.

Stack

  • HubSpot — fuente de verdad del pipeline
  • Claude — generación de narrativa sobre los números
  • Config YAML — estructura de equipo y mapa de segmentación