Snippets de Engenharia.
Não é um depósito de código. Cada snippet registra propósito, nível de evidência, notas operacionais e — nos itens mais profundos — quando usar, por que funciona e onde costuma dar ruim.
Deduplicação Determinística — Registro Mais Recente
Mantenha a linha mais recente para cada identidade lógica usando ROW_NUMBER().
Anti-Join / Audiência de Exclusão
Encontre registros da população de origem que não possuem um evento ou associação qualificadora.
Versão Mais Recente por Journey
Retorne apenas o maior VersionNumber para cada JourneyID e, se necessário, exclua estados inativos.
Journey → Activity → Tracking de Email
Mapeie eventos de tracking de email de volta para nomes de Journey e atividade no Journey Builder.
Encontrar Job IDs de Atividades de Email em Journey
Resolva atividades de email do Journey Builder para seus JobID e use isso em reporting e troubleshooting.
Engajamento do Subscriber — Flags de 120 Dias
Crie flags de open/click recente e datas do último engajamento para uma audiência.
Diagnóstico de Bounces Recentes
Extraia categoria de bounce e detalhes SMTP recentes para investigação de deliverability.
Status Atual do Subscriber de Email
Leia status atual em All Subscribers, bounce count e data de unsubscribe a partir de _Subscribers.
Divisão Aleatória de Audiência com NTILE()
Divida aleatoriamente uma audiência elegível em grupos de tamanho semelhante.
Janela Incremental com Sobreposição
Reprocesse uma pequena janela de overlap para não perder silenciosamente registros que chegaram atrasados.
LookupRows() Defensivo
Trate explicitamente lookups com zero linhas antes de ler campos do rowset.
URL Dinâmica com Tracking
Monte uma URL dinâmica e preserve o click tracking do Marketing Cloud com RedirectTo().
Iterar Arrays JSON com BuildRowsetFromJson()
Converta um array JSON em rowset e itere sobre ele em AMPscript.
Parâmetros Criptografados com CloudPagesURL
Passe valores de subscriber/contexto para uma CloudPage sem expor parâmetros brutos na query string.
CloudPage — Ler e Validar Request Parameters
Leia parâmetros do request e rejeite contexto obrigatório de identidade quando estiver ausente.
Webhook HTTP POST com SSJS
Envie um payload JSON para um webhook externo a partir de uma Script Activity.
WSProxy Retrieve com Paginação
Recupere objetos SOAP além da primeira página usando RequestID / getNextBatch().
WSProxy DataExtensionObject UpdateAdd em Batch
Faça upsert em lote de linhas de Data Extension pelo modelo de objetos SOAP.
Email HTML — Shell Defensivo Mínimo
Markup base de email com viewport, metadados de dark mode e tratamento de DPI do Outlook.
Contrato de Webhook Público no n8n
Contrato simples para workflows públicos de portfólio/contato com limites de validação explícitos.
Docker Compose — Baseline de Serviço
Baseline pequeno para restart policy, health checks e separação por arquivo de ambiente.
Nunca Faça Hardcode de Secrets em Scripts SFMC
Audite Script Activities e assets do Content Builder em busca de credenciais/tokens embutidos.
Python — Normalizar Metadata Extraída
Normalize chaves inconsistentes de metadata em um schema estável antes de reporting/export.
Assistência com LLM — Restringir Saída a um Schema
Use schemas explícitos e validação quando IA auxiliar em trabalho de engenharia repetível.
ROW_NUMBER() com Desempate Determinístico
Torne a deduplicação determinística quando o timestamp principal puder empatar.
ROW_NUMBER() com Prioridade de Negócio
Escolha o registro sobrevivente primeiro pela confiança da fonte e depois pela recência.
Segundo Registro Mais Recente por Chave
Use ROW_NUMBER() como ferramenta de histórico/debug, não apenas para rn = 1.
Janela de Data SARGable
Filtre linhas recentes de Data View sem envolver a coluna de data da fonte em uma função.
Pré-agregar Tracking Antes do JOIN
Reduza o grain dos eventos antes de combinar tabelas de comportamento.
Primeiro Open Único em uma Janela
Retorne a primeira data de open único por subscriber dentro de uma janela de análise.
Último Click Único por Subscriber
Reduza o tracking de clicks a um único timestamp de engajamento mais recente por subscriber.
COALESCE() para Fallback Ordenado de Valores
Escolha o primeiro valor não nulo entre vários campos candidatos.
Segmentação de Negócio com CASE
Traduza regras explícitas de negócio para uma classificação legível por linha.
UNION ALL para Staging Multi-Fonte
Normalize múltiplas populações de origem em um único formato de staging sem deduplicar cedo demais.
Split Aproximado Rápido com Módulo de _CustomObjectKey
Use a row key oculta para segmentação aproximada e barata de uma Data Extension padrão.
TOP + ORDER BY para um Conjunto Limitado e Ordenado
Selecione uma quantidade limitada de linhas usando a sintaxe TOP do SQL Server.
Contrato Explícito de Colunas — Sem SELECT *
Promova queries de produção com colunas de saída explícitas em vez de SELECT *.
Faça Staging Antes de um Add/Update Grande
Mova a transformação cara para uma DE intermediária em Overwrite antes de uma escrita grande em Add/Update.
Status do Último Run por Automation
Retorne o último run conhecido do Automation Studio para cada AutomationCustomerKey.
Falhas / Skips de Automation nas Últimas 24h
Exponha runs recentes não saudáveis do Automation Studio com o primeiro detalhe de erro.
Runtime & Erros por Atividade de Automation
Meça runtime médio e quantidade de falhas por activity key.
Query Activities Caminhando para Timeout
Encontre Query Activities cujo runtime médio já entrou na zona de risco.
Tracking de SMS por Versão da Journey
Mapeie registros de SMS enviados pela Journey para a versão via JBDefinitionID.
Opt-Outs Recentes do MobileConnect
Revise opt-outs de SMS recentes sem assumir que toda linha terá SubscriberKey.
Números Mobile Held / Undeliverable
Inspecione números MobileConnect que foram colocados em hold após falhas repetidas de entrega.
Concentração de Bounce por Domínio & Categoria
Agregue evidência recente de bounce antes de decidir se o problema é do destinatário, específico de domínio ou mais amplo.
Revisar Estado Held / Bounced de Subscribers
Inspecione status atual em All Subscribers e bounce count de registros não ativos.
AttributeValue() Defensivo + Fallback com Empty()
Leia um atributo do contexto de envio sem assumir que o campo sempre existe ou tem valor.
LookupOrderedRows() Limitado
Recupere um rowset pequeno e ordenado em vez de varrer relacionamento one-to-many ilimitado em render-time.
RaiseError() para Destinatário Quebrado, Não para Segmentação
Aborte apenas o destinatário atual quando uma invariável real de renderização for violada.
CloudPagesURL() com Parâmetros Criptografados
Passe contexto do cliente do email para uma CloudPage usando o tratamento criptografado de query string da Salesforce.
Validar Request Parameters Antes de Writes em CloudPage
Coloque lógica que altera estado atrás de validação explícita de input e registro.
Upsert em CloudPage em Vez de Insert Cego
Use uma chave estável para que refresh/retry não acrescente cegamente linhas duplicadas de estado.
WSProxy Retrieve — Todas as Páginas
Recupere todas as páginas de um objeto SOAP via WSProxy em vez de parar silenciosamente no primeiro batch.
Inspecionar Resultados de WSProxy updateBatch()
Trate o resultado do batch como dado a validar em vez de assumir que “sem exception” significa que todas as linhas funcionaram.
Padrão de Cache de OAuth Token
Reutilize access tokens do Marketing Cloud em vez de criar um token para cada chamada de API.
429 + Retry-After com Exponential Backoff
Reduza a pressão quando o SFMC aplicar rate limit em uma rota em vez de martelar com retries imediatos.
Sends de Email da Journey nas Últimas 24 Horas
Veja sends recentes de email da Journey com contexto de Journey/versão/atividade.
Regressão de Runtime de Automation — Atual vs Média de 30 Dias
Compare a duração mais recente de cada automation com a média recente para encontrar fluxos que ainda completam, mas estão degradando.
Docker Compose Healthcheck — Diferenciar “Subiu” de “Está Pronto”
Exponha readiness do serviço em vez de assumir que container iniciado significa aplicação utilizável.
Docker Compose — Volume Persistente Explícito
Faça o estado sobreviver à recriação do container declarando storage fora da camada gravável efêmera.
Unit systemd para Stack Docker Compose
Suba uma stack self-hosted após o boot e desligue de forma controlada junto com o host.
n8n Webhook — Envelope de Erro Estável
Retorne respostas previsíveis de sucesso/erro para o caller diferenciar input aceito de falha interna do workflow.
Validação HMAC de Webhook — Padrão Canônico
Valide que o body recebido foi assinado pelo emissor esperado antes de processar efeitos colaterais.
Carregar Secrets por Ambiente — Fora do Git
Leia secrets em runtime por ambiente/configuração em vez de embutir credenciais no código versionado.
Python — Diff Simples de Schema entre Snapshots
Compare dicionários normalizados para identificar chaves adicionadas, removidas ou alteradas entre exports.
Review com LLM — Contexto Delimitado + Proveniência
Restrinja o review de IA ao contexto fornecido e exija separação explícita entre fatos documentados, observação e inferência.