Uma skill do Claude que puxa cada deal aberto do HubSpot, segmenta por stage e owner, e escreve um relatório de pipeline pra segunda de manhã que seu líder de vendas consegue ler em três minutos. A saída é markdown, a entrada é um token de API do HubSpot, e o loop é totalmente automatizável.

O que você vai precisar

HubSpot Sales Hub Pro ou Enterprise com deals habilitados
Um token de Private App do HubSpot com scope crm.objects.deals.read e crm.objects.owners.read
Claude.ai ou Claude Code com a Skill instalada
Um mapa de ownership (CSV ou owner IDs do HubSpot) pra que o Claude saiba quem reporta pra quem

Setup

Instale a Skill. Coloque weekly-pipeline.skill no seu projeto do Claude. Ela expõe fetch_open_pipeline, segment_by_owner e render_report.
Adicione credenciais. Configure HUBSPOT_TOKEN no ambiente da Skill. A Skill pagina a API de deals e respeita rate limits, então um pipeline de mil deals leva cerca de um minuto.
Configure a segmentação. A Skill aceita um arquivo YAML descrevendo a estrutura do seu time: regiões, segmentos, mapeamento de managers. Sem ele, você recebe um relatório plano por owner.
Ajuste o formato do relatório. Seções padrão: pipeline por stage, movimento semana contra semana, deals com mais de trinta dias em stage, top dez por valor, owners sem movimento essa semana. Edite o template do prompt pra adicionar ou remover seções.
Rode na segunda às seis. Pipe pro Slack #pipeline-review ou email pra lista de distribuição da liderança.

Como funciona

A Skill puxa todos os deals abertos, faz join com os registros de owner e organiza por stage e segmento. Aí o Claude escreve a narrativa em volta dos números: não só “pipeline em stage dois é dois vírgula quatro milhões”, mas “stage dois subiu dezesseis por cento semana contra semana, puxado inteiramente pelo time de Mid-Market que adicionou oito oportunidades novas”.

A história semana contra semana exige um snapshot. A Skill escreve um CSV no store designado a cada rodada, então da segunda rodada em diante tem dados de comparação. A primeira rodada lê como “ainda sem dados históricos” e tudo bem.

Pontos de atenção

Deals zumbis. Metade de qualquer pipeline do HubSpot são deals mortos que ninguém fechou-perdido. A seção “trinta dias em stage” do relatório marca isso de forma agressiva. Líderes de vendas vão empurrar de volta. Segure a linha.
Reatribuições de owner. Mudanças de ownership no meio do trimestre quebram a matemática semana contra semana. A Skill pode seguir o deal ou seguir o owner; escolha um lado e documente.
Moeda do valor do deal. Mesma pegadinha do Salesforce. Use hs_deal_amount_in_home_currency se você opera em mais de uma.
Stages customizados. Se seu time renomeou os stages padrão, atualize o YAML. A Skill não infere ordem de stage pelos rótulos.

Stack

HubSpot — fonte de verdade do pipeline
Claude — geração de narrativa em cima dos números
Config YAML — estrutura do time e mapa de segmentação