FysolPulse CRM

O que é o FysolPulse

Serviço de monitoramento remoto de sistemas fotovoltaicos via WhatsApp. O cliente instala o sistema solar, se cadastra, e passa a receber alertas automáticos, resumos semanais e relatório mensal — tudo pelo WhatsApp, sem precisar abrir nenhum app.

Por que existe

Depois de instalar um sistema solar, o cliente perde o acompanhamento. Inversores param, strings falham, geração cai — e ninguém avisa. O FysolPulse monitora 24h e avisa antes do cliente perceber sozinho, com linguagem simples e sem jargão técnico.

Planos e preços — Plano Básico

Sistema	Mensal	Anual (2 meses grátis)
Até 5 kWp	R$ 14,90	R$ 149,00
Até 10 kWp	R$ 19,90	R$ 199,00
Até 15 kWp	R$ 29,90	R$ 299,00
Até 25 kWp	R$ 44,90	R$ 449,00
Até 50 kWp	R$ 74,90	R$ 749,00
Até 75 kWp	R$ 99,90	R$ 999,00
Até 100 kWp	R$ 139,90	R$ 1.399,00

Plano anual = 10 mensalidades (2 meses grátis). Preços do Plano Básico — ver pricing-spec.html para Avançado e Pro. Planos Avançado e Pro disponíveis apenas em Brasília/DF e Unaí/MG.

Jornada completa do cliente

1

Lead
Renan envia link da LP ou cliente chega orgânico

→

2

Cadastro (LP)
Cliente preenche: nome, WhatsApp, kWp, marca, cidade, concessionária

→

3

Validação manual
Renan recebe Telegram com candidato no SolarView e roda /vincular

→

4

Trial D0–D7
7 dias grátis com alertas reais. D3 = check-in. D5 = mensagem de valor. D7 = CTA + PDF

→

5

Assinante
Resumo semanal toda segunda. Relatório PDF todo mês. Alertas 24h

Fluxo quando cliente não tem cadastro no portal (no-match)

Se o sistema do cliente não está na base do SolarView automaticamente, o bot WhatsApp inicia um fluxo de coleta:

Bot pergunta: "Tem login e senha no portal [Marca]? SIM ou NÃO"
Se SIM: coleta e-mail e senha → tenta ativar trial automaticamente → credenciais descartadas imediatamente (nunca salvas)
Se NÃO: pede número de série do inversor (etiqueta no aparelho) → Renan recebe alerta no Telegram e faz o cadastro manual
Microinversores (APsystems, Hoymiles, Enphase): pede SN do gateway ECU/DTU, não do inversor individual

O que o cliente recebe

Alertas em tempo real: sistema offline, baixa geração (ajustado pelo clima — chuva não dispara alerta falso), queda de string
Alerta de clima inteligente: dia de chuva/nuvem → mensagem tranquilizadora ao invés de silêncio
Resumo semanal (apenas assinantes): todo sábado, resumo da semana com kWh gerado e economia estimada
Relatório mensal em PDF: geração, performance, comparativo, insights — últimas páginas com upsell para plano Pro (blur) durante trial
D3 de trial: check-in automático, pergunta se está tudo ok
D5 de trial: mensagem de valor mostrando o que o monitoramento já detectou
D7 de trial: CTA com preço e link de assinatura → depois envia PDF

Escalação quando fica offline

T+0: WhatsApp ao cliente — "seu sistema ficou offline, pode checar a energia da casa?"
T+12h: segundo WhatsApp se persistir
T+24h: SMS (Zenvia) — canal alternativo
T+72h: WhatsApp "estamos tentando contato"
T+96h: Telegram para Renan — cliente não responde, ação manual necessária
T+7 dias: protocolo FysolAti (visita técnica)

Dashboard de métricas (topo)

MRR: soma dos preços mensais de todos os assinantes ativos
Trials: total de clientes com trial_ativo agora
Expir. 48h: trials que encerram nas próximas 48h — ação imediata de conversão
Saúde crítica: clientes com health score abaixo de 50 — lista de ação do dia
Assinantes: total de clientes pagantes
kWp ⚠: clientes ativos cujo kWp estimado pela geração real diverge do plano declarado (±20%). Atualizado mensalmente pelo relatório.
Sem concess.: clientes trial/assinante sem concessionária vinculada — bloqueio para relatório financeiro completo.

Badges de alerta nos cards

Cada card pode exibir badges de atenção abaixo das informações do sistema:

Badge	Significado	Ação
⚠ kWp	kWp estimado pela geração diverge do plano contratado em mais de 20%	Abrir cliente, revisar campo kWp e faixa de plano. Atualizar se necessário.
⏰ 2d	Trial expira em menos de 48h	Enviar mensagem manual de conversão se o D7 automático não chegou.
💳 inadim.	1 ou mais cobranças consecutivas com falha no Asaas	Ligar (não WhatsApp). Pedir para atualizar cartão no Asaas.
🔒 concess.	Sem concessionária vinculada (trial ou assinante)	Perguntar ao cliente qual é a distribuidora. Sem isso, o relatório financeiro fica incompleto.

Pipeline Kanban — 7 colunas

Coluna	Status	O que significa
Link Enviado	`link_enviado`	Renan enviou o link da LP mas cliente ainda não preencheu o form
Aguarda Validação	`pending_validation pending_match`	Form preenchido, aguardando Renan rodar /vincular no Telegram. pending_match = match automático encontrado, pronto para vincular
Em Setup	`pending_manual_setup pending_credentials pending_sn pending_unbind`	Sem match automático — bot está coletando dados do cliente. pending_unbind = SN em outra conta, aguarda suporte da marca (processo lento)
Trial Ativo	`trial_ativo`	7 dias de trial rodando. Cada card mostra dias restantes
Assinante	`assinante_ativo`	Cliente pagante. Recebe resumo semanal e relatório mensal
Expirado	`expirado`	Trial encerrou sem conversão
Cancelado	`cancelado`	Assinante que cancelou. Preencher motivo_cancelamento sempre

Health Score (0–100)

Calculado automaticamente em cada card:

Cor	Faixa	O que fazer
85	80–100	Saudável. Nenhuma ação necessária
65	50–79	Monitorar. Checar em 3 dias
35	0–49	Ação hoje. Mensagem manual, ligar se necessário

O score considera: estado do sistema (35%), engajamento WhatsApp (25%), situação financeira (20%), tempo no produto (10%) e atividade recente (10%). Se houver 2+ cobranças falhas consecutivas, o cliente vai direto para vermelho independente do score.

Editar um cliente

Clique em qualquer card para abrir o modal de edição. Seções disponíveis:

Cliente: nome, e-mail, cidade, estado
Sistema solar: kWp, marca do inversor, concessionária
Trial/Assinatura: unit_id SolarView, status, datas, plano, preços
Visitas & Limpezas: data programada e realizada para visita técnica e limpeza dos painéis (obrigatório para planos Avançado e Pro)
CS: tag (VIP/Risco/Dormindo), cobranças falhas, motivo de cancelamento
Notas internas: texto livre, nunca enviado ao cliente

WhatsApp não é editável — é a chave única do registro. Para alterar número, entre em contato.

Validação automática de kWp (mensal)

Todo dia 15 de cada mês, junto com o relatório mensal, o sistema roda validar_kwp_plano.py que:

Pega os últimos 90 dias de geração de cada cliente ativo
Calcula o kWp real estimado: média dos 10% melhores dias ÷ (HSP do estado × 0,80)
Compara com a faixa declarada no plano. Se divergir mais de 20%, marca kwp_alerta: true e aparece o badge ⚠ kWp no card
Envia alerta consolidado no Telegram se houver divergências

Se o kWp estimado for maior que o plano: cliente paga menos do que deveria — conversar sobre upgrade de faixa. Se for menor: possível overcharge — verificar se o dado de kWp instalado está correto.

Controle de visitas e limpezas

Planos Avançado e Pro incluem visita técnica anual com ART. O CRM permite rastrear:

Visita programada: data agendada com o cliente
Visita realizada: data em que a visita aconteceu de fato
Limpeza programada: data prevista para limpeza dos painéis (recomendado: maio e setembro no Cerrado)
Limpeza realizada: data em que a limpeza foi feita

Preencher "realizada" ao concluir cada serviço. Manter "programada" para a próxima. Isso evita que o cliente fique sem atendimento e garante entrega do plano.

Registrar novo lead (+ Lead)

Use quando você enviou o link da LP para alguém e quer rastrear antes do preenchimento do form. Preencha nome e WhatsApp (obrigatórios). Quando esse cliente preencher o form, o registro será atualizado automaticamente em vez de criar duplicata.

Tags CS

VIP: cliente de alto valor ou influenciador — atenção especial
Risco: sinais de churn — saúde baixa, sem resposta há dias
Dormindo: assinante que não interage há mais de 21 dias

O que roda automaticamente (sem precisar de nada)

Workflow	Frequência	O que faz
`monitor.yml`	A cada 30 min (7h–21h)	Verifica geração de todos os clientes. Envia alertas de offline e baixa geração. Considera clima (chuva = mensagem tranquilizadora, não alerta)
`expirar-trials.yml`	Diário 8h BRT	Verifica trials próximos do vencimento. D7 = notifica Renan que enviar_pdf_trial vai agir
`enviar-pdf-trial.yml`	Diário 8h BRT	No D7: envia mensagem CTA com preço e link de assinatura → depois envia PDF do relatório
`midtrial.yml`	Diário	No D3 do trial: check-in automático com dado real de geração
`resumo-semanal.yml`	Todo sábado 8h BRT	Somente assinantes: resumo da semana com kWh e economia. Semana normal = mensagem curta positiva
`relatorio-mensal.yml`	Todo dia 15	Gera e envia PDF com relatório mensal. Trial = páginas finais com blur (upsell)
`alerta-limpeza.yml`	Maio e set	Alerta seasonal de limpeza dos painéis (Cerrado: estação seca)
`alerta-scee.yml`	Verificação mensal	Alerta quando créditos SCEE estão próximos do vencimento
`growatt-monitor.yml`	A cada hora	Coleta dados de 152 plantas Growatt via OSS API
`isolarcloud-monitor.yml`	A cada hora	Coleta dados de 70 plantas Sungrow via iSolarCloud API
`bot-responder.yml`	Sob demanda (webhook)	Responde mensagens WhatsApp recebidas. N1 (FAQ) → N2 (IA contextual) → N3 (Renan)
`vincular-unit.yml`	Manual (/vincular)	Vincula cliente ao unit_id SolarView. Ativa trial e envia D0

Fluxo de alertas inteligentes

Sistema offline: verifica se é apagão local (múltiplos sistemas na mesma cidade offline) → se sim, mensagem diferente. Se não, escalação progressiva T+0/12h/24h/72h/96h
Baixa geração: compara com média histórica. Threshold 70%. Só dispara se persistir por 3h (evita falso positivo de nuvem passageira)
Clima: consulta API de clima antes de disparar alerta. CLEAR = alerta normal. CLOUDY/RAIN = mensagem tranquilizadora ("dia nublado, sistema ok")
Evento regional: se múltiplos sistemas na mesma cidade ficam offline ao mesmo tempo, Renan recebe alerta consolidado no Telegram (pode ser problema de rede elétrica da região)

Bot WhatsApp — camadas de resposta

N1: respostas automáticas por padrão de texto (FAQ, perguntas comuns sobre o sistema, geração, conta de luz). Zero custo.
N2: Groq Llama 3.3 70B — IA com contexto completo do cliente (dados SV em tempo real, histórico de alertas, estado do sistema). Gratuito. Sem RAG — knowledge base de inversores está embutida no system prompt.
N3: Claude Haiku — último recurso de IA (~R$0,02/chamada). Responde o que N2 não conseguiu. Se N3 decidir escalar, notifica Renan no Telegram silenciosamente — o cliente nunca sabe e recebe uma mensagem de espera.
Coleta (no-match): fluxo especial para clientes sem unit_id — coleta credenciais ou SN do inversor

Rotina da manhã (5–10 min)

Abrir o CRM e checar o dashboard topo
Saúde crítica > 0? Abrir cada card vermelho, ler notas, mandar mensagem manual ou ligar
Expirando 48h > 0? Esses trials encerram amanhã. Se não recebeu o CTA ainda (workflow falhou), enviar manualmente
kWp ⚠ > 0? Clientes com faixa divergente — revisar kWp do card e propor upgrade/ajuste de plano
Sem concess. > 0? Perguntar ao cliente qual é a distribuidora — sem isso o relatório financeiro fica incompleto
Checar coluna "Aguarda Validação" — há clientes esperando /vincular? Rodar no Telegram
Checar coluna "Em Setup" — algum cliente parado há mais de 3 dias sem resposta? Enviar mensagem manual
Cards com 💳 inadim.? Ligar (não WhatsApp) para regularizar cartão

Como converter trial → assinante

O D7 envia automaticamente CTA com link e PDF
Se cliente responder positivo, o pagamento é feito via Asaas (link enviado no D7)
Quando Asaas confirmar pagamento, webhook dispara e atualiza status para assinante
Se precisar confirmar manualmente: editar o card → mudar status para assinante → preencher data_assinatura e plano_escolhido

O que fazer quando Health Score está vermelho

ultima_interacao_wa muito antiga: cliente parou de responder. Mandar mensagem direta, pergunta aberta
cobrancas_falhas_consecutivas ≥ 2: problema no cartão. Ligar, não mandar WhatsApp
Trial expirando sem engajamento: oferta de desconto no plano anual (primeiro mês)
Sistema offline: a automação já mandou alertas. Se o score ainda está baixo, cliente pode estar ignorando. Ligar

Quando usar o CRM vs Telegram

Ação	Onde fazer
Vincular unit_id a cliente	Telegram: `/vincular 5561999 123456`
Registrar lead recebido	Telegram: `/lead 5561999 Nome` ou botão + Lead no CRM
Ver status da sessão SolarView	Telegram: `/solarview`
Corrigir dados do cliente	CRM: clicar no card → editar
Mudar status manualmente	CRM: clicar no card → campo Status
Adicionar nota interna	CRM: campo Notas internas no modal
Ver pipeline completo	CRM: Kanban

SolarView — sessão expira

O SolarView usa cookies de sessão do browser, que expiram a cada 24–48 horas. Quando expiram, todos os monitoramentos param de funcionar silenciosamente. Para renovar:

Abrir my.solarview.com.br e fazer login
Abrir DevTools (F12) → aba Application → Cookies → my.solarview.com.br
Copiar os valores de: ci_session, ckTk, ckTkU, cf_clearance
Mandar no Telegram exatamente assim:
SVCOOKIES: ci_session=XXX; ckTk=YYY; ckTkU=ZZZ; cf_clearance=AAA

O bot confirma se os cookies são válidos. Se dizer "sessão ativa" = monitoramento voltou. O Keeper testa a sessão toda hora e avisa no Telegram quando ela expira.

Comandos disponíveis no @hubsolar_bot

Comando	O que faz
`/solarview`	Status da sessão SolarView (ativa/expirada + data dos cookies)
`/vincular 5561999887766 732374`	Vincula o WhatsApp do cliente ao unit_id no SolarView. Ativa trial automaticamente e envia mensagem D0
`/lead 5561999887766 João Silva`	Registra lead como "link_enviado" no clientes.json. Quando o cliente preencher o form, o registro é atualizado automaticamente
`SVCOOKIES: ci_session=...; ckTk=...; ckTkU=...; cf_clearance=...`	Renova cookies de sessão do SolarView. O bot confirma se a sessão ficou ativa

Alertas que chegam no Telegram (automáticos)

Sessão SolarView expirada → avisa na hora e todo hora até renovar
Novo cadastro via LP → candidato de match + comando /vincular pré-preenchido
Sistema offline por +4h sem retorno do cliente → escalação chegando
SN de inversor recebido pelo bot → ação manual necessária
Erro em qualquer workflow crítico → detalhes + link para o log do Actions
Evento regional (múltiplos sistemas offline mesma cidade) → alerta consolidado
Cobranças falhando no Asaas → nome do cliente + dias em falha

Dicas de uso

Sempre confirmar /vincular antes de avisar o cliente — o workflow leva ~1 minuto
/lead pode ser enviado pelo celular na hora que mandar o link para o cliente — zero atrito
Se o Telegram não responder ao /vincular, verificar no GitHub Actions se o workflow rodou