📋 Documentação de Jornadas/Campanhas - Salesforce Marketing Cloud

Instruções de uso: Utilize este prompt como template para documentar jornadas criadas no Salesforce Marketing Cloud (SFMC). Preencha cada seção com as informações da campanha em questão. Campos marcados com * são obrigatórios. Campos com [placeholder] devem ser substituídos pelo valor real.

1. IDENTIFICAÇÃO DA CAMPANHA

Campo	Valor
Nome da Campanha*	`[Ex: Campanha Retenção Clientes Inativos — Q2 2025]`
Código/ID Interno	`[Ex: MKT-2025-042]`
Solicitante/Stakeholder*	`[Nome e área — Ex: João Silva / CRM]`
Responsável Técnico (SFMC)*	`[Nome do analista/especialista]`
Data de Solicitação	`[DD/MM/AAAA]`
Data de Entrega (Go-Live)*	`[DD/MM/AAAA HH:MM]`
Data de Encerramento da Jornada	`[DD/MM/AAAA ou "Indeterminado"]`
Status*	`[Em desenvolvimento / Em aprovação / Ativo / Pausado / Encerrado]`
Versão do Documento	`[v1.0]`
Última Atualização	`[DD/MM/AAAA]`

2. OBJETIVO E BRIEFING

2.1 Objetivo da Campanha*

Descreva o objetivo estratégico da campanha. O que se espera alcançar? Qual o problema de negócio que está sendo resolvido?

[Ex: Reativar clientes que não realizaram compra nos últimos 90 dias, oferecendo
incentivo progressivo ao longo de 3 semanas via Email + SMS.]

2.2 Público-Alvo*

Descreva o perfil da audiência-alvo antes dos filtros técnicos.

[Ex: Clientes PF com histórico de compra, sem transação nos últimos 90 dias,
pertencentes às categorias Premium e Gold.]

2.3 KPIs e Metas

Indicador	Meta
Taxa de Abertura (Email)	`[Ex: ≥ 25%]`
Taxa de Clique (Email)	`[Ex: ≥ 4%]`
Taxa de Conversão	`[Ex: ≥ 2%]`
Taxa de Opt-out	`[Ex: ≤ 0.5%]`
Receita Incremental Estimada	`[Ex: R$ 150.000]`

2.4 Restrições e Regras de Negócio*

Liste regras que devem ser respeitadas na configuração da jornada.

[Ex:
- Não comunicar clientes com flag "Bloqueado para Comunicação" = TRUE
- Respeitar janela de envio: Seg–Sex, das 09h às 20h (horário de Brasília)
- Não comunicar clientes que já receberam outra campanha ativa nos últimos 7 dias
- Limite de 1 SMS por semana por cliente
]

3. REQUISITOS TÉCNICOS

3.1 Requisitos Funcionais

[Ex: Jornada deve ser entry-source baseada em DE com atualização diária]
[Ex: Aguardar 72h entre envio de Email e SMS]
[Ex: Clientes que convertem devem sair da jornada imediatamente via Goal]
[Ex: Registrar interações em DE de log para análise de resultado]

3.2 Requisitos de Integração

Sistema	Tipo de Integração	Finalidade
`[Ex: CRM Salesforce]`	`[API REST / Automation]`	`[Alimentar DE de entrada]`
`[Ex: Plataforma E-commerce]`	`[API / FTP]`	`[Sinalizar conversão para exit goal]`
`[Ex: Data Warehouse]`	`[SFTP / Automation Studio]`	`[Importar base segmentada]`

4. DATA EXTENSIONS (DEs)

4.1 DE de Entrada (Entry Source)*

Campo	Valor
Nome da DE*	`[Ex: DE_REATIVACAO_Q2_ENTRADA]`
Breadcrumb (Caminho)*	`[Ex: Data Extensions > Campanhas > Retenção > 2025 > DE_REATIVACAO_Q2_ENTRADA]`
External Key	`[Ex: de-reativacao-q2-entrada-2025]`
Tipo de Entry	`[Injeção única / Recorrente / API Event / CloudPage Event]`
Frequência de Atualização	`[Ex: Diária às 06h via Automation Studio]`
Registros na Entrada	`[Ex: ~45.000 contatos]`

Campos-chave da DE de Entrada:

Campo	Tipo	Descrição
`ContactKey`	Text(36)	Chave única do contato
`EmailAddress`	EmailAddress	E-mail do contato
`MobilePhone`	Phone	Telefone celular
`[OutroCampo]`	`[Tipo]`	`[Descrição]`

Em algumas DEs, o "Subscriberkey" é quem aparece como chave primária.

4.2 DEs de Suporte / Lookup

Nome da DE	Breadcrumb	Finalidade	External Key
`[Ex: DE_SUPRESSAO_GLOBAL]`	`[Caminho completo]`	`[Suprimir opt-outs e bloqueados]`	`[external-key]`
`[Ex: DE_CLIENTES_CONVERTIDOS]`	`[Caminho completo]`	`[Sinalizar conversão para exit goal]`	`[external-key]`
`[Ex: DE_LOG_INTERACOES]`	`[Caminho completo]`	`[Registrar eventos da jornada]`	`[external-key]`

4.3 DE de Log / Output

Campo	Valor
Nome da DE	`[Ex: DE_REATIVACAO_Q2_LOG]`
Breadcrumb	`[Ex: Data Extensions > Logs > 2025 > DE_REATIVACAO_Q2_LOG]`
Campos Registrados	`ContactKey, DataEnvio, Canal, Atividade, StatusEntrega, DataConversao`

5. SEGMENTAÇÃO E VOLUMETRIA

5.1 Filtros de Segmentação*

#	Campo	Operador	Valor	Fonte
1	`[Ex: DtUltimaCompra]`	`[É antes de]`	`[hoje - 90 dias]`	`[DE_CLIENTES_BASE]`
2	`[Ex: SegmentoCliente]`	`[Está em]`	`[Premium, Gold]`	`[DE_CLIENTES_BASE]`
3	`[Ex: FlgBloqueio]`	`[É igual a]`	`[FALSE]`	`[DE_SUPRESSAO_GLOBAL]`
4	`[Ex: OptOutEmail]`	`[É igual a]`	`[FALSE]`	`[All Subscribers]`

5.2 Lógica dos Filtros

[Ex: (Filtro 1 AND Filtro 2) AND NOT (Filtro 3 OR Filtro 4)]

5.3 Volumetria Estimada*

Etapa	Quantidade
Base total antes dos filtros	`[Ex: 180.000]`
Após filtros de segmentação	`[Ex: 52.000]`
Após supressões (opt-out, bloqueios)	`[Ex: 45.200]`
Volume final de entrada na jornada	`[Ex: 45.200]`

5.4 Query SQL (se aplicável)

-- [Nome da Query — Ex: QRY_REATIVACAO_Q2_ENTRADA]
-- Caminho: Automation Studio > Queries > Retenção > 2025
-- Última execução: DD/MM/AAAA
-- Schedule: Diário às 05:30h BRT

SELECT
    c.ContactKey,
    c.EmailAddress,
    c.MobilePhone,
    c.NomeCliente,
    c.SegmentoCliente,
    c.DtUltimaCompra
FROM [DE_CLIENTES_BASE] c
WHERE
    c.DtUltimaCompra < DATEADD(DAY, -90, GETDATE())
    AND c.SegmentoCliente IN ('Premium', 'Gold')
    AND c.FlgBloqueio = 0
    AND NOT EXISTS (
        SELECT 1 FROM [DE_SUPRESSAO_GLOBAL] s
        WHERE s.ContactKey = c.ContactKey
    )

6. JORNADA NO JOURNEY BUILDER

6.1 Identificação da Jornada*

Campo	Valor
Nome da Jornada*	`[Ex: JB_REATIVACAO_CLIENTES_Q2_2025]`
Versão Ativa	`[Ex: v3]`
Journey ID	`[Ex: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx]`
Caminho no JB	`[Ex: Journey Builder > Campanhas > Retenção > 2025]`
Entry Source*	`[Data Extension / API Event / CloudPage Event / Salesforce Data]`
Tipo de Jornada	`[Multi-step / Transacional / Engagement Split]`
Goal (Critério de Saída)	`[Ex: ContactKey presente em DE_CLIENTES_CONVERTIDOS]`
Exit Criteria	`[Ex: OptOut = TRUE ou FlgBloqueio = TRUE]`
Re-entry	`[Permitido / Não permitido — a cada X dias]`
Fuso Horário de Referência	`[Ex: America/Sao_Paulo (UTC-3)]`

6.2 Fluxo da Jornada (Mapeamento)*

Descreva o fluxo de forma sequencial. Anexe o print da jornada abaixo.

ENTRADA → [DE_REATIVACAO_Q2_ENTRADA]
    │
    ├─► [Wait] 0h (imediato)
    │
    ├─► [Email 1] "Sentimos sua falta" → Envio imediato
    │       │
    │       ├─► [Wait] 72h
    │       │
    │       └─► [Decision Split] Abriu Email 1?
    │               │
    │               ├─ SIM ──► [Wait] 24h → [Email 2] "Oferta Exclusiva"
    │               │
    │               └─ NÃO ──► [SMS 1] "Temos uma surpresa pra você"
    │                               │
    │                               └─► [Wait] 48h → [Email 2] "Oferta Exclusiva"
    │
    └─► [Goal Check] Converteu? → SIM: Sai da Jornada | NÃO: Continua

6.3 Print da Jornada*

📎 Inserir print(s) da jornada capturado(s) diretamente do Journey Builder.

[INSERIR IMAGEM AQUI — Print da jornada completa no Journey Builder]

Nomenclatura sugerida: print_jornada_[NOME-DA-CAMPANHA]_v[VERSAO].png

7. CANAIS E PEÇAS DE COMUNICAÇÃO

7.1 Visão Geral dos Canais

Canal	Quantidade de Peças	Ferramenta no SFMC
✉️ Email	`[Ex: 3]`	Email Studio / Content Builder
📱 SMS	`[Ex: 2]`	MobileConnect
💬 WhatsApp	`[Ex: 1]`	WhatsApp Business (via parceiro)
🔔 Push Notification	`[Ex: 0]`	MobilePush

7.2 E-mails

Repita o bloco abaixo para cada e-mail da jornada.

✉️ Email 1

Campo	Valor
Taxonomia / Nome da Peça*	`[Ex: EMAIL_REATIV_Q2_01_SENTIMOSSUA_FALTA_V1]`
Assunto (Subject Line)*	`[Ex: [NOME], sentimos sua falta 💙]`
Preview Text	`[Ex: Preparamos algo especial pra você voltar]`
Remetente (From Name)	`[Ex: Marca XYZ]`
From Address	`[Ex: noreply@marca.com.br]`
Reply-To	`[Ex: contato@marca.com.br]`
Caminho no Content Builder	`[Ex: Content Builder > Campanhas > Retenção > 2025 > Emails]`
Template Base	`[Ex: TPL_TRANSACIONAL_BASE_V3]`
ID da Peça (Asset ID)	`[Ex: 123456]`
UTM Campaign	`[Ex: reativacao_q2_2025]`
UTM Medium	`[email]`
UTM Content	`[Ex: email1_sentimossua_falta]`
Envio Otimizado (STO)	`[Sim / Não]`
A/B Test	`[Sim — variável testada: Assunto / Não]`
Link de CTA	`[Sim — URL: bit.ly/xxx]`

Print da Peça:

[INSERIR IMAGEM AQUI — Preview do email no Content Builder ou no navegador]

Observações:

[Ex: CTA principal direciona para landing page de reativação. Banner dinâmico
personalizado por segmento: Premium ou Gold.]

✉️ Email 2 (repetir estrutura acima)

7.3 SMS

Repita o bloco abaixo para cada SMS da jornada.

📱 SMS 1

Campo	Valor
Nome da Mensagem*	`[Ex: SMS_REATIV_Q2_01_SURPRESA_V1]`
Keyword	`[Ex: REATIV25]`
Short Code / Long Code	`[Ex: 28007]`
Caminho no MobileConnect	`[Ex: MobileConnect > Campanhas > Retenção > 2025]`
ID da Mensagem	`[Ex: 78910]`
Caracteres	`[Ex: 148 / 160]`
Possui Link Encurtado?	`[Sim — URL: bit.ly/xxx / Não]`
UTM Content	`[Ex: sms1_surpresa]`

Texto do SMS:*

[NOME], temos uma surpresa pra você! 🎁 Acesse sua oferta exclusiva:
[LINK] Para sair, responda SAIR. SAC: 0800 000 0000

📱 SMS 2 (repetir estrutura acima)

7.4 WhatsApp

Repita o bloco abaixo para cada mensagem de WhatsApp.

💬 WhatsApp 1

Campo	Valor
Nome do Template (WABA - WhatsApp Business API)*	`[Ex: reativacao_oferta_exclusiva_v1]`
ID do Template	`[Ex: 987654321]`
Status de Aprovação (Meta)	`[Aprovado / Pendente / Rejeitado]`
Categoria	`[Marketing / Utility / Authentication]`
Idioma	`[pt_BR]`
Parceiro de Envio	`[Ex: Sinch / Twilio / 360dialog]`
Número de Origem (WABA - WhatsApp Business API)	`[Ex: +55 11 9XXXX-XXXX]`
Caminho/Config no SFMC	`[Ex: Journey Builder > Activities > WhatsApp > Config_REATIV_Q2]`

Estrutura do Template:*

[CABEÇALHO — Imagem / Documento / Vídeo / Texto]
Texto do cabeçalho: [Ex: Oferta Especial para Você!]

[CORPO]
Olá, {{1}}! 👋

Notamos que faz um tempo que você não nos visita, e preparamos uma
oferta exclusiva pra te receber de volta com tudo!

🎁 *{{2}}% de desconto* na sua próxima compra.
⏰ Válido até {{3}}.

[RODAPÉ]
Para não receber mais mensagens, responda SAIR.

[BOTÕES — CTA]
→ [Acessar Oferta] (URL dinâmica)
→ [Falar com Atendimento] (Número de telefone)

Variáveis do Template:

Variável	Campo na DE	Exemplo
`{{1}}`	`NomeCliente`	`João`
`{{2}}`	`PercDesconto`	`15`
`{{3}}`	`DtVencimento`	`30/06/2025`

Print do Template:

[INSERIR IMAGEM AQUI — Print do template aprovado na plataforma Meta / parceiro]

7.5 Push Notifications

Repita o bloco abaixo para cada push da jornada.

🔔 Push 1

Campo	Valor
Nome da Mensagem*	`[Ex: PUSH_REATIV_Q2_01_OFERTA_V1]`
ID do Push*	`[Ex: push-reativ-q2-01-2025]`
App/Plataforma	`[Ex: App Marca XYZ — iOS + Android]`
Caminho no MobilePush	`[Ex: MobilePush > Campanhas > Retenção > 2025]`
Asset ID	`[Ex: 456789]`
Deep Link / URL	`[Ex: marcaxyz://oferta?id=reativ25]`

Conteúdo do Push:*

Campo	Texto
Título	`[Ex: Sentimos sua falta, [NOME]! 🎁]`
Descrição / Body	`[Ex: Uma oferta exclusiva te espera. Clique e garanta 15% OFF na sua próxima compra!]`
Rich Media (imagem/badge)	`[URL da imagem ou "Não se aplica"]`

8. AUTOMATIONS (AUTOMATION STUDIO)

Documente automações vinculadas à jornada (importações, queries, envios batch, etc.)

Nome da Automation	Caminho	Schedule	Atividades	Responsável
`[Ex: AUTO_REATIV_Q2_ENTRADA]`	`[Automation Studio > Retenção > 2025]`	`[Diário 05:30h BRT]`	`[Query → Import → Refresh DE]`	`[Nome]`
`[Ex: AUTO_REATIV_Q2_CONVERSAO]`	`[Caminho]`	`[A cada 4h]`	`[Import DE_Convertidos]`	`[Nome]`

9. APPROVALS E CONTROLE DE QUALIDADE

9.1 Checklist de QA*

Journey Builder:

Entry source configurada e testada
Goal e Exit Criteria definidos
Todos os wait times revisados
Decision splits com critérios corretos
Re-entry configurada conforme regra de negócio
Versão da jornada correta ativada

Email:

Renderização testada (mobile, desktop, dark mode)
Links e UTMs validados
Personalização (AMPscript/Handlebars) testada com dados reais
Assunto e preview text aprovados
Unsubscribe link presente e funcional
SPF/DKIM/DMARC validados

SMS:

Texto dentro do limite de caracteres
Link encurtado e rastreado validado
Opt-out funcional testado

WhatsApp:

Template aprovado pela Meta
Variáveis mapeadas corretamente
Botões com URLs/telefones corretos

Dados:

DEs populadas com dados de teste
Queries executadas e validadas
Volumetria conferida

9.2 Registro de Aprovações

Etapa	Responsável	Data	Status
Briefing / Requisitos	`[Nome]`	`[DD/MM/AAAA]`	`[✅ / ⏳ / ❌]`
Aprovação das Peças (Criação)	`[Nome]`	`[DD/MM/AAAA]`	`[✅ / ⏳ / ❌]`
Aprovação Técnica (QA SFMC)	`[Nome]`	`[DD/MM/AAAA]`	`[✅ / ⏳ / ❌]`
Aprovação Jurídica/Compliance	`[Nome]`	`[DD/MM/AAAA]`	`[✅ / ⏳ / ❌]`
Aprovação Final (Go-Live)	`[Nome]`	`[DD/MM/AAAA]`	`[✅ / ⏳ / ❌]`

10. SUPRESSÕES E COMPLIANCE

Tipo de Supressão	DE / Lista	Critério
Opt-out Global Email	`All Subscribers`	`Status = Unsubscribed`
Opt-out SMS	`[Ex: DE_OPTOUT_SMS]`	`[Campo OptOutSMS = TRUE]`
Bloqueio Comercial	`[Ex: DE_SUPRESSAO_GLOBAL]`	`[FlgBloqueio = TRUE]`
Frequência (Fadiga)	`[Ex: DE_FREQ_CONTROLE]`	`[Comunicações nos últimos 7 dias ≥ 3]`
LGPD — Sem Consentimento	`[Ex: DE_LGPD_CONSENT]`	`[ConsentMarketing = FALSE]`

11. MONITORAMENTO E RESULTADOS

11.1 Onde Acompanhar

Ferramenta	Finalidade	Caminho/Link
Journey Analytics (JB)	Métricas da jornada em tempo real	`[Journey Builder > [Nome] > Analytics]`
Email Studio Reports	Taxas de abertura, clique, bounce	`[Email Studio > Reports > Tracking]`
Intelligence Reports	Dashboard consolidado	`[Analytics Builder > Intelligence]`
`[Dashboard Interno]`	`[Resultado de negócio / conversão]`	`[URL ou caminho]`

11.2 Resultados Pós-Campanha (preencher após encerramento)

Métrica	Meta	Resultado Real
Volume enviado	`[X]`	`[ ]`
Taxa de Abertura	`[X%]`	`[ ]`
Taxa de Clique	`[X%]`	`[ ]`
Taxa de Conversão	`[X%]`	`[ ]`
Taxa de Opt-out	`[X%]`	`[ ]`
Receita Gerada	`[R$ X]`	`[ ]`

12. HISTÓRICO DE VERSÕES

Versão	Data	Autor	Alterações
v1.0	`[DD/MM/AAAA]`	`[Nome]`	Criação do documento
v1.1	`[DD/MM/AAAA]`	`[Nome]`	`[Ex: Ajuste na query de segmentação]`
v2.0	`[DD/MM/AAAA]`	`[Nome]`	`[Ex: Inclusão do canal WhatsApp]`

13. OBSERVAÇÕES GERAIS E DEPENDÊNCIAS

[Registre aqui qualquer informação relevante que não se enquadre nas seções anteriores:
dependências externas, riscos identificados, decisões tomadas com justificativas,
pontos de atenção para próximas campanhas similares, etc.]

Documento gerado por: [Nome] | [DD/MM/AAAA] | Salesforce Marketing Cloud - Documentação Técnica de Jornada

MoisesTedeschi/documentacao_jornada_mktcloud.md