Procedimentos Operacionais Padrao — MarkSaint

1Objetivo e Escopo

Diagnosticar tecnicamente o site do cliente B2B, mapeando todos os fatores que limitam o ranqueamento organico e construindo um plano de acao orientado a impacto sobre faturamento, nao apenas a metricas vaidosas.

Quando realizar:

• Onboarding (obrigatorio): baseline para acompanhamento mensal
• Re-auditoria trimestral: medir evolucao e detectar novas ameacas
• Sob demanda: queda brusca de trafego, penalidade Google, migracao de site, troca de CMS

2Pilares Tecnicos da Auditoria

3Fluxo de Entrega

1. Coleta de acessos: GSC, GA4, painel do CMS (WP/outro), hospedagem se necessario.
2. Crawl completo: rodar Screaming Frog/Sitebulb. Exportar dados e categorizar erros por severidade (Critico, Alto, Medio, Baixo).
3. Benchmark competitivo: 3-5 concorrentes B2B diretos. Comparar DR, paginas indexadas, palavras no top 10 e perfil de backlinks.
4. Relatorio executivo: resumo, score geral, problemas por categoria, impacto estimado, prioridade.
5. Plano de acao: Quick Wins (0-30 dias), Medio Prazo (30-90), Longo Prazo (90+).
6. Apresentacao: reuniao executiva de 60 min com diretoria do cliente.

4KPIs do Servico

1Especificidades do B2B

Diferente do B2C, o B2B tem buscas de baixo volume porem altissimo valor. Uma keyword com 30 buscas/mes pode gerar um deal de R$ 500K. A pesquisa MarkSaint prioriza intencao e bottom-of-funnel sobre volume bruto.

2Fluxo de Pesquisa

1. Seed Keywords: 10-20 termos raiz a partir do conhecimento do negocio, dores do publico e conversa com clientes atuais. Entrevistar 1-2 vendedores do cliente.
2. Expansao com ferramentas: Ahrefs, SEMrush, Google Keyword Planner, AnswerThePublic.
3. Content Gap competitivo: mapear keywords em que concorrentes ranqueiam e o cliente nao.
4. Search Console: identificar queries em posicao 5-20 com volume relevante (quick wins).
5. Classificacao por intencao: Informacional, Navegacional, Comercial, Transacional.
6. Priorizacao: matriz Volume x Dificuldade x Intencao Comercial.
7. Mapeamento para conteudo: atribuir cada keyword a uma URL existente ou nova.

3Classificacao por Intencao B2B

4KPIs

1Schemas Obrigatorios por Tipo de Pagina

2Protocolo de Migracao Segura

Migracoes mal executadas destroem posicoes. Siga rigorosamente:

Pre-migracao:

1. Crawl completo do site atual + planilha de URLs
2. Exportar posicoes atuais (Ahrefs/SEMrush)
3. Mapear redirecionamentos 301 (URL antiga → nova)
4. Backup completo (arquivos + banco)
5. Notificar cliente sobre risco de oscilacao temporaria

Pos-migracao (72h iniciais):

1. Verificar TODOS os 301s funcionando
2. Submeter novo sitemap no GSC
3. Solicitar reindexacao das paginas principais
4. Monitorar GSC > Cobertura diariamente por 30 dias

3KPIs Tecnicos

1Padroes de Otimizacao

2Rotina Mensal On-Page

1. Revisao de Search Console: identificar queries em posicao 5-20 (quick wins).
2. Otimizacao de title/meta: reescrever os 10 titulos com pior CTR do mes.
3. Auditoria de canibalizacao: mapear paginas competindo pela mesma query.
4. Atualizacao de conteudo antigo: 2-3 conteudos historicos por mes (refresh).
5. Linkagem interna: adicionar 5-10 links internos novos por semana.
6. Relatorio: documentar mudancas + impacto medido em 30 dias.

3KPIs

1Estrategias MarkSaint para Backlinks B2B

2Auditoria de Backlinks Existentes

1. Exportar todos os backlinks (Ahrefs + GSC).
2. Classificar por DR e relevancia tematica.
3. Identificar links toxicos (spammy, irrelevantes, paid links de PBN).
4. Listar para arquivo de Disavow se necessario.
5. Mapear oportunidades de "broken link building" em referers.

3KPIs

1Analise de Log Files

Logs do servidor mostram como o Googlebot realmente rastreia o site, em vez de apenas inferir. Critico para sites grandes (5K+ URLs).

O que verificar:

• Frequencia de rastreamento por tipo de pagina (priorizar paginas comerciais)
• Erros 4xx e 5xx encontrados pelo Googlebot
• Crawl budget desperdicado em paginas sem valor (filtros, paginacao infinita)
• User-agents falsos (bots maliciosos consumindo banda)
• Paginas orfas que o Googlebot nunca visita

2SEO em Sites JavaScript

Checklist JS SEO:

• Conteudo critico renderizado no HTML inicial
• Links como tags <a href> (nao onClick)
• Title e meta atualizados via Vue Router / React Router
• Schema injetado no SSR
• Teste no URL Inspector do GSC

1Setup Inicial GBP

1. Reivindicacao/criacao: verificar ficha existente no Google Maps. Reivindicar se ja existe.
2. Verificacao: via cartao postal, telefone, video ou instantanea (varia por categoria).
3. Preenchimento completo: nome, endereco, telefone, site, horarios, categoria principal e secundarias, descricao 750 caracteres com keywords.
4. Fotos profissionais: minimo 10 (fachada, interior, equipe, produtos/servicos). Resolucao ≥ 720x720.
5. Servicos e Produtos: cadastrar todos com precos quando aplicavel.
6. UTM no link: rastrear trafego do GBP no GA4.

2Rotina Semanal

3KPIs SEO Local

1Setup do Tracker

Toda conta MarkSaint tem rastreamento diario das keywords-alvo:

• Ferramentas: SEMrush Position Tracking, Ahrefs Rank Tracker ou SE Ranking
• Volume tipico: 50-200 keywords por cliente conforme escopo
• Segmentacao: brand vs nao-brand, mobile vs desktop, local vs nacional
• Concorrentes: 3-5 concorrentes monitorados em paralelo

2Alertas Automaticos

3Relatorio Mensal

• Top 10 / Top 3 keywords (variacao mensal)
• Trafego organico (sessions, conversoes, receita atribuida)
• Comparativo com concorrentes monitorados
• Updates de algoritmo do mes
• Plano de acao do proximo mes (sempre acionavel)

1Padroes de Conteudo MarkSaint

2Fluxo de Producao

1. Briefing: Analista SEO entrega briefing com keyword-alvo, intencao, search intent, concorrentes na SERP, secoes obrigatorias.
2. Pesquisa: Redator analisa top 10 da SERP, identifica gaps de conteudo (Content Gap).
3. Outline: estrutura H1-H2-H3 aprovada antes de redigir.
4. Redacao: primeira versao seguindo brand voice e diretrizes EEAT.
5. Revisao SEO: Editor checa keyword density natural, links internos, alt-text, schema sugerido.
6. Revisao de cliente: ate 2 rodadas de ajuste.
7. Publicacao: upload no CMS, configuracao de meta, schema, indexacao via GSC.
8. Distribuicao: sumario do conteudo enviado para canais do cliente (newsletter/social).

3Diretrizes EEAT

• Experience: usar dados proprios, casos reais, prints de ferramentas, autoria humana identificada.
• Expertise: autor com bio, credenciais e link para LinkedIn.
• Authoritativeness: citar fontes confiaveis (Google, [Schema.org](http://Schema.org), estudos academicos, dados oficiais).
• Trust: data de publicacao + atualizacao visiveis, schema de autoria, HTTPS, politica de privacidade.

4KPIs

1Conceito de Topical Authority

Google ranqueia melhor sites que demonstram profundidade tematica. Em vez de 100 posts soltos sobre tudo, fazer 30 posts profundos sobre 3-4 temas-pilar com linkagem cruzada vence.

2Exemplo Real

3Fluxo de Implementacao

1. Identificar 3-5 temas estrategicos do cliente (alinhados ao ICP).
2. Pesquisa de keyword cluster por tema (10-20 satelites cada).
3. Construir pillar page primeiro (mes 1).
4. Publicar 2-3 satelites por mes (3-6 meses).
5. Linkagem interna obrigatoria: cada satelite linka para pillar e para 2-3 satelites do mesmo cluster.
6. Mensurar topical authority via aumento de keywords ranqueadas no tema.

1Campos Obrigatorios

2Boas Praticas

• Briefing nao pode ter mais de 1 keyword principal (evita canibalizacao).
• Sempre incluir 2-3 perguntas do "People Also Ask" para responder no conteudo.
• Citar pelo menos 1 fonte autoritativa por secao.
• Revisar briefing antes de mandar para redator (5 min) — evita retrabalho.

1Tipos de Material

2Fluxo de Producao

1. Briefing alinhado com cliente (tema, persona, formato).
2. Roteiro/sumario aprovado.
3. Redacao do conteudo.
4. Diagramacao (Figma / Canva Pro / InDesign).
5. Aprovacao do cliente (ate 2 rodadas).
6. Entrega: PDF interativo + versao para landing page de captura.
7. Configuracao da LP de download (se contratada via POP 14).

1Por que codigo puro

2Stack MarkSaint

• Construcao: Manus.ai (agente autonomo) gera o esqueleto + iteracoes rapidas, com revisao humana e ajustes finos pelo time
• Front-end: HTML5 semantico + CSS3 (custom properties, grid, flexbox) + JS vanilla / Alpine.js
• Build: Vite ou esbuild para minificacao
• Imagens: WebP/AVIF + lazy loading + srcset responsivo
• Fontes: Google Fonts com font-display:swap ou self-hosted
• Hospedagem: Cloudflare Pages / Workers
• Analytics: GA4 + GSC + GTM (POP 21)
• Schema: JSON-LD no head (POP 03)

3Etapas do Projeto

1. Briefing + arquitetura de informacao
2. Wireframe (Figma) - aprovacao do cliente
3. Design visual high-fidelity
4. Desenvolvimento front-end
5. Integracao de Pixel + GA4 + GTM + Schema
6. Testes (mobile, desktop, navegadores, A11y)
7. Deploy em ambiente de homologacao
8. Aprovacao final + producao + GSC
9. Suporte de 30 dias incluido

1Estrutura Anatomica MarkSaint

2Integracoes Padrao

• CRM: RD Station, HubSpot, ActiveCampaign, Pipedrive (via webhook ou nativo)
• Pixels: Meta Pixel, Google Ads, LinkedIn Insight Tag
• Tag Manager: GTM com Consent Mode v2 (LGPD)
• WhatsApp: botao com mensagem pre-formatada + UTM
• Heatmap: Microsoft Clarity (gratuito) ou Hotjar

3Workflow com Manus.ai

1. Briefing detalhado: objetivo, persona, oferta, copy-base, brand guide e referencias visuais
2. Geracao via Manus.ai: agente cria o primeiro draft completo (HTML/CSS/JS, responsivo, com schema) em ate 24h
3. Refinamento humano: ajustes de copy persuasiva, design, microinteracoes e otimizacao de CWV
4. Integracoes: conexao com CRM, pixels, GTM, WhatsApp API
5. QA: testes em 3+ dispositivos, 2 navegadores, validacao A11y e LGPD (Consent Mode v2)
6. Deploy + monitoramento: publicacao + heatmap nos primeiros 7 dias

4KPIs de Conversao

1Stack Tecnologico

• Construcao: Manus.ai gera estrutura inicial (telas, navegacao, integracoes), revisada e otimizada pelo time
• Plataforma: Android nativo (Kotlin) ou cross-platform (Flutter)
• Backend: Supabase / Firebase / API customizada via Cloudflare Workers
• Banco: PostgreSQL (Supabase) ou Firestore
• Autenticacao: Supabase Auth / Firebase Auth (Google, Email, Magic Link)
• Notificacoes push: Firebase Cloud Messaging
• Analytics: Firebase Analytics + Crashlytics

2Etapas

1. Discovery: requisitos funcionais + telas-chave
2. Wireframe + design (Figma)
3. Desenvolvimento iterativo (sprints semanais)
4. Testes em dispositivos reais (Android 10+)
5. Setup da Google Play Console (conta do cliente)
6. Submissao + revisao Google (3-7 dias)
7. Publicacao + monitoramento das primeiras semanas

3Pos-Lancamento

• Suporte 30 dias para correcoes criticas
• Plano de manutencao mensal opcional
• Atualizacoes obrigatorias do SDK Android (anuais)

1Casos de Uso B2B Frequentes

2Stack MarkSaint para IA

• Construcao: Manus.ai como agente principal de desenvolvimento (rotas, schemas, integracoes), com revisao humana de seguranca e prompts
• LLMs: OpenAI GPT-4, Anthropic Claude, Google Gemini (escolha por caso)
• Frameworks: LangChain, LlamaIndex (RAG)
• Vector DBs: Pinecone, Supabase pgvector
• Front-end: Next.js / SvelteKit
• Hospedagem: Cloudflare Workers + R2 + D1 (edge computing)
• Observabilidade: LangSmith / Helicone para traces de LLM

3Boas Praticas de Engenharia

• Sempre usar prompt caching (reducao 90% no custo)
• System prompt versionado em git
• Logs de prompts e respostas (com mask de dados sensiveis)
• Fallback gracioso quando LLM falha
• Rate limiting por usuario para evitar abuso
• Avaliacao continua (eval set) para detectar regressoes

1Fases do SaaS

1. Discovery (1-2 semanas): requisitos, ICP, jobs-to-be-done, modelo de negocio.
2. Arquitetura (1 semana): infra, banco, autenticacao, billing, escolhas de stack.
3. MVP (4-12 semanas): funcionalidades core funcionando para primeiros usuarios.
4. Beta fechado: 5-15 usuarios reais testando.
5. Lancamento publico: marketing + onboarding automatizado.
6. Iteracao continua: sprints de evolucao baseados em uso real.

2Componentes Padrao

• Construcao: Manus.ai gera o scaffold completo (rotas, modelos, hooks, componentes) em ate 5 dias uteis para um MVP base
• Auth: Email + Google + Magic Link via Supabase/Clerk
• Billing: Stripe (cartao internacional) + Asaas/Pagar.me (boleto/Pix)
• Roles: RBAC (admin, owner, member, viewer)
• Multi-tenant: isolamento por workspace/organizacao
• Painel admin: gerenciamento de usuarios, planos, suporte
• Email transacional: Resend / SendGrid
• Monitoramento: Sentry + Better Stack

1Hardening Inicial WordPress

1. Atualizar WP core, temas e plugins para ultima versao estavel
2. Remover plugins/temas inativos
3. Trocar prefixo do banco de dados (de wp_ para algo unico)
4. Desabilitar XML-RPC (raramente necessario)
5. Limitar tentativas de login (Wordfence / Limit Login Attempts)
6. 2FA obrigatorio para usuarios admin
7. Mudar URL de login (de /wp-admin para algo customizado)
8. Desabilitar edicao de arquivos via dashboard (DISALLOW_FILE_EDIT)
9. Headers de seguranca (CSP, X-Frame-Options, HSTS)
10. WAF Cloudflare ativado

2Manutencao Continua

3Resposta a Incidente (Site Comprometido)

1. Isolar o site (modo manutencao via .htaccess ou Cloudflare)
2. Backup forense (estado atual antes de mexer)
3. Restaurar ultimo backup limpo conhecido
4. Trocar TODAS as senhas (WP, FTP, banco, hospedagem)
5. Escanear arquivos com Wordfence + manual (find . -name "*.php" -mtime -7)
6. Patch vulnerabilidade que originou o ataque
7. Submeter pedido de revisao no GSC se foi sinalizado
8. Post-mortem ao cliente

1Metricas e Metas

2Tecnicas de Otimizacao

• LCP: preload de imagem hero, CDN, hospedagem proxima do publico
• INP: reduzir JavaScript no main thread, code splitting, web workers
• CLS: definir width/height em imagens, reservar espaco para anuncios
• TTFB: CDN (Cloudflare), edge functions, cache de HTML estatico
• Imagens: WebP/AVIF, srcset responsivo, lazy loading nativo
• Fontes: font-display: swap, preload critical, self-hosted
• Third-party scripts: async/defer, GTM Server-side

3KPIs

1Metodologia CRO MarkSaint

1. Pesquisa qualitativa: Hotjar/Clarity heatmaps, session recordings, formularios de feedback
2. Analise quantitativa: GA4 funnels, taxa de bounce por bloco, scroll depth
3. Hipoteses: formular hipoteses testaveis (Se mudarmos X, Y aumentara em Z%)
4. Priorizacao: framework PIE (Potential, Importance, Ease) ou ICE
5. Teste A/B: rodar com significancia estatistica (95% confianca, minimo 1000 visitas/variante)
6. Analise de resultados: ganhador, perdedor ou inconclusivo
7. Implementar e iterar

2Ferramentas

3KPIs CRO

1Setup GA4 Padrao

2Eventos B2B Padronizados

3Padrao UTM

4Consent Mode v2 (LGPD)

• Banner de cookies bloqueando scripts ate consentimento
• CMP integrado: CookieYes / Cookiebot / Complianz
• Consent Mode v2 atualiza GA4 e Google Ads automaticamente
• Logs de consentimento (IP + timestamp) registrados

1Stack BI MarkSaint

2Paginas Padrao do Dashboard SEO

1. Visao Geral: trafego organico, leads, top keywords
2. SEO On-Page: posicoes, CTR organico, top paginas
3. SEO Tecnico: cobertura GSC, CWV, indexacao
4. Off-Page: backlinks novos, DR, perfil de links
5. Conteudo: posts publicados, engajamento, leads por conteudo
6. Funil: visitantes → leads → MQLs → SQLs → vendas
7. Comparativo: mes atual vs mes anterior vs mesmo mes ano passado

3Boas Praticas de Design

• Cores da marca do cliente (nao MarkSaint)
• Filtro de data sempre visivel no topo
• KPIs no topo, graficos no meio, tabelas na base
• Linhas de meta/benchmark nos graficos
• Tooltips em metricas tecnicas
• Nunca mais de 8 elementos por pagina

1Estrutura da Reuniao (60 min)

2Pre-reuniao (Preparacao do Consultor)

• Crawl rapido do site (Screaming Frog, modo "free")
• PageSpeed Insights mobile + desktop
• Top keywords no Ahrefs/SEMrush
• Perfil de backlinks (resumo)
• Comparativo com 2 concorrentes diretos
• Stack publica (BuiltWith, Wappalyzer)

3Script de Agendamento - WhatsApp

4KPIs

1Checklist de Onboarding

1. E-mail de boas-vindas: apresentacao da equipe, links de acesso, cronograma dos 90 dias.
2. Coleta de acessos: GSC, GA4, CMS, hospedagem, CRM, Meta Business Manager (se ads).
3. Reuniao de Kickoff (60 min): conhecer ICP, jornada de compra, ticket medio, propostas valor.
4. Auditoria Tecnica (POP 01): entrega do diagnostico em ate 10 dias.
5. Pesquisa de keywords (POP 02): entrega em ate 10 dias.
6. Plano 90 dias: apresentacao do roadmap com Quick Wins, Medio e Longo Prazo.
7. Setup Tecnico: tagueamento, dashboard Looker Studio, projeto no software de gestao.
8. Primeiros entregaveis: 2-3 acoes implementadas em ate 15 dias (correcoes tecnicas, primeiro conteudo, etc.).

2Materiais Necessarios do Cliente

• Contrato assinado e escopo definido
• Formulario de onboarding preenchido
• Acessos liberados (GSC, GA4, CMS, hospedagem)
• Manual de marca / brand guide
• Lista de servicos/produtos com descricoes
• Lista de concorrentes diretos
• Estudos/pesquisas anteriores (se houver)
• Contatos do cliente: decisor, aprovador, operacional

1Roteiro Padrao (45 min)

2Documentacao Pos-Reuniao (24h)

• Ata enviada por e-mail com decisoes e responsaveis
• Backlog atualizado no software de gestao
• Acessos novos solicitados se aplicavel
• Proxima reuniao agendada no calendario

1Por que QBRs sao Inegociaveis no B2B

• Clientes B2B com QBR formal tem churn 40% menor
• E o momento ideal para upsell baseado em dados
• Posiciona a MarkSaint como parceiro estrategico, nao fornecedor
• Cria alinhamento com decisores C-Level que nao participam do dia-a-dia

2Estrutura da Apresentacao (60 min)

1. Capa + periodo + participantes
2. Resumo executivo (3-5 destaques)
3. Metricas SEO (trafego organico, keywords, posicoes)
4. Metricas de conteudo (publicacoes, engajamento, conversao)
5. Metricas tecnicas (CWV, indexacao, erros)
6. Funil de conversao (visitantes → leads → oportunidades → vendas)
7. ROI consolidado (investimento vs retorno)
8. Top 3 conteudos / paginas com melhor performance
9. Aprendizados (o que funcionou, o que nao funcionou)
10. Plano do proximo trimestre
11. Propostas de expansao (upsell, se aplicavel)

3Pos-QBR (24h)

• E-mail com resumo + apresentacao em PDF
• Acoes registradas no software de gestao com responsaveis
• Plano estrategico atualizado
• Proxima QBR agendada (T+90 dias)

1Health Score MarkSaint

2Plano de Recuperacao

1. Diagnostico interno (dia 1-2): historico, entregas, feedbacks
2. Reuniao com cliente (dia 3): ouvir sem se defender
3. Plano formal (dia 5): acoes corretivas escritas com prazos
4. Execucao acelerada (dia 5-15): entregas prioritarias diarias
5. Check-in (dia 15): avaliar percepcao
6. Confirmacao (dia 30): atualizar Health Score

3KPIs

1Template Padrao

2Exemplo - Analista SEO

3Regras

1Principios MarkSaint

• Proatividade: antecipar informacoes antes do cliente perguntar
• Clareza: objetiva, sem jargao desnecessario, com prazos
• Previsibilidade: cliente sabe quando e como sera atualizado
• Registro: toda decisao por escrito (e-mail/grupo)
• SLA: ≤ 4h uteis WhatsApp, ≤ 24h uteis e-mail

2Cadencia Padrao por Cliente B2B

3Scripts Tipo

1Configuracao

2Checklist de Entregas Aguardando configuracao

3Cadencia Recomendada por Pacote

1Ciclo Mensal

2Escalada de Cobranca

3KPIs

1Clausulas Obrigatorias

2SLAs por Servico

3Renovacao

1Conformidade Obrigatoria

2Resposta a Incidente

1. Detectar e conter (0-2h)
2. Avaliar risco aos titulares (2-24h)
3. Notificar ANPD em ate 72h se houver risco relevante
4. Notificar titulares afetados
5. Remediar a causa raiz
6. Documentar incidente para auditoria

1Estrutura do Programa

2Entregaveis

• 6 sessoes ao vivo (Google Meet) com gravacao
• Material didatico em PDF
• Biblioteca de 30+ prompts B2B prontos
• Workshop hands-on por departamento (vendas, marketing, suporte)
• Plano de adocao com 90 dias de marcos

1Servicos Recorrentes (Retainers)

2Servicos por Projeto

3Growth Packs (Combos Mensais)

Combos integrados que oferecem o melhor custo-beneficio para clientes B2B serios sobre crescimento organico:

4Escada Comercial

5Diferencial: Desenvolvimento via Manus.ai

Sites institucionais, landing pages, apps mobile, apps web com IA e SaaS na MarkSaint sao construidos em parceria com Manus.ai — agente autonomo de desenvolvimento — e refinados pelo time de engenharia.

6Posicionamento Comercial

Bullets recorrentes:

• Slogan: "Dados como Metodo. Crescimento como Destino."
• Foco exclusivo B2B (e-commerce, saude, financas, juridico, SaaS)
• Sem pacotes genericos - estrategia sob medida
• Stack SEO: Semrush, Ahrefs, Screaming Frog, GSC, GA4, Looker
• Sites em codigo puro (HTML5 + CSS3 + JS) - sem WP bloated
• Stack Dev: Manus.ai + revisao humana especializada (3-4x mais rapido que agencia tradicional)
• 40+ projetos com resultados documentaveis
• Diagnostico estrategico inicial gratuito (POP 23)

Objecoes comuns:

1Identificacao e Paleta

2Metricas SEO (customizaveis)

3Secoes de Texto

4Preview ao Vivo

1Setup Inicial da Conta

1. Conta MCC: vincular conta do cliente ao Manager Account (MCC) MarkSaint para gestao centralizada
2. Cobranca: validar cartao corporativo + alertas de gasto + faturamento em nome do cliente (NUNCA da agencia)
3. Conversoes: configurar via GTM + GA4 (POP 21) com Enhanced Conversions ativadas para B2B
4. Vinculacoes: Search Console, Google Analytics, YouTube, Merchant Center (se aplicavel)
5. Audiencias: importar listas do GA4, criar Customer Match (CRM upload com hash) e Lookalikes
6. Pixels e tags auditados: validar disparo via Tag Assistant + GTM Preview Mode
7. Alertas: notificacoes de gasto diario, queda de impressoes, suspensao de anuncios
8. Permissoes: apenas leitura para o cliente, edicao para gestor + read-only para CS

2Estrutura Padrao de Campanhas B2B

3Match Types e Negativacao

1. Iniciar com frase (phrase match) - balanceia controle e alcance
2. Adicionar exato (exact match) para os termos vencedores apos 30 dias
3. Usar amplo (broad) APENAS com Smart Bidding e listas de remarketing fortes
4. Negativar agressivamente nas primeiras 4 semanas (revisao semanal de search terms)
5. Manter lista de negativas mestra (gratis, curso, vagas, jovem aprendiz, salario, etc.)
6. Aplicar negativas ao nivel de conta para B2B (nunca queremos termos B2C/educacional)

4Anuncios e Extensoes (Assets)

5Estrategias de Lance

1. Fase de aprendizado (0-30 dias): Maximize Conversions sem CPA alvo
2. Apos 30 conversoes: migrar para Target CPA (definido como 70% do CPL aceitavel)
3. Apos 50 conversoes/mes: testar Maximize Conversion Value com Target ROAS
4. Brand campaigns: sempre Maximize Clicks com cap manual (CPC baixo)
5. YouTube: Target CPM ou Target CPV para awareness; Max Conversions para considera
6. Nunca mexer em estrategia automatica em janelas menores que 7 dias (quebra learning)

6Rotina de Otimizacao

7KPIs B2B Google Ads

1Funil de Vendas B2B MarkSaint

2Lead Scoring

Pontuacao automatica de 0-100 que prioriza leads por probabilidade de conversao:

3Cadencia Multicanal Padrao (15 dias)

4Scripts por Estagio - Aquecimento (TOFU/MOFU)

5Scripts por Estagio - Qualificacao (MQL → SAL)

6Scripts por Estagio - Proposta e Fechamento (SQL → Cliente)

7Nutricao de Leads Frios (sem fit imediato)

1. Tag automatica no CRM como "Nutricao · Frio"
2. Sequencia de 5 e-mails educativos (1 a cada 10 dias) com conteudo de topo de funil
3. Convite mensal para webinars / lives MarkSaint
4. Re-pontuacao automatica quando lead interage (abre 3 e-mails, clica em precos)
5. Re-engajamento humano (SDR) quando score volta ≥ 60
6. Limpeza trimestral: remover leads sem interacao em 6 meses

8Handoff e Pos-Fechamento

1. Closer atualiza CRM para "Cliente" com data de fechamento e valor
2. Disparo automatico de e-mail de boas-vindas (POP 24)
3. Reuniao interna de handoff: SDR + Closer + CS + Coordenador (15 min)
4. Onboarding agendado em ate 5 dias uteis
5. Comissao do SDR e do Closer registrada conforme regra interna
6. Lead recategorizado em "Cliente Ativo" com tag do pacote contratado

9KPIs Comerciais

1Principios Fundamentais

1. Especificidade vence verbosidade: "Resuma em 3 bullets de 15 palavras" e melhor que "Faca um resumo curto"
2. Contexto completo no system prompt: persona + tarefa + restricoes + formato — nao no user message
3. Exemplos (few-shot) sao obrigatorios: 2-3 exemplos eliminam 80% dos erros de formato
4. Saida estruturada: sempre que possivel, peca JSON com schema. JSON e mais facil de parsear e validar
5. Chain-of-thought quando faz sentido: "pense passo a passo" so para tarefas que exigem raciocinio multi-etapa
6. Instrucoes negativas explicitas: "NAO inclua markdown", "NAO use emojis", "NAO invente dados"
7. Variaveis claras: usar {{variavel}} ou <input> para destacar campos parametrizaveis
8. Limites e fallback: se o modelo nao tem dados suficientes, deve responder "INSUFICIENTE" em vez de inventar

2Frameworks de Prompt

3Tecnicas Avancadas

1. Zero-shot: apenas a instrucao, sem exemplos. Para tarefas triviais ou modelos muito capazes
2. Few-shot (k-shot): 2-5 exemplos no prompt. Melhora consistencia drasticamente
3. Chain-of-thought (CoT): instruir o modelo a "raciocinar passo a passo" antes de responder. Melhora tarefas matematicas e logicas
4. Self-consistency: rodar o prompt 3-5x e tirar a moda das respostas. Custoso mas robusto
5. ReAct (Reasoning + Acting): alternar entre raciocinio e chamada de ferramenta. Base para agentes
6. Tree of Thoughts (ToT): explorar multiplas linhas de raciocinio em paralelo. Para problemas complexos
7. Constitutional AI: fornecer principios eticos no system prompt para auto-correcao
8. Prompt chaining: dividir tarefa complexa em N prompts menores e encadear
9. Meta-prompting: prompt que gera outros prompts (LLM como prompt engineer)

4Estrutura de Prompt MarkSaint (System)

# IDENTIDADE
Voce e [PERSONA] da MarkSaint, especializado em [DOMINIO].

# TAREFA
[OBJETIVO PRINCIPAL EM 1 FRASE]

# CONTEXTO
[INFORMACOES DE NEGOCIO RELEVANTES]
- Tom de voz: [PROFISSIONAL/CONSULTIVO/TECNICO]
- Publico: [DESCRICAO DO PUBLICO-ALVO]
- Restricoes: [LGPD, brand guide, etc.]

# REGRAS
1. Nunca [X]
2. Sempre [Y]
3. Em caso de duvida: [Z]

# FORMATO DE SAIDA
[JSON SCHEMA / TEMPLATE TEXTUAL ESTRUTURADO]

# EXEMPLOS
<exemplo_1>
INPUT: [...]
OUTPUT: [...]
</exemplo_1>
<exemplo_2>
INPUT: [...]
OUTPUT: [...]
</exemplo_2>

# AUTO-VERIFICACAO
Antes de responder, verifique:
- A saida segue o formato exato?
- Todas as restricoes foram respeitadas?
- Ha alguma alucinacao ou dado inventado?

5Workflow de Desenvolvimento de Prompt

1. Definir tarefa e SLO: "X% de acerto em 50 casos de teste"
2. Construir eval set: 30-50 inputs com saida esperada conhecida
3. Escrever V1: versao baseline curta (zero-shot)
4. Rodar eval set: medir taxa de acerto, custo (tokens) e latencia
5. Identificar falhas: categorizar em formato / conteudo / alucinacao
6. Iterar (V2-V5): adicionar exemplos, restricoes, CoT — medir cada vez
7. A/B test: comparar versoes top-2 em producao com 50/50 traffic
8. Versionar: commit no git com tag (prompt-v3.2) + changelog
9. Monitorar: sample 10% das producoes para auditoria continua

6Prompt Caching e Otimizacao de Custos

7Antipatterns (NUNCA fazer)

1. Misturar instrucao com dados (sempre separar com delimitadores XML ou triple backticks)
2. Usar prompts gigantes (> 8K tokens) para tarefas simples - quebrar em chains
3. Confiar 100% em saida criativa sem revisao humana
4. Pedir saida JSON sem exemplo de schema
5. Nao versionar prompt - virar dependencia oculta do produto
6. Misturar idiomas (sistema em ingles + dados em PT) sem instruir explicitamente
7. Ignorar prompt injection: sempre sanitizar inputs do usuario
8. Nao testar com edge cases (input vazio, muito longo, malicioso)

8Biblioteca de Prompts MarkSaint (catalogo interno)

9KPIs de Engenharia de Prompts

1O que e n8n e por que MarkSaint usa

• n8n: plataforma low-code de automacao com 400+ integracoes nativas (Google, Slack, OpenAI, Notion, GitHub, etc.)
• Vantagens vs Zapier/Make: open-source, self-hostable (LGPD), JavaScript nativo nos nodes, suporte robusto a HTTP/Webhook/AI Agent
• Quando usar: automacoes B2B internas, agentes de qualificacao, classificacao, geracao de relatorios, integracoes CRM ↔ LLM
• Quando NAO usar: aplicacoes com SLA < 1s ou volumes > 1M execucoes/mes (migrar para codigo customizado)

2Setup Inicial (Self-Hosted)

1. Provisionar VPS: 2 vCPU + 4GB RAM minimo (ex.: Hetzner, DigitalOcean) - R$ 50-80/mes
2. Docker Compose: usar template oficial n8n + Postgres + Redis (queue mode)
3. Reverse proxy: Nginx + Cloudflare + SSL automatico (Let's Encrypt)
4. Backup diario: snapshot automatico do volume Postgres
5. Autenticacao: ativar basic auth + 2FA para admins
6. Monitoramento: Uptime Kuma + alerta no WhatsApp via webhook
7. Atualizacoes: rodar docker compose pull mensal apos backup

3Conceitos Fundamentais

4Caso de Uso: Agente de Qualificacao de Leads (passo a passo)

Workflow que recebe lead via formulario, enriquece dados, qualifica via LLM, registra no CRM e dispara mensagem.

1. Trigger Webhook: recebe POST do formulario do site (LP) com nome, email, empresa, telefone, mensagem
2. Validacao: node IF + regex para email valido. Se invalido, encerra com erro 400
3. Enriquecimento: node HTTP Request para Apollo.io ou Clearbit - busca cargo, tamanho da empresa, segmento
4. Lead Scoring (LLM): AI Agent Node com prompt do POP 39 - retorna score 0-100 + justificativa em JSON
5. Switch: roteamento por score
   • ≥ 60: rota "Hot" → HubSpot CRM + WhatsApp para SDR + Slack #hot-leads
   • 30-59: rota "Warm" → CRM tag "Nutricao" + adiciona em sequencia de e-mail
   • < 30: rota "Cold" → CRM tag "Frio" + arquivo
6. Resposta automatica: Set node + node Gmail/Resend - envia e-mail personalizado conforme score
7. Log: append em planilha Google Sheets para auditoria + Postgres para BI
8. Resposta ao webhook: 200 OK com payload {status:"received",score:N}

5Tratamento de Erro e Resiliencia

1. Error Workflow: configurar workflow dedicado que recebe falhas de outros workflows e notifica via Slack/WhatsApp
2. Retry on Fail: ativar retry 3x com backoff exponencial em todos os nodes HTTP
3. Timeout explicito: setar timeout em todos os HTTP Request (max 30s)
4. Try-Catch via IF: usar IF apos cada node critico para validar status code antes de prosseguir
5. Idempotencia: usar IDs unicos para evitar duplicacao em retry (ex.: hash do email + timestamp)
6. Dead Letter Queue: falhas terminais vao para tabela Postgres "failed_executions" para auditoria
7. Circuit breaker: se LLM falha > 5x em 5min, pausar workflow e alertar

6Outros Casos de Uso MarkSaint

7Boas Praticas de Engenharia n8n

1. Versionamento Git: exportar JSON do workflow e comitar em repo dedicado
2. Ambientes separados: dev / staging / producao - n8n separados ou via prefixo de tag
3. Naming convention: [CLIENTE]_[CASO]_v[N] - ex.: INDUTRON_LeadQualifier_v3
4. Documentacao no Notion: diagrama Mermaid + descricao + custos estimados + responsavel
5. Credenciais via env: nunca hardcoded - usar n8n Credentials store
6. Sub-workflows: extrair partes reutilizaveis (autenticacao, log, normalizacao) em workflows separados chamados via Execute Workflow
7. Testes: manter "Test Data" em cada trigger Webhook para regressao manual
8. Observabilidade: logar inputs+outputs em Postgres dedicado para auditoria LGPD

8Custos Tipicos de Operacao

9KPIs de Agentes em Producao