drm-core 1.0.0 → 1.3.0

package/scaffold/.drm-core/workflows/backend-whatsapp.yaml

@@ -0,0 +1,395 @@
+# =============================================================================
+# BACKEND WHATSAPP — Workflow de Automacao (4 Fases)
+# Pipeline: contexto → fluxo de mensagens → copy → compliance
+# =============================================================================
+
+workflow:
+  id: backend-whatsapp
+  name: "Backend WhatsApp"
+  version: "1.0"
+  description: >
+    Cria o backend completo de automacao WhatsApp pos-compra e nurture.
+    Desde o trigger de compra ate follow-up de high-ticket, passando por
+    welcome, nutricao programada, qualificacao e oferta.
+
+  trigger: manual
+  estimated_duration: "2-3 dias uteis"
+  priority: high
+
+  # ---------------------------------------------------------------------------
+  # FASES
+  # ---------------------------------------------------------------------------
+  phases:
+    - phase_1: "Contexto e Objetivos"
+    - phase_2: "Fluxo de Mensagens"
+    - phase_3: "Copy das Mensagens"
+    - phase_4: "Compliance WhatsApp"
+
+  # ---------------------------------------------------------------------------
+  # SEQUENCIA DE STEPS
+  # ---------------------------------------------------------------------------
+  sequence:
+
+    # =========================================================================
+    # FASE 1 — CONTEXTO E OBJETIVOS (@atena)
+    # =========================================================================
+    - step: definir_contexto
+      phase: 1
+      agent: "@atena"
+      action: "*contexto-whatsapp"
+      description: >
+        Define o contexto do backend WhatsApp: produto vendido, perfil do
+        comprador, objetivo do fluxo (retencao, upsell, high-ticket),
+        tom de comunicacao, horarios de envio permitidos, metricas de
+        sucesso esperadas.
+      inputs:
+        - "Produto/oferta principal"
+        - "docs/estrategia/avatar-profile.md (se existir)"
+        - "Plataforma de automacao (ex: ManyChat, Wati, Whaticket)"
+      outputs:
+        - "docs/whatsapp/contexto-backend.md"
+      requires: null
+      next: mapear_triggers
+      on_failure: "Solicitar informacoes minimas: produto, publico, objetivo"
+      validation:
+        type: checklist
+        criteria: >
+          Deve conter: produto descrito, persona do comprador, objetivo
+          do fluxo, tom de comunicacao, horarios de envio, KPIs definidos
+          (taxa de resposta, taxa de conversao high-ticket).
+
+    - step: mapear_triggers
+      phase: 1
+      agent: "@atena"
+      action: "*mapear-triggers"
+      description: >
+        Identifica todos os triggers que iniciam fluxos: compra confirmada,
+        abandono de carrinho, lead capturado, resposta a mensagem, inatividade,
+        clique em link, tag adicionada.
+      inputs:
+        - "docs/whatsapp/contexto-backend.md"
+        - "Integracoes disponiveis (gateway pagamento, CRM, email)"
+      outputs:
+        - "docs/whatsapp/mapa-triggers.md"
+      requires: definir_contexto
+      next: fluxo_welcome
+      on_failure: "Mapear trigger minimo: compra confirmada"
+      validation:
+        type: checklist
+        criteria: >
+          Cada trigger deve ter: evento de origem, condicao de ativacao,
+          delay antes da primeira mensagem, fluxo destino.
+
+    # =========================================================================
+    # FASE 2 — FLUXO DE MENSAGENS (@poseidon)
+    # =========================================================================
+    - step: fluxo_welcome
+      phase: 2
+      agent: "@poseidon"
+      action: "*fluxo-welcome"
+      description: >
+        Define fluxo de welcome pos-compra: mensagem imediata de confirmacao,
+        entrega do produto/acesso, instrucoes de uso, apresentacao do
+        suporte, expectativa do que vem a seguir.
+      inputs:
+        - "docs/whatsapp/contexto-backend.md"
+        - "docs/whatsapp/mapa-triggers.md"
+      outputs:
+        - "docs/whatsapp/fluxo-welcome.md"
+      requires: mapear_triggers
+      next: fluxo_nutricao
+      on_failure: "Simplificar para 2 mensagens: confirmacao + entrega"
+      validation:
+        type: checklist
+        criteria: >
+          Fluxo com: trigger definido, 2-4 mensagens, timing entre cada
+          mensagem, variaveis de personalizacao (nome, produto), condicao
+          de parada (resposta do usuario).
+
+    - step: fluxo_nutricao
+      phase: 2
+      agent: "@poseidon"
+      action: "*fluxo-nutricao"
+      description: >
+        Define fluxo de nutricao nos dias 1, 3, 5 e 7 pos-compra: conteudo
+        de valor relacionado ao produto, dicas de uso, cases de sucesso,
+        preparacao para oferta high-ticket. Cada dia com objetivo especifico.
+      inputs:
+        - "docs/whatsapp/fluxo-welcome.md"
+        - "docs/whatsapp/contexto-backend.md"
+      outputs:
+        - "docs/whatsapp/fluxo-nutricao.md"
+      requires: fluxo_welcome
+      next: fluxo_qualificacao
+      on_failure: "Reduzir para dias 1 e 5 somente"
+      validation:
+        type: checklist
+        criteria: >
+          Dia 1: dica de uso rapido. Dia 3: case de sucesso.
+          Dia 5: conteudo avancado. Dia 7: teaser da oferta.
+          Cada mensagem com: timing exato, conteudo descrito,
+          variavel de personalizacao, condicao de skip (se ja comprou).
+        schedule:
+          dia_1:
+            timing: "24h apos welcome"
+            objetivo: "Engajar com quick win"
+          dia_3:
+            timing: "72h apos welcome"
+            objetivo: "Social proof e resultados"
+          dia_5:
+            timing: "120h apos welcome"
+            objetivo: "Conteudo avancado, autoridade"
+          dia_7:
+            timing: "168h apos welcome"
+            objetivo: "Preparacao para oferta"
+
+    - step: fluxo_qualificacao
+      phase: 2
+      agent: "@poseidon"
+      action: "*fluxo-qualificacao"
+      description: >
+        Define fluxo de qualificacao pos-nutricao: perguntas de qualificacao
+        via botoes/respostas rapidas, score de qualificacao, segmentacao
+        automatica (quente, morno, frio), roteamento baseado em score.
+      inputs:
+        - "docs/whatsapp/fluxo-nutricao.md"
+        - "docs/whatsapp/contexto-backend.md"
+      outputs:
+        - "docs/whatsapp/fluxo-qualificacao.md"
+      requires: fluxo_nutricao
+      next: fluxo_oferta_ht
+      on_failure: "Usar qualificacao simplificada: 1 pergunta binaria"
+      validation:
+        type: checklist
+        criteria: >
+          Deve conter: 2-4 perguntas de qualificacao, formato de resposta
+          (botoes/texto), logica de scoring, 3 segmentos de saida
+          (quente/morno/frio), roteamento por segmento.
+
+    - step: fluxo_oferta_ht
+      phase: 2
+      agent: "@poseidon"
+      action: "*fluxo-oferta-high-ticket"
+      description: >
+        Define fluxo de oferta high-ticket para leads quentes: apresentacao
+        da oferta, beneficios, urgencia, CTA para agendar call/comprar,
+        tratamento de objecoes automatizado, deadline.
+      inputs:
+        - "docs/whatsapp/fluxo-qualificacao.md"
+        - "docs/estrategia/oferta-completa.md (se existir)"
+      outputs:
+        - "docs/whatsapp/fluxo-oferta-ht.md"
+      requires: fluxo_qualificacao
+      next: fluxo_followup
+      on_failure: "Direcionar para pagina de vendas em vez de venda direta"
+      validation:
+        type: checklist
+        criteria: >
+          Fluxo com: condicao de entrada (score minimo), sequencia de
+          3-5 mensagens, tratamento de objecao (2-3 objecoes), CTA
+          claro, deadline definido, fallback se nao responder.
+
+    - step: fluxo_followup
+      phase: 2
+      agent: "@poseidon"
+      action: "*fluxo-followup"
+      description: >
+        Define fluxo de follow-up para quem nao respondeu ou nao converteu:
+        lembrete sutil (24h), reforco de urgencia (48h), ultima chance (72h),
+        reclassificacao para fluxo frio se nao engajar.
+      inputs:
+        - "docs/whatsapp/fluxo-oferta-ht.md"
+        - "docs/whatsapp/fluxo-qualificacao.md"
+      outputs:
+        - "docs/whatsapp/fluxo-followup.md"
+      requires: fluxo_oferta_ht
+      next: copy_welcome_msgs
+      on_failure: "Encerrar fluxo com mensagem de despedida amigavel"
+      validation:
+        type: checklist
+        criteria: >
+          3 mensagens de follow-up com timing definido (24h, 48h, 72h),
+          tom progressivamente mais urgente mas nunca agressivo,
+          condicao de saida (resposta ou 72h sem engajamento),
+          reclassificacao automatica apos timeout.
+
+    # =========================================================================
+    # FASE 3 — COPY DAS MENSAGENS (@apolo)
+    # =========================================================================
+    - step: copy_welcome_msgs
+      phase: 3
+      agent: "@apolo"
+      action: "*escrever-msgs-welcome"
+      description: >
+        Escreve copy de cada mensagem do fluxo welcome: tom pessoal e
+        acolhedor, uso de nome, emojis estrategicos, mensagens curtas
+        (max 300 caracteres), formatacao WhatsApp (negrito, italico).
+      inputs:
+        - "docs/whatsapp/fluxo-welcome.md"
+        - "docs/whatsapp/contexto-backend.md"
+      outputs:
+        - "docs/whatsapp/copy/msgs-welcome.md"
+      requires: fluxo_followup
+      next: copy_nutricao_msgs
+      on_failure: "Simplificar tom e reduzir tamanho das mensagens"
+      validation:
+        type: checklist
+        criteria: >
+          Cada mensagem com: texto final pronto para uso, variaveis
+          marcadas com {{variavel}}, emojis posicionados, max 300
+          caracteres, formatacao WhatsApp aplicada.
+
+    - step: copy_nutricao_msgs
+      phase: 3
+      agent: "@apolo"
+      action: "*escrever-msgs-nutricao"
+      description: >
+        Escreve copy das 4 mensagens de nutricao (dias 1, 3, 5, 7).
+        Cada mensagem com valor real, nao generica. Inclui variantes
+        A/B para subject/abertura da mensagem.
+      inputs:
+        - "docs/whatsapp/fluxo-nutricao.md"
+        - "docs/whatsapp/contexto-backend.md"
+        - "docs/estrategia/avatar-profile.md (se existir)"
+      outputs:
+        - "docs/whatsapp/copy/msgs-nutricao.md"
+      requires: copy_welcome_msgs
+      next: copy_qualificacao_msgs
+      on_failure: "Reescrever com foco em storytelling e resultados"
+      validation:
+        type: checklist
+        criteria: >
+          4 mensagens com conteudo unico por dia, valor tangivel
+          entregue, hook de abertura forte, CTA sutil preparando
+          para oferta, variante A/B para dia 1 e dia 7.
+
+    - step: copy_qualificacao_msgs
+      phase: 3
+      agent: "@apolo"
+      action: "*escrever-msgs-qualificacao"
+      description: >
+        Escreve copy das mensagens de qualificacao: perguntas naturais
+        (nao parecer formulario), opcoes de botao, respostas condicionais
+        baseadas na resposta do lead.
+      inputs:
+        - "docs/whatsapp/fluxo-qualificacao.md"
+        - "docs/whatsapp/contexto-backend.md"
+      outputs:
+        - "docs/whatsapp/copy/msgs-qualificacao.md"
+      requires: copy_nutricao_msgs
+      next: copy_oferta_followup_msgs
+      on_failure: "Reformular perguntas para tom mais conversacional"
+      validation:
+        type: checklist
+        criteria: >
+          Perguntas em tom conversacional, opcoes de resposta claras,
+          respostas condicionais escritas para cada cenario,
+          transicao suave entre perguntas.
+
+    - step: copy_oferta_followup_msgs
+      phase: 3
+      agent: "@apolo"
+      action: "*escrever-msgs-oferta-followup"
+      description: >
+        Escreve copy das mensagens de oferta high-ticket e follow-up:
+        pitch de valor, tratamento de objecoes, urgencia, lembretes,
+        ultima chance. Timing e variaveis definidos.
+      inputs:
+        - "docs/whatsapp/fluxo-oferta-ht.md"
+        - "docs/whatsapp/fluxo-followup.md"
+        - "docs/whatsapp/contexto-backend.md"
+      outputs:
+        - "docs/whatsapp/copy/msgs-oferta-ht.md"
+        - "docs/whatsapp/copy/msgs-followup.md"
+      requires: copy_qualificacao_msgs
+      next: compliance_whatsapp
+      on_failure: "Revisar tom — WhatsApp exige abordagem mais pessoal"
+      validation:
+        type: checklist
+        criteria: >
+          Oferta: 3-5 mensagens com pitch, prova social, urgencia, CTA.
+          Follow-up: 3 mensagens com tom crescente mas respeitoso.
+          Tratamento de objecoes: 2-3 respostas prontas.
+          Todas com variaveis e formatacao WhatsApp.
+
+    # =========================================================================
+    # FASE 4 — COMPLIANCE WHATSAPP (@temis)
+    # =========================================================================
+    - step: compliance_whatsapp
+      phase: 4
+      agent: "@temis"
+      action: "*whatsapp-compliance-checklist"
+      description: >
+        Revisao de compliance especifica para WhatsApp: politicas do
+        WhatsApp Business API, LGPD (consentimento, opt-out), frequencia
+        de envio, horario permitido, conteudo proibido, template approval
+        requirements, anti-spam.
+      inputs:
+        - "docs/whatsapp/copy/msgs-welcome.md"
+        - "docs/whatsapp/copy/msgs-nutricao.md"
+        - "docs/whatsapp/copy/msgs-qualificacao.md"
+        - "docs/whatsapp/copy/msgs-oferta-ht.md"
+        - "docs/whatsapp/copy/msgs-followup.md"
+        - "docs/whatsapp/contexto-backend.md"
+      outputs:
+        - "docs/whatsapp/compliance/whatsapp-compliance-report.md"
+        - "docs/whatsapp/compliance/alteracoes-obrigatorias.md"
+      requires: copy_oferta_followup_msgs
+      next: aplicar_compliance_wpp
+      on_failure: "Bloquear ativacao do fluxo ate compliance aprovado"
+      validation:
+        type: verdict
+        criteria: >
+          APROVADO: Todas as mensagens em compliance com WhatsApp
+          Business API e LGPD.
+          AJUSTES: Alteracoes menores necessarias (listadas).
+          BLOQUEADO: Violacoes criticas que impedem ativacao.
+        checklist_items:
+          - "Consentimento opt-in documentado"
+          - "Mecanismo de opt-out em toda mensagem"
+          - "Horario de envio dentro do permitido (8h-20h)"
+          - "Frequencia nao excede 1 msg/dia (exceto welcome)"
+          - "Sem conteudo proibido (saude sem evidencia, financeiro sem disclaimer)"
+          - "Templates compativeis com WhatsApp Business API approval"
+          - "LGPD: base legal definida, dados minimos coletados"
+          - "Anti-spam: intervalos respeitados, stop words implementadas"
+
+    - step: aplicar_compliance_wpp
+      phase: 4
+      agent: "@apolo"
+      action: "*aplicar-correcoes-whatsapp"
+      description: >
+        Aplica correcoes de compliance nas mensagens WhatsApp mantendo
+        o tom conversacional e a eficacia da comunicacao.
+      inputs:
+        - "docs/whatsapp/compliance/alteracoes-obrigatorias.md"
+        - "docs/whatsapp/copy/msgs-welcome.md"
+        - "docs/whatsapp/copy/msgs-nutricao.md"
+        - "docs/whatsapp/copy/msgs-oferta-ht.md"
+        - "docs/whatsapp/copy/msgs-followup.md"
+      outputs:
+        - "docs/whatsapp/copy/ (todos atualizados)"
+        - "docs/whatsapp/compliance/compliance-applied-log.md"
+      requires: compliance_whatsapp
+      next: null
+      on_failure: "Escalar para @temis re-revisao"
+      validation:
+        type: checklist
+        criteria: >
+          Todas as correcoes obrigatorias aplicadas, opt-out presente
+          em todas as mensagens, log de alteracoes documentado.
+
+  # ---------------------------------------------------------------------------
+  # CONFIGURACAO GLOBAL
+  # ---------------------------------------------------------------------------
+  config:
+    compliance_blocking: true
+    require_opt_out_every_message: true
+    max_message_length: 300
+    allowed_send_hours: "08:00-20:00"
+    whatsapp_formatting: true
+
+  failure_handling:
+    global_escalation: "@atena"
+    max_retries_per_step: 2
+    on_critical_failure: "Pausar fluxo, notificar usuario"