Como Configurar o Typeface no Salesforce Marketing Cloud: Guia Prático de Marketing Operations para o Content Builder

Equipes de operações de marketing (Marketing Operations) em empresas multinacionais enfrentam frequentemente sérios gargalos de produtividade ao estruturar réguas de comunicação e jornadas no Salesforce Marketing Cloud (SFMC). O fluxo tradicional de criação com IA generativa exige alternâncias constantes entre plataformas externas isoladas, editores de imagens e o SFMC Content Builder: gerar copys e imagens em ferramentas de terceiros, exportar arquivos localmente, fazer upload manual no repositório do SFMC e reformatar o HTML. Esse processo fragmentado eleva o tempo de colocação no mercado (time-to-market), gera dispersão de versões e amplia os riscos de descumprimento das diretrizes de marca.

A integração nativa do Typeface ao SFMC resolve esse problema diretamente na fonte. Ao configurar um Installed Package no SFMC com um Custom Content Block e uma integração de API Server-to-Server, as equipes de marketing passam a gerar textos e elementos visuais de alta qualidade e totalmente alinhados à marca diretamente no Content Builder, salvando os ativos produzidos de forma automática na biblioteca do SFMC sem sair do editor.

Visão Geral da Arquitetura: Como o Typeface se Conecta ao SFMC

A conexão entre o Typeface e o Salesforce Marketing Cloud aproveita o modelo de extensibilidade padrão do SFMC por meio de dois componentes principais dentro de um Installed Package:

1. Componente Custom Content Block (Interface de Edição): Desenvolvido com o Content Builder Block SDK do SFMC, este widget carrega o estúdio de criação do Typeface diretamente na barra lateral de blocos do editor de e-mail através de um iFrame seguro. O componente aponta para o endpoint de produção oficial (https://sfdc-cb-prod.typeface.ai).
2. Integração de API Server-to-Server (Sincronização em Segundo Plano): Autenticada via credenciais de cliente OAuth 2.0 (Client Credentials), concede permissões de leitura e gravação (Read/Write) sobre os ativos do SFMC (Documents and Images, Saved Content). Ao concluir uma peça no bloco, o Typeface faz a gravação direta dos arquivos de imagem e dos trechos HTML no repositório de conteúdo do SFMC via REST API.

+-----------------------------------------------------------------------+
| Salesforce Marketing Cloud (Engagement)                              |
|                                                                       |
|  +-------------------+       Block SDK       +---------------------+  |
|  |  Content Builder  | <===================> |   Bloco Typeface    |  |
|  |  Canvas do E-mail |  (Comunicação iFrame) | (Widget de UI pers.)|  |
|  +-------------------+                       +----------+----------+  |
|           ^                                             |             |
|           | Ingestão automática                         | Requisição  |
|           v                                             v de geração  |
|  +-------------------+     REST API (OAuth)  +---------------------+  |
|  |  Content Builder  | <-------------------- | Plataforma Typeface |  |
|  | Repositório de SF |   Permissões Assets   |   & Brand Graph     |  |
|  +-------------------+                       +---------------------+  |
+-----------------------------------------------------------------------+

Pré-requisitos e Matriz de Permissões

Antes de iniciar a configuração técnica, certifique-se de que os seguintes requisitos foram atendidos:

Passo a Passo de Implementação

Passo 1: Criar o Installed Package no SFMC

1. Acesse o Salesforce Marketing Cloud com credenciais de administrador.
2. Clique no avatar do usuário no canto superior direito e selecione Setup.
3. No menu de navegação à esquerda, expanda Apps e clique em Installed Packages.
4. Clique no botão New no canto superior direito.
5. Defina um nome claro para o pacote, como Typeface Custom Content Block.
6. No campo de descrição, insira: Integração corporativa de IA generativa para criação de ativos no Content Builder.
7. Clique em Save.

Passo 2: Adicionar e Configurar o Custom Content Block

1. Na página de detalhes do pacote recém-criado, localize a seção Components e clique em Add Component.
2. Selecione Custom Content Block na lista de tipos de componentes e clique em Next.
3. No campo Name, digite Typeface.
4. No campo Endpoint URL, insira o endereço de produção oficial:

   https://sfdc-cb-prod.typeface.ai
   

5. Clique em Save.

Esse procedimento disponibiliza o widget do Typeface na biblioteca de blocos personalizados do Content Builder.

Passo 3: Adicionar e Configurar a API Integration (Server-to-Server)

Para habilitar o salvamento automático de imagens e blocos HTML na biblioteca do Content Builder, é necessário estabelecer uma conexão segura de API:

1. Na mesma página do pacote, clique novamente em Add Component.
2. Selecione API Integration e clique em Next.
3. Selecione o tipo de integração Server-to-Server e clique em Next.
4. Na tela de escopos de permissão (Server-to-Server Properties), role até a seção ASSETS e marque:
   • Documents and Images: Marque as opções Read e Write.
   • Saved Content: Marque as opções Read e Write.
5. Em respeito às políticas de segurança corporativa, deixe os demais escopos desmarcados.
6. Clique em Save.
7. Copie e guarde com segurança as quatro credenciais geradas pelo sistema:
   • Client Id
   • Client Secret
   • Authentication Base URI (Auth URL)
   • REST Base URI

Passo 4: Definir Licenças e Acesso por Unidade de Negócio

Para ambientes corporativos que operam com múltiplas Business Units (BUs):

1. Acesse a aba Access no Installed Package.
2. Defina o escopo de liberação:
   • Para liberar o uso corporativo global, selecione License Everyone.
   • Para restringir a determinadas marcas ou times piloto, selecione as Business Units e perfis de usuário desejados.
3. Salve as alterações.

Passo 5: Vincular as Credenciais no Typeface

1. Abra uma nova aba no navegador e faça login no Typeface com perfil de Administrador.
2. Na barra lateral de navegação, vá até Settings e selecione Connectors (ou Integrations).
3. Localize o card do Salesforce Marketing Cloud e clique em Connect.
4. Preencha os campos com os dados copiados no Passo 3:
   • Client ID
   • Client Secret
   • Authentication Base URI (exemplo: https://mcxxxxxxxx.auth.marketingcloudapis.com/)
   • REST Base URI (exemplo: https://mcxxxxxxxx.rest.marketingcloudapis.com/)
5. Clique em Verify & Connect e certifique-se de que o status indique conexão ativa com sucesso.

Rotina de Trabalho no Content Builder

Após a ativação técnica, os especialistas de marketing podem criar campanhas diretamente no editor de e-mail:

1. Inserção do Bloco Typeface

• No SFMC, acesse Email Studio > Content Builder.
• Crie um novo e-mail ou abra um modelo já existente.
• Na barra lateral esquerda, na aba de Blocks, localize a seção Custom.
• Arraste o bloco Typeface para o ponto desejado no layout.

2. Geração de Conteúdo com o Brand Graph

• Ao soltar o bloco, a interface do Typeface se abre integrada no painel lateral.
• O especialista escolhe o público-alvo ou objetivo da campanha.
• O Typeface consulta o Brand Graph corporativo (diretrizes de redação, estilo visual, produtos homologados e regras de conformidade legal).
• Por meio de instruções em linguagem natural, o sistema gera variações de títulos, textos explicativos e botões de chamada para ação (CTA).

3. Edição Visual com o Image Studio Integrado

• Sem sair do SFMC ou acionar equipes externas de design:
  • Substitua planos de fundo de produtos para adequá-los a datas comemorativas, estações do ano ou preferências regionais.
  • Adicione sobreposições tipográficas alinhadas à identidade visual.
  • Insira produtos recortados em cenários fotorrealistas gerados por IA, com luzes e sombras autênticas.

4. Salvamento Automático e Renderização

• Ao clicar em Save to Content Builder, a API REST armazena a imagem em alta definição e o bloco HTML no acervo do SFMC.
• O e-mail exibe imediatamente a peça formatada e responsiva, pronta para testes de entrega.

Escala e Personalização: Sinergia com Dynamic Content Blocks e Journey Builder

Para alcançar resultados superiores de conversão, as operações de marketing devem combinar o Typeface com os blocos dinâmicos do SFMC e os dados do Salesforce Data Cloud:

+-----------------------------------------------------------+
| Estrutura de E-mail no Marketing Cloud                    |
|                                                           |
|  +-----------------------------------------------------+  |
|  | Dynamic Content Block (Conteúdo Dinâmico)           |  |
|  |                                                     |  |
|  |   Regra 1: Região = 'Brasil'                        |  |
|  |   -> Exibe Variação Typeface A (Contexto Local)     |  |
|  |                                                     |  |
|  |   Regra 2: Região = 'América Latina (Hispânica)'   |  |
|  |   -> Exibe Variação Typeface B (Espanhol e Imagem)  |  |
|  |                                                     |  |
|  |   Regra Padrão: Demais Assinantes                   |  |
|  |   -> Exibe Ativo Institucional Global Typeface      |  |
|  +-----------------------------------------------------+  |
+-----------------------------------------------------------+

1. Geração em Massa de Variações: Crie rapidamente no Typeface diversas versões visuais e textuais direcionadas aos segmentos de clientes.
2. Mapeamento de Regras Dinâmicas: Insira um Dynamic Content Block no Content Builder e associe cada variação aos campos de dados dos assinantes (como nível de fidelidade ou categoria de interesse).
3. Orquestração no Journey Builder: Conecte o e-mail dinâmico às jornadas automatizadas do Journey Builder (comunicações de boas-vindas, reengajamento e abandono de carrinho).

Governança Corporativa e Melhores Práticas

1. Atualização Contínua do Brand Graph: Mantenha atualizadas as orientações de marca, paletas de cores e restrições regulatórias no Typeface para assegurar que as gerações de IA permaneçam precisas e atualizadas.
2. Fluxo de Aprovação no Content Builder: Combine a agilidade da IA com os recursos de aprovação (Approvals) nativos do SFMC para garantir que nenhum material seja disparado sem validação humana (Human-in-the-loop).
3. Segmentação por Business Unit: Em grupos corporativos com múltiplas marcas, utilize pacotes instalados separados ou permissões específicas de BU para evitar vazamentos de materiais e garantir a independência criativa de cada marca.
4. Fontes Seguras de Contingência: Embora as imagens geradas pelo Typeface possam exibir tipografias exclusivas da marca, o código HTML de texto precisa conter fontes de contingência seguras para web (Web-safe fonts como Arial ou Helvetica), assegurando legibilidade em clientes de e-mail rígidos como o Microsoft Outlook.

Referências

• Salesforce Marketing Cloud Now Includes Typeface | Typeface Integrations
• Salesforce Marketing Cloud New Integration - Typeface Experience for Personalized Marketing
• Salesforce Marketing Cloud - Now Build Campaigns with Typeface's AI-First Integrations
• Salesforce + Typeface: The full-loop marketing engine for Agentforce
• Agentic Marketing: Salesforce + Typeface AI Partnership
• Typeface at Dreamforce: Deep Integration with Slack, Agentforce, and DAM systems power autonomous marketing workflows
• Content Builder Block SDK | Salesforce Trailhead
• Salesforce Help