drm-core 1.0.0 → 1.2.0

package/scaffold/.drm-core/templates/msgs-whatsapp-template.md

@@ -0,0 +1,516 @@
+---
+# ============================================================
+# SEQUENCIA WHATSAPP — Template de Automacao de Mensagens
+# ============================================================
+# Template para sequencias de mensagens via WhatsApp.
+# Inclui: trigger, timing, tipo, variaveis, copy, regras de fluxo,
+# condicoes, e opt-out.
+# Compativel com: ManyChat, Botconversa, Wati, Z-API, Chatwoot.
+#
+tipo: msgs-whatsapp
+formato: sequencia-automacao-whatsapp
+agente_executor: "@dev | @copywriter"
+frameworks_aplicados:
+  - nome: "Conversation Commerce"
+    descricao: "Vendas via conversa — tom pessoal, direto, sem parecer robo"
+  - nome: "Follow-up Cascading"
+    descricao: "Sequencia progressiva: valor → prova → oferta → urgencia → ultimo aviso"
+  - nome: "Compliance LGPD + Meta Business"
+    descricao: "Regras de opt-in, opt-out, e frequencia"
+
+# --- CONTEXTO ---
+projeto:
+  nome: ""                    # [OBRIGATORIO] Nome do produto/oferta
+  tipo_funil: ""              # [OBRIGATORIO] "venda_direta | lancamento | webinar | lead_nurturing | pos_venda | carrinho_abandonado"
+  url_checkout: ""            # [OBRIGATORIO] URL do checkout/LP
+  url_whatsapp_grupo: ""      # [OPCIONAL] Link do grupo/comunidade
+  plataforma_automacao: ""    # [OBRIGATORIO] "manychat | botconversa | wati | z-api | chatwoot | manual"
+
+# --- AVATAR ---
+avatar:
+  nome_ficticio: ""           # [OBRIGATORIO] Representacao do publico
+  tom_preferido: ""           # [OBRIGATORIO] "informal | semi-formal | formal"
+  horario_pico: ""            # [OBRIGATORIO] Ex: "09h-12h, 19h-21h"
+
+# --- VARIAVEIS DISPONIVEIS ---
+variaveis:
+  - nome: "{nome}"
+    descricao: "Primeiro nome do lead"
+    fonte: "captura/CRM"
+    exemplo: "Carlos"
+  - nome: "{produto}"
+    descricao: "Nome do produto mencionado"
+    fonte: "config"
+    exemplo: "Metodo Destravar"
+  - nome: "{link}"
+    descricao: "Link do checkout/LP"
+    fonte: "config"
+    exemplo: "https://checkout.com/metodo"
+  - nome: "{preco}"
+    descricao: "Preco do produto"
+    fonte: "config"
+    exemplo: "R$ 497"
+  - nome: "{bonus}"
+    descricao: "Nome do bonus ativo"
+    fonte: "config"
+    exemplo: "Guia de Receitas"
+  - nome: "{prazo}"
+    descricao: "Prazo da oferta"
+    fonte: "config"
+    exemplo: "sexta-feira, 23h59"
+  - nome: "{garantia}"
+    descricao: "Prazo da garantia"
+    fonte: "config"
+    exemplo: "30 dias"
+
+# --- REGRAS GERAIS ---
+regras:
+  max_msgs_dia: 3             # [OBRIGATORIO] Maximo de mensagens por dia por lead
+  intervalo_minimo: "2h"      # [OBRIGATORIO] Intervalo minimo entre mensagens
+  horario_envio: "08h-21h"    # [OBRIGATORIO] Janela de envio permitida
+  opt_out_respeitado: true    # [OBRIGATORIO] Sempre true
+  lgpd_compliant: true        # [OBRIGATORIO] Sempre true
+
+# --- VERSAO ---
+versao: "1.0"
+data_criacao: ""
+autor: ""
+status: "rascunho"
+---
+
+# SEQUENCIA WHATSAPP — {{projeto.nome}}
+
+> **Tipo de funil:** {{projeto.tipo_funil}}
+> **Plataforma:** {{projeto.plataforma_automacao}}
+> **Horario de envio:** {{regras.horario_envio}}
+> **Max msgs/dia:** {{regras.max_msgs_dia}}
+
+---
+
+## TRIGGER (Evento de Disparo)
+
+> **O que e:** O evento que inicia a sequencia. Sem trigger, nenhuma mensagem e enviada.
+
+```
+TRIGGER PRINCIPAL:
+Evento: [Qual acao dispara a sequencia]
+Opcoes comuns:
+- [ ] Lead capturado (formulario LP)
+- [ ] Lead capturado (Meta Lead Ads)
+- [ ] Clicou no link do anuncio
+- [ ] Entrou no grupo WhatsApp
+- [ ] Assistiu X% do video
+- [ ] Adicionou ao carrinho mas nao comprou
+- [ ] Participou do webinar
+- [ ] Comprou (pos-venda)
+- [ ] Respondeu enquete/quiz
+- [ ] Enviou mensagem proativa
+- [ ] Outro: [descreva]
+
+EVENTO SELECIONADO: [descreva o trigger]
+FONTE DO LEAD: [De onde vem. Ex: "Meta Ads → LP → Formulario"]
+DADOS CAPTURADOS: [Quais dados temos. Ex: "nome, email, telefone"]
+```
+
+---
+
+## FLUXO DE MENSAGENS
+
+> **Instrucoes:** Cada mensagem deve ter: numero, timing, tipo, condicao, copy, e acao esperada.
+
+### MSG 1 — Boas-vindas / Entrega
+
+```
+NUMERO: 1
+TIMING: Imediato (0-2 min apos trigger)
+TIPO: [texto | audio | video | imagem | documento | sticker]
+CONDICAO: [Sem condicao — enviada para todos]
+
+COPY:
+[Escreva a mensagem exata. Use variaveis entre chaves.
+
+Exemplo (texto):
+"Oi {nome}! 👋
+
+Tudo bem? Aqui e o [Seu Nome], do {produto}.
+
+Seu acesso ja esta liberado! Clica aqui pra comecar:
+👉 {link}
+
+Qualquer duvida, pode me chamar aqui mesmo.
+
+Bora! 🚀"
+
+Exemplo (audio):
+"[Script do audio — max 60 segundos]
+Oi {nome}! Aqui e o [nome], queria te dar pessoalmente as boas-vindas ao {produto}..."]
+
+ACAO ESPERADA: [O que queremos que o lead faca. Ex: "Clicar no link"]
+BOTOES (se aplicavel): [Ex: "Quero comecar | Tenho duvida"]
+```
+
+### MSG 2 — Valor / Conteudo
+
+```
+NUMERO: 2
+TIMING: [Ex: "4 horas apos MSG 1" | "Dia seguinte, 9h"]
+TIPO: [texto | audio | video | imagem]
+CONDICAO: [Ex: "Se NAO clicou no link da MSG 1" | "Para todos"]
+
+COPY:
+[Mensagem de valor. NAO venda ainda. Entregue algo util.
+
+Exemplo:
+"{nome}, antes de voce comecar o {produto}, queria te mandar uma dica rapida 
+que ja ajudou muita gente:
+
+[Dica de valor em 3-5 linhas]
+
+Isso ja e um pedaco do que voce vai aprender la dentro.
+
+Ja acessou? 👉 {link}"]
+
+ACAO ESPERADA: [Ex: "Clicar no link ou responder"]
+```
+
+### MSG 3 — Prova Social
+
+```
+NUMERO: 3
+TIMING: [Ex: "Dia 2, 10h"]
+TIPO: [texto + imagem | video_depoimento | audio]
+CONDICAO: [Ex: "Se NAO comprou ainda"]
+
+COPY:
+[Compartilhe resultado de outra pessoa.
+
+Exemplo:
+"{nome}, olha o resultado da [Nome do aluno]:
+
+[Imagem/screenshot do depoimento]
+
+Ela comecou do zero e em [prazo] ja [resultado].
+
+Voce tambem pode. Comeca aqui: 👉 {link}"]
+
+ACAO ESPERADA: [Ex: "Clicar no link"]
+MIDIA ANEXA: [Descricao da imagem/video]
+```
+
+### MSG 4 — Oferta / Preco
+
+```
+NUMERO: 4
+TIMING: [Ex: "Dia 2, 19h"]
+TIPO: [texto | audio]
+CONDICAO: [Ex: "Se NAO comprou E abriu MSG 3"]
+
+COPY:
+[Agora faca a oferta. Direto mas nao agressivo.
+
+Exemplo:
+"{nome}, eu sei que voce ta interessado(a) porque ta acompanhando tudo aqui.
+
+Entao deixa eu ser direto:
+
+O {produto} ta com condicao especial:
+💰 De R$ [valor_cheio] por apenas {preco}
+🎁 + {bonus} de presente
+🛡️ Garantia de {garantia}
+
+Esse preco so vale ate {prazo}.
+
+Garanta agora: 👉 {link}
+
+Posso te ajudar com alguma duvida?"]
+
+ACAO ESPERADA: [Ex: "Comprar ou responder com duvida"]
+```
+
+### MSG 5 — Objecao / FAQ
+
+```
+NUMERO: 5
+TIMING: [Ex: "Dia 3, 10h"]
+TIPO: [texto | audio]
+CONDICAO: [Ex: "Se NAO comprou"]
+
+COPY:
+[Antecipe a objecao mais comum.
+
+Exemplo:
+"{nome}, muita gente me pergunta: 'Mas e se nao funcionar pra mim?'
+
+A resposta e simples: voce tem {garantia} dias pra testar. 
+Se nao gostar, devolvo cada centavo. Sem perguntas.
+
+O unico risco que voce corre e continuar onde esta.
+
+{link}"]
+
+ACAO ESPERADA: [Ex: "Comprar"]
+```
+
+### MSG 6 — Urgencia
+
+```
+NUMERO: 6
+TIMING: [Ex: "Dia 3, 19h"]
+TIPO: [texto | audio]
+CONDICAO: [Ex: "Se NAO comprou E prazo < 24h"]
+
+COPY:
+[Urgencia real. Falta pouco para encerrar.
+
+Exemplo:
+"{nome}, so passando pra lembrar:
+
+⏰ O {produto} com {bonus} gratis fecha AMANHA as 23h59.
+
+Depois disso:
+❌ O preco volta pra R$ [valor_cheio]
+❌ O bonus {bonus} sai do ar
+
+Se voce ta pensando, esse e o momento.
+
+👉 {link}"]
+
+ACAO ESPERADA: [Ex: "Comprar"]
+```
+
+### MSG 7 — Ultimo Aviso
+
+```
+NUMERO: 7
+TIMING: [Ex: "Dia do fechamento, 20h"]
+TIPO: [texto | audio]
+CONDICAO: [Ex: "Se NAO comprou E ultima msg permitida"]
+
+COPY:
+[Ultimo contato. Tom de despedida, sem pressao excessiva.
+
+Exemplo:
+"{nome}, essa e minha ultima mensagem sobre o {produto}.
+
+As inscricoes fecham em poucas horas e eu nao queria que voce perdesse.
+
+Se for pra voce, ta aqui: 👉 {link}
+
+Se nao for o momento, tudo bem tambem. Desejo o melhor pra voce! 🙏"]
+
+ACAO ESPERADA: [Ex: "Comprar ou ignorar — respeitamos"]
+```
+
+### MSG POS-COMPRA (condicional)
+
+```
+NUMERO: PC-1
+TIMING: [Imediato apos compra confirmada]
+TIPO: [texto]
+CONDICAO: [Se COMPROU]
+
+COPY:
+[Boas-vindas pos-compra. Reforce a decisao.
+
+Exemplo:
+"🎉 {nome}, sua inscricao no {produto} foi confirmada!
+
+Seu acesso: {link_acesso}
+Suporte: {email_suporte}
+
+Parabens pela decisao! Voce esta no caminho certo.
+
+Qualquer coisa, estou aqui. 💪"]
+```
+
+---
+
+## REGRAS DE FLUXO (Condicoes)
+
+> **Instrucoes:** Defina o comportamento da sequencia com base nas acoes do lead.
+
+```
+CONDICOES DE FLUXO:
+
+SE respondeu com DUVIDA:
+→ [Pausar sequencia automatica]
+→ [Notificar atendente humano]
+→ [Retomar sequencia apos resposta, se nao comprou]
+
+SE clicou no link MAS nao comprou:
+→ [Enviar MSG de carrinho abandonado em [X] horas]
+→ [Incluir na MSG 4 oferta com urgencia]
+
+SE comprou:
+→ [PARAR toda a sequencia de venda]
+→ [Iniciar sequencia pos-compra (MSG PC-1)]
+→ [Remover do fluxo de follow-up]
+
+SE nao abriu nenhuma mensagem em 48h:
+→ [Enviar 1 audio personalizado como ultima tentativa]
+→ [Se nao responder, marcar como "frio" e parar]
+
+SE pediu pra PARAR (opt-out):
+→ [PARAR IMEDIATAMENTE toda comunicacao]
+→ [Registrar opt-out no CRM]
+→ [Enviar confirmacao: "Pronto, {nome}. Voce nao recebera mais mensagens. Obrigado!"]
+→ [NUNCA mais enviar sem novo opt-in explicito]
+
+SE respondeu com interesse mas nao comprou:
+→ [Direcionar para atendente humano]
+→ [Fornecer contexto: msgs abertas, links clicados, objecoes expressas]
+```
+
+---
+
+## OPT-OUT
+
+> **Regra LGPD + Meta Business:** O lead DEVE poder sair a qualquer momento. Inclua instrucao de opt-out em TODA mensagem apos a primeira.
+
+```
+TEXTO DE OPT-OUT (incluir em toda MSG apos MSG 1):
+[Escolha um formato discreto mas visivel]
+
+Opcao A (final da mensagem):
+"Se nao quiser mais receber mensagens, responda SAIR."
+
+Opcao B (rodape discreto):
+"_Responda SAIR para parar de receber mensagens_"
+
+Opcao C (botao, se plataforma suporta):
+Botao: "Nao quero mais receber"
+
+FORMATO ESCOLHIDO: [A | B | C]
+
+PALAVRAS-CHAVE DE OPT-OUT:
+[Lista de palavras que disparam o opt-out automatico]
+- "SAIR"
+- "PARAR"
+- "CANCELAR"
+- "NAO QUERO"
+- "ME REMOVE"
+- "UNSUBSCRIBE"
+
+CONFIRMACAO DE OPT-OUT:
+"Pronto, {nome}! Voce foi removido e nao recebera mais mensagens. 
+Se mudar de ideia, pode nos chamar a qualquer momento. Obrigado! 🙏"
+```
+
+---
+
+## MAPA VISUAL DO FLUXO
+
+```
+[Trigger]
+    │
+    ▼
+[MSG 1: Boas-vindas] ──(imediato)
+    │
+    ├── COMPROU? ──→ [MSG PC-1: Pos-compra] ──→ FIM
+    │
+    ▼
+[MSG 2: Valor] ──(4h depois)
+    │
+    ├── COMPROU? ──→ [MSG PC-1] ──→ FIM
+    │
+    ▼
+[MSG 3: Prova Social] ──(Dia 2, 10h)
+    │
+    ├── COMPROU? ──→ [MSG PC-1] ──→ FIM
+    │
+    ▼
+[MSG 4: Oferta] ──(Dia 2, 19h)
+    │
+    ├── COMPROU? ──→ [MSG PC-1] ──→ FIM
+    ├── DUVIDA? ──→ [Atendente humano] ──→ Retoma fluxo
+    │
+    ▼
+[MSG 5: Objecao] ──(Dia 3, 10h)
+    │
+    ├── COMPROU? ──→ [MSG PC-1] ──→ FIM
+    │
+    ▼
+[MSG 6: Urgencia] ──(Dia 3, 19h)
+    │
+    ├── COMPROU? ──→ [MSG PC-1] ──→ FIM
+    │
+    ▼
+[MSG 7: Ultimo Aviso] ──(Dia fechamento, 20h)
+    │
+    ├── COMPROU? ──→ [MSG PC-1] ──→ FIM
+    │
+    ▼
+[FIM — Lead marcado como "nao converteu"]
+    
+    ╔════════════════════════════════════╗
+    ║ OPT-OUT em QUALQUER PONTO ──→ FIM ║
+    ╚════════════════════════════════════╝
+```
+
+---
+
+## METRICAS DE ACOMPANHAMENTO
+
+```
+METRICAS POR MENSAGEM:
+
+| MSG | Enviadas | Entregues | Lidas | Cliques | Respostas | Opt-outs |
+|-----|----------|-----------|-------|---------|-----------|----------|
+| 1   |          |           |       |         |           |          |
+| 2   |          |           |       |         |           |          |
+| 3   |          |           |       |         |           |          |
+| 4   |          |           |       |         |           |          |
+| 5   |          |           |       |         |           |          |
+| 6   |          |           |       |         |           |          |
+| 7   |          |           |       |         |           |          |
+
+BENCHMARKS:
+- Taxa de entrega: > 95%
+- Taxa de leitura: > 70%
+- Taxa de clique: > 15%
+- Taxa de opt-out: < 5%
+- Taxa de conversao: depende do funil
+```
+
+---
+
+## HISTORICO DE VERSOES
+
+| Versao | Data | Autor | Alteracao |
+|--------|------|-------|-----------|
+| 1.0 | {{data_criacao}} | {{autor}} | Versao inicial |
+
+---
+
+## CHECKLIST FINAL
+
+```
+FLUXO:
+- [ ] Trigger definido com fonte do lead
+- [ ] Min 5 mensagens na sequencia
+- [ ] Timing definido para cada mensagem
+- [ ] Condicoes de fluxo documentadas
+- [ ] Sequencia pos-compra criada
+- [ ] Mapa visual do fluxo completo
+
+COPY:
+- [ ] Tom consistente e pessoal (nao parece robo)
+- [ ] Variaveis usadas corretamente
+- [ ] Progressao: valor → prova → oferta → urgencia
+- [ ] Cada mensagem tem acao esperada clara
+
+COMPLIANCE:
+- [ ] Opt-out em toda mensagem apos a primeira
+- [ ] Palavras-chave de opt-out configuradas
+- [ ] Confirmacao de opt-out automatica
+- [ ] Horario de envio respeitado (08h-21h)
+- [ ] Max msgs/dia respeitado
+- [ ] LGPD compliant
+- [ ] Opt-in explicito na captura
+
+TECNICO:
+- [ ] Plataforma de automacao configurada
+- [ ] Variaveis mapeadas ao CRM
+- [ ] Webhooks/integracoes testadas
+- [ ] Fluxo testado end-to-end com lead fake
+```