---
name: saas-onboarding-flow
description: >
  Cria o fluxo completo de onboarding de SaaS com IA para ativar o usuário
  nos primeiros 7 dias e garantir retenção. Inclui onboarding por perfil
  (gestor/usuário final/admin), mapa D0-D30, onboarding de migração de outro
  sistema, configuração assistida, transferência de conta, e eventos de
  tracking do Momento Aha. Onboarding de SaaS é diferente de tutorial — é
  a sequência que leva o usuário ao seu primeiro "momento aha" antes que
  ele desista. Use quando disser "onboarding do SaaS", "primeiros 7 dias",
  "ativar usuário", "momento aha", "como fazer o usuário usar o produto",
  "reduzir churn dos primeiros dias", "onboarding para gestor",
  "migração de outro sistema". Integra com /saas-checkout-blueprint,
  /churn-prevention, /health-score, /saas-success-metrics.
---

# SaaS Onboarding Flow

> "O maior churn de SaaS acontece nos primeiros 7 dias — não quando o usuário decide cancelar, mas quando ele nunca chegou ao momento aha."


## FASE 0 — Leitura do Contexto do Projeto (OBRIGATÓRIO)

> **ANTES DE QUALQUER OUTRA AÇÃO:** leia o arquivo `SAAS-CONTEXT.md` da pasta do projeto.

Se o arquivo existe:
- Leia NOME, SETOR, REGULAÇÃO, DECISOR, USUÁRIO FINAL, CANAL, TICKET, MODELO, VOC e CONCORRENTES
- Use esses dados como fonte de verdade em todas as seções desta skill
- Não faça perguntas que já estão respondidas no SAAS-CONTEXT.md

Se o arquivo **não existe**:
- Pare aqui
- Informe: "Nenhum SAAS-CONTEXT.md encontrado. Rode `/saas-context-doc` primeiro para criar o briefing do projeto. Isso garante que esta skill use dados reais do seu SaaS, não exemplos genéricos."
- Não prossiga até o arquivo ser criado

Por que é obrigatório: esta skill usa nome do SaaS, VOC do cliente, regulação do setor e perfil do decisor para gerar output que você pode usar diretamente — sem edição. Sem o contexto, o output fica com placeholders e linguagem de produto, não de cliente.

---

## FASE 0.5 — Leitura de Outputs Anteriores

Se existirem, leia os arquivos `.saas/` para evitar repetir informações já definidas:

- `.saas/SAAS-S11-CHECKOUT.md` → estrutura de planos, trial (com/sem cartão), convite pós-compra aceito, perfil B2C vs B2B, método de pagamento — definem o caminho de onboarding
- `.saas/SAAS-S2-FEATURES.md` → feature MUST HAVE principal e gatilho de IA (define a ação do Momento Aha)

Campos que NÃO precisam ser perguntados se já constam nesses arquivos:
- Duração do trial e tipo (com/sem cartão) — já definido no S11
- Feature principal do produto — já mapeada no S2 (coluna MUST HAVE)
- Perfil B2C vs B2B — já determinado pelo checkout S11
- Lead com sistema atual (migração) — indicado no S11 (custo de sistema > R$0)

---

## Por que existe

80% do churn de SaaS acontece antes do usuário chegar ao valor real do produto. Onboarding não é um tutorial de como usar — é uma sequência deliberada para **garantir que o usuário sinta o valor do produto antes do trial acabar**. Esta skill cria essa sequência para múltiplos perfis de usuário.

---

## MODOS DE OPERAÇÃO

- **`/saas-onboarding-flow`** — fluxo completo: in-app + emails + notificações + perfis
- **`/saas-onboarding-flow momento-aha`** — foca só em identificar e acelerar o momento aha
- **`/saas-onboarding-flow emails`** — só a sequência de onboarding por email
- **`/saas-onboarding-flow reativacao`** — para usuários que pararam de usar nos primeiros 7 dias
- **`/saas-onboarding-flow migracao`** — onboarding para quem vem de outro sistema (com dados)
- **`/saas-onboarding-flow b2b`** — onboarding por perfil (gestor / usuário final / admin de TI)

---

## PRÉ-REQUISITO

Precisa de:
1. Feature MUST HAVE principal (do `/ai-feature-map`)
2. Gatilho mais impactante (do `/gatilho-preguica-canvas`)
3. Fluxo de checkout concluído (do `/saas-checkout-blueprint`)
4. ROI e payback em dias (do `/roi-calculator-builder`)

---

## CONCEITO CENTRAL: O MOMENTO AHA

O Momento Aha é o instante em que o usuário sente o valor real do produto pela primeira vez. Não é quando ele aprende a usar — é quando ele pensa "isso muda minha vida."

Para SaaS com IA, o Momento Aha é sempre o **primeiro gatilho de IA bem-sucedido**:
- Primeira vez que fala e o produto preenche automaticamente
- Primeira vez que a IA gera um resultado que ele usaria de verdade
- Primeiro relatório/análise que a IA produziu sem ele fazer nada

**Todo o onboarding tem um objetivo: levar o usuário ao Momento Aha o mais rápido possível.**

---

## EVENTO DE TRACKING DO MOMENTO AHA

Para medir a taxa de ativação (M1 do /saas-success-metrics), o Momento Aha precisa de um evento técnico mensurável:

```
COMO DEFINIR O EVENTO DE TRACKING:
NÃO é: "o usuário gostou do produto"
É: "o usuário [ação específica] pela primeira vez"

EXEMPLOS POR TIPO DE SaaS:
SaaS de clínica: "primeira_guia_preenchida_por_voz" (após submit do formulário)
SaaS de documentos: "primeiro_documento_gerado_pela_ia" (após geração completa)
SaaS de análise: "primeiro_relatorio_visualizado" (após abrir o primeiro relatório)
SaaS de agendamento: "primeiro_agendamento_confirmado" (após confirmação)

IMPLEMENTAÇÃO (Node.js):
// Quando o evento do Aha ocorre no backend:
await analytics.track({
  userId: user.id,
  event: 'momento_aha',
  properties: {
    time_since_signup_hours: (Date.now() - user.createdAt) / 3600000,
    plan: user.plan,
    perfil: user.perfil // gestor / usuario / admin
  }
});

PLATAFORMA RECOMENDADA: Posthog (gratuito até 1M eventos/mês) ou Mixpanel

ALERTAS DE ONBOARDING:
→ Mediana de time_since_signup_hours > 48h → caminho até o Aha está difícil
→ Taxa de momento_aha / cadastros < 30% → redesenhar o D0
```

---

## ONBOARDING POR PERFIL (B2B / MULTI-USUÁRIO)

Em B2B, quem compra ≠ quem usa ≠ quem aprova. Cada perfil tem objetivo diferente no primeiro contato:

```
COMO IDENTIFICAR O PERFIL NA CHEGADA:
Campo na tela de cadastro: "Qual é o seu papel?" [Gestor / Usuário / TI]
Armazenar no banco de dados — todos os emails e notificações seguem este perfil.

PERFIL 1 — GESTOR / DECISOR (quem comprou):
Objetivo no D0: confirmar que tomou a decisão certa
Quer ver: ROI esperado e progresso da equipe — não a tela de uso
D0 in-app: "Bem-vindo, [Nome]. Veja o impacto da sua equipe em tempo real."
D0 ação: "Convide sua equipe" (ele delega o uso)
D0 email: ROI esperado + próximos passos de implementação
D3 email: primeiros números da equipe (quantos usaram, o que foi feito)

PERFIL 2 — USUÁRIO FINAL (quem usa no dia a dia):
Objetivo no D0: fazer a primeira tarefa real mais rápido que faria sem o produto
Quer: resolver o problema de hoje — não configurar
D0 in-app: "[Nome], vamos fazer [tarefa X] juntos agora?"
D0 ação: Gatilho do Momento Aha diretamente (sem configuração antes)
Tour de 3 tooltips: aparece durante a primeira ação — não antes
D0 email: "Você fez [resultado] em [tempo] — aqui está o que mais você pode fazer"

PERFIL 3 — ADMIN DE TI / SEGURANÇA:
Objetivo no D0: validar que o produto é seguro e cumpre compliance
Quer: aprovar e integrar — não usar o produto em si
D0 in-app: Painel de administração (não o produto principal)
D0 informações: onde ficam os dados, criptografia, backups, SLA, LGPD, DPA
D0 email: "Bem-vindo ao [SaaS] — guia de setup técnico e segurança"
Integração SSO/SAML: guia técnico disponível no D0 (se suportado)
```

---

## O MAPA DE ATIVAÇÃO D0-D7

### DIA 0 — Boas-Vindas + Primeira Ação (dentro de 2 horas)

```
IN-APP (imediato após cadastro — baseado no perfil):
□ Tela de boas-vindas personalizada por perfil
□ 1 pergunta de personalização: "Como você [processo] hoje?" [2-3 opções]
□ CTA único: "[Ação do Momento Aha em 1 clique]"
□ Barra de progresso: "Configuração: 1 de 3 passos"

NÃO mostrar no D0:
❌ Tour completo do produto
❌ Vídeo de introdução longo (>2 min)
❌ Lista de todas as features
❌ Configurações avançadas
❌ Setup de integrações (deixar para D8+)

EMAIL D0 (imediato):
Assunto: "Seu acesso está pronto — 1 coisa pra fazer agora"
Corpo: "Faz só essa 1 coisa: [ação do Momento Aha com link direto]. Leva menos de 2 minutos."
CTA: "[Botão] → Fazer agora"
```

### DIA 1 — O Momento Aha

```
GATILHO IN-APP (após completar o Momento Aha):
□ Tela de celebração: "Você acabou de [resultado] em [tempo]"
□ Comparativo: "Isso teria levado [tempo antigo] manualmente"
□ Próxima ação: "Agora faça o segundo [item]"
□ Badge: "Primeiro [resultado] criado com IA ✓"

EMAIL D1 (se NÃO completou o Aha):
Assunto: "Uma coisa você ainda não fez — e deveria"
Corpo: [GIF ou screenshot do Gatilho Principal]
CTA: "[Ação do Aha] — leva 2 minutos"
```

### DIA 3 — Expansão

```
IN-APP (para quem completou o Aha):
□ Banner: "Você já usou [Feature 1]. Já conhece [Feature 2]?"
□ Walkthrough de 30s da Feature 2

EMAIL D3:
Mini case study (100 palavras) de persona com o mesmo perfil
Métricas reais: "[X horas economizadas em 3 dias de uso]"
```

### DIA 5 — Urgência

```
IN-APP (se trial):
□ Banner: "Seu trial acaba em 2 dias"
□ Resumo de uso + ROI calculado com dados reais do uso + payback em dias
□ CTA: "Continuar por R$ [preço]/mês"

EMAIL D5: resumo personalizado do uso + payback em dias + CTA de assinatura

USUÁRIOS INATIVOS (0 ações desde D0):
EMAIL DIFERENTE: "Você registrou mas nunca usou — por quê?"
Objetivo: reativar OU coletar feedback para melhorar o onboarding
```

### DIA 7 — Ativação ou Churned

```
IN-APP:
SE ativado (>3 ações): Lista do que fez + tempo economizado + CTA "Assinar e continuar"
SE inativo (<1 ação): "Última chance" + CTA "[Ação do Aha] grátis por mais 24h"

EMAIL D7 (ativo): "Você economizou [X horas] em 7 dias. Quer continuar?"
EMAIL D7 (inativo): "Sua conta fecha hoje — mas posso te ajudar antes?"
```

---

## MAPA D8-D30 (APÓS ATIVAÇÃO)

```
D8 — Integração Principal:
  "Você usa [ferramenta X]? O [SaaS] integra diretamente."
  Email: "Conecte [ferramenta X] em 2 minutos — economize ainda mais"

D14 — Segunda Feature Estratégica:
  Feature que mais retém clientes a longo prazo (não a mais chamativa)
  Tooltip in-app em contexto (não banner genérico)

D21 — Resultado Acumulado:
  Dashboard: "[X horas economizadas nas últimas 3 semanas]"
  Email: "Você está economizando mais do que a média"

D30 — NPS + Expansão:
  NPS in-app: "De 0 a 10, o quanto você recomendaria o [SaaS]?"
  NPS ≥ 9: convite para indicar um amigo com benefício
  NPS 7-8: "O que tornaria sua experiência 10?" [campo de texto]
  NPS ≤ 6: call de produto em 48h (não email automatizado)
```

---

## ONBOARDING DE MIGRAÇÃO (vem de outro sistema)

Quando o lead no checkout indicou custo de sistema atual > R$0:

```
DIFERENÇAS DO ONBOARDING PADRÃO:
O usuário de migração tem medo de perder dados e hábitos formados.

ONBOARDING DE MIGRAÇÃO — D0:
□ Tela especial: "Vindo do [sistema anterior]? Vamos trazer seus dados primeiro."
□ 3 opções de migração antes de qualquer outra configuração:
  1. Auto-migração: "Importe seu CSV — leva 2 minutos"
  2. Migração assistida: "Nossa equipe faz por você — agende aqui"
  3. Começo paralelo: "Use os dois por [N] dias"

EMAIL D0 (migração):
Assunto: "Seus dados do [sistema anterior] — veja como trazer"
Tutorial passo a passo com GIF
Destaque: "Você não perde nada. O histórico vem junto."

CONFIGURAÇÃO ASSISTIDA (plano Enterprise ou resistência alta):
Call de 45 min: profissional compartilha tela e configura junto com o cliente
Migração realizada durante a call
Treinamento dos primeiros casos de uso no próprio ambiente do cliente
SLA: disponível em até [N] dias úteis após a compra

TRANSFERÊNCIA DE CONTA (admin que sai da empresa):
1. Admin atual → "Configurações" → "Transferir propriedade" → email do novo responsável
2. Novo responsável recebe convite com permissões do antigo
3. Após aceitar, antigo perde acesso de dono
Por que implementar antes de precisar: conta órfã = churn garantido
```

---

## SEQUÊNCIA COMPLETA DE EMAILS

```
D0 (imediato): Boas-vindas por perfil + 1 ação
D0+2h (se não abriu): Lembrete do D0
D1 (se não fez Aha): Nudge para o Momento Aha
D3: Case study + segunda feature
D5: Urgência (trial) OU valor percebido (sem trial)
D7: Ativação OU reativação de última chance
D8: Integração principal
D14: Segunda feature estratégica
D21: Resultado acumulado + novidade
D30: NPS + convite de indicação (ou call de resgate se NPS baixo)
```

---

## GATILHOS DE INTERVENÇÃO

```
Cadastro sem retorno em 48h → Email + retorno com link direto ao Momento Aha
Aha completo mas sem uso posterior → "Como ir além do primeiro [resultado]"
Uso intenso mas sem assinatura ao final do trial → Extensão: "+7 dias por feedback de 3 min"
Assinante sem uso por 7 dias → Check-in: "Está tudo bem?"
Perfil gestor: equipe não ativou → Email para o gestor com link para configuração assistida
```

---

## Anti-Erros

- **Nunca comece com configuração** — configuração é o maior killer de ativação
- **Nunca mostre todas as features no D0** — uma feature, um valor, uma ação
- **Momento Aha não pode depender de dados que ainda não existem** — usar dados de exemplo
- **Nunca envie email diário genérico** — cada email tem 1 CTA específico ligado ao estágio
- **Nunca ignore o perfil** — gestor e usuário final recebem emails diferentes
- **Onboarding de migração sem dados = frustração** — oferecer migração antes do tour
- **Transferência de conta** não é opcional — implementar antes da primeira conta ativa sair

## Integrações

- `/saas-checkout-blueprint` — o onboarding começa onde o checkout termina
- `/roi-calculator-builder` — ROI e payback alimentam os emails D5 e D7
- `/churn-prevention` — usuários que não ativam no D7 entram no fluxo de prevenção
- `/health-score` — ativação no D7 é o primeiro score de saúde do usuário
- `/saas-success-metrics` — taxa de Momento Aha é a M1 (Taxa de Ativação)
- `/copy-conversacional-dm` — emails de reativação podem virar fluxo de WhatsApp

---

## SALVAR OUTPUT

Ao finalizar, salve o resultado em `.saas/SAAS-S13-ONBOARDING.md`:

```markdown
# SAAS-S13 — SaaS Onboarding Flow

## Momento Aha
- Definição: [ação específica que define o Aha]
- Evento de tracking: [nome do evento + plataforma]
- Tempo alvo D0→Aha: [horas]

## Onboarding por Perfil
- Gestor: [D0 ação + D0 email]
- Usuário Final: [D0 ação + D0 email]
- Admin TI: [D0 ação + D0 email]

## Mapa D0–D30
[sequência de emails e ações in-app]

## Critério de Ativação no D7
[>N ações = ativado]

## Gatilhos de Intervenção
[lista de triggers automáticos]

## Onboarding de Migração
[sim/não — fluxo se ativo]
```

---

## OUTPUT PARA PRÓXIMA SKILL

**Próxima skill recomendada:** `/saas-success-metrics`

**Passe como input:**
- Definição do Momento Aha: [ação específica + evento de tracking configurado]
- Perfis de usuário mapeados: [gestor / usuário / admin — com comportamentos esperados]
- D0 ação crítica: [o que o usuário deve fazer no D0 — vira M1 (Taxa de Ativação)]
- D7 critério de ativação: [>N ações = ativado — vira threshold do health score]
- Gatilhos de intervenção definidos: [copiar — viram alertas no dashboard de métricas]
