Implantando o Marketing Cloud Next, do sandbox à produção: o que realmente funciona hoje

Se você vem da plataforma Salesforce, provavelmente espera um processo de implantação familiar. Você cria sua solução em um sandbox, testa-a minuciosamente, implanta tudo em produção usando conjuntos de alterações ou ferramentas DevOps, executa alguns testes de validação e está pronto para entrar em operação. Essa expectativa não corresponde à realidade atual do Marketing Cloud Next.

Nos últimos meses, enquanto trabalhava em várias implementações do Marketing Cloud Next e ajudava as organizações a adotar a plataforma, encontrei vários desafios de implantação que diferem significativamente do ciclo de vida de desenvolvimento tradicional do Salesforce. Muitos desses comportamentos não são documentados, são apenas parcialmente documentados ou são simplesmente inesperados para profissionais experientes do Salesforce. Este artigo resume essas descobertas.

Ele combina os problemas conhecidos publicados pela Salesforce, orientações compartilhadas diretamente pela engenharia e suporte da Salesforce e lições práticas aprendidas em várias implementações do Marketing Cloud Next. Meu objetivo é ajudar outras pessoas a evitar algumas das surpresas que encontrei e a entender melhor o que pode e o que não pode ser implantado hoje. Uma das maiores suposições que muitos arquitetos fazem é que o Marketing Cloud Next se comporta como o resto da plataforma Salesforce.

Como e-mails, páginas iniciais, formulários e fluxos residem no Salesforce, é natural presumir que todos eles podem ser implantados juntos por meio de conjuntos de alterações ou pipelines de DevOps. Infelizmente, esse não é o caso hoje. Atualmente, o Marketing Cloud Next usa vários mecanismos de implantação diferentes, dependendo do tipo de ativo.

Alguns componentes são implantados usando metadados, outros por meio de importação/exportação de CMS, enquanto outros ainda exigem recriação manual na organização de destino. Portanto, uma única jornada do cliente pode exigir diversas técnicas de implantação e, mesmo assim, nem todos os relacionamentos entre componentes são preservados automaticamente. Esta é provavelmente a maior mudança de mentalidade que as equipes precisam fazer antes de iniciar sua primeira implementação do Marketing Cloud Next.

A Salesforce já reconheceu um dos maiores desafios de implantação por meio de um problema oficial conhecido. Ao implantar componentes do Marketing Cloud Next de uma organização para outra usando conjuntos de alterações do CRM, as implantações podem ser concluídas apenas parcialmente. Embora muitos componentes de metadados sejam implantados com êxito, outros, especialmente versões de fluxo e determinados componentes do CMS, falham com erros como ID de modelo inválido ou mensagens genéricas de “Erro inesperado”.

A parte surpreendente é a solução alternativa atual fornecida pelo Salesforce: criar os ativos necessários do zero na organização de destino. Ver a “recriação manual” como a solução alternativa oficial para implantações empresariais provavelmente não é o que alguém espera de uma plataforma Salesforce. No entanto, é importante compreender esta limitação antecipadamente porque ela tem um impacto direto nos cronogramas do projeto, na estratégia de testes e no planejamento do lançamento.

Uma coisa que se tornou cada vez mais óbvia durante nossa implementação é que não existe um único processo de implantação do Marketing Cloud Next. Cada ativo CMS se comporta de maneira um pouco diferente. As imagens são o exemplo mais simples.

As imagens não têm pré-requisitos adicionais e podem ser implantadas diretamente sem considerações especiais. Se todos os componentes se comportassem como imagens, este artigo seria muito mais curto. As páginas de destino são significativamente mais complicadas.

A Salesforce confirmou que eles podem ser implantados por meio de conjuntos de alterações ou por meio da funcionalidade de importação/exportação de CMS. No entanto, nenhuma das abordagens resolve automaticamente as dependências ausentes. Antes de importar ou implantar uma landing page, todos os ativos referenciados, incluindo e-mails, formulários, fluxos e imagens, já devem existir no ambiente de destino.

Caso contrário, a publicação poderá falhar ou a página poderá não funcionar corretamente. A Salesforce também recomenda especificamente não publicar páginas de destino importadas automaticamente. Em vez disso, o conteúdo deve primeiro ser importado sem publicação, todas as dependências devem ser verificadas manualmente e só então a landing page deve ser publicada.

Essa etapa extra de validação ajuda a evitar algumas das falhas de publicação que ocorreram durante a implantação. Os formulários introduzem outra camada de complexidade porque estão intimamente ligados ao Salesforce Flows. O processo de implantação recomendado pela Salesforce começa exportando o formulário do CMS Workspace.

O próprio fluxo precisa então ser implantado separadamente usando SF CLI, implantação de metadados ou conjuntos de alterações. Depois que o Fluxo existir no ambiente de destino, o Formulário poderá ser importado. No entanto, o processo não termina aí.

Após a importação, o Formulário ainda precisa ser vinculado manualmente ao Fluxo correto antes de poder ser validado e publicado. Esse relacionamento não é restaurado automaticamente durante a implantação. Este é um detalhe importante porque demonstra um tema recorrente em todas as implantações do Marketing Cloud Next.

Mover componentes individuais é apenas parte do trabalho. Reconstruir as relações entre esses componentes é muitas vezes igualmente importante. Os fluxos devem ser um dos componentes mais fáceis de implantar.

A Salesforce recomenda implantá-los usando metadados por meio de SF CLI ou conjuntos de alterações tradicionais. Infelizmente, o problema conhecido oficial também lista as implantações do Flow entre os componentes que atualmente apresentam falhas. Alguns fluxos foram implantados com sucesso sem qualquer intervenção.

Outros falharam completamente. Em vários casos, a implantação foi tecnicamente concluída, mas as referências internas ainda apontavam para registros específicos do sandbox, tornando o fluxo inutilizável na produção até que essas referências fossem corrigidas manualmente. Como resultado, descobri que recriar manualmente certos fluxos às vezes é a abordagem mais prática.

Embora esteja longe de ser o ideal, muitas vezes pode ser mais rápido e com menor risco do que passar dias solucionando falhas de implantação, especialmente quando se trabalha com prazos de entrega apertados. A descoberta mais inesperada durante nossa implementação envolveu conteúdo dinâmico de e-mail. Depois de perceber que os e-mails importados perderam todas as variações do Conteúdo Dinâmico, inicialmente presumimos que se tratava de outro bug de implantação.

Um caso de apoio foi levantado e a resposta final surpreendeu todos os envolvidos. A Salesforce confirmou que esse comportamento está funcionando exatamente como planejado. Quando um email é exportado de uma organização e importado para outra, somente o conteúdo base do email é transferido.

Variações de conteúdo dinâmico são excluídas intencionalmente da implantação. O processo oficial de implantação após a importação de um e-mail consiste, portanto, em verificar se a fonte de dados necessária existe na organização de destino, recriar manualmente cada variação do Conteúdo Dinâmico, validar as visualizações e, finalmente, publicar o e-mail. Isso não é considerado um defeito da plataforma, é o design atual do produto.

Para um email simples contendo uma ou duas regras de personalização, isso pode levar apenas alguns minutos, mas para implementações empresariais o impacto pode ser muito maior. Talvez a lição mais importante deste projeto tenha sido como os ativos do Marketing Cloud Next estão interconectados. Ao contrário das implantações de metadados tradicionais, em que as dependências geralmente são resolvidas automaticamente, o Marketing Cloud Next atualmente espera que os próprios implementadores entendam e gerenciem muitos desses relacionamentos.

Uma implantação pode parecer bem-sucedida e ainda deixar para trás várias referências quebradas. Por causa disso, validar as dependências antes da publicação tornou-se uma das etapas mais importantes no processo de implantação. O Marketing Cloud Next está evoluindo rapidamente e introduz muitos recursos interessantes, mas sua história de implantação ainda está se atualizando.

Hoje, mover uma solução do Sandbox para a Produção não deve ser visto como uma simples implantação técnica. É um exercício de migração que requer planejamento cuidadoso, validação detalhada e, em muitos casos, reconstrução manual de partes da solução. Você deve reservar muito mais tempo para implantação do que acha que precisará.

Teste o processo de implantação no início do projeto, não apenas antes de colocá-lo em operação. Entenda qual