Conectando o Salesforce Marketing Cloud

O Marketing Cloud Engagement entra na Toca com jornadas, automações, campanhas, conteúdos e as data extensions da sua conta. A conexão é feita por credenciais de um Installed Package criado na própria conta — o Marketing Cloud não tem app público de terceiros, então a credencial nasce do seu lado.

Não confunda com a org Salesforce: o Marketing Cloud é outra plataforma, com outro host e outra credencial. Leads, oportunidades e casos são o card Salesforce; pedidos e catálogo da loja online, o Salesforce Commerce Cloud.

Antes de começar

• Tenha acesso de administração ao Marketing Cloud para criar o pacote: Setup › Apps › Installed Packages › New, e no pacote Add Component › API Integration › Server-to-Server.
• Copie o Client ID, o Client Secret e o subdomínio que aparece na Authentication Base URI do pacote.
• Marque no pacote as permissões de leitura de Journeys, Automations, Email, Data Extensions e Contacts — e as permissões de escrita correspondentes, se quiser aprovar alterações pelo chat. Confirme os nomes exatos na documentação oficial do Marketing Cloud.
• Se a conta tem várias Business Units, anote o MID da BU que a Toca deve consultar. O campo é opcional: vazio, vale a Business Unit em que o pacote foi instalado.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Salesforce Marketing Cloud e clique em Conectar.
3. Preencha os campos do formulário:
   • Subdomínio — aceita o subdomínio cru (ex.: mc563885gzs27c5t9) ou a URL de autenticação inteira colada do painel.
   • Client ID e Client Secret — do componente API Integration do pacote.
   • MID da Business Unit — opcional, só números.
4. Salve. O card fica marcado como conectado.

O que a Toca acessa

Leitura: jornadas do Journey Builder e o histórico de entradas de contatos, automações do Automation Studio, campanhas, conteúdos e e-mails do Content Builder, definições de e-mail e SMS transacional e as linhas das data extensions da conta.

Um limite da própria plataforma, dito com todas as letras: métricas de envio — abertura, clique, bounce, descadastro — não estão na API REST que a Toca consulta. Elas vivem nas Data Views do Marketing Cloud. O caminho é materializar uma Query Activity das Data Views numa data extension; a partir daí a Toca lê as linhas normalmente.

A Toca também sabe alterar a conta: publicar, pausar ou parar jornadas, disparar entrada de contato em jornada, mexer em automações, e-mail e SMS transacional, contatos, linhas de data extension e conteúdos. Quase tudo aqui alcança pessoas de verdade — um disparo entregue não tem desfazer —, então toda alteração passa por sua aprovação explícita, pedido a pedido, dentro do chat.

A integração foi construída a partir da documentação oficial e ainda está em validação com as primeiras contas conectadas; confira números importantes no painel do Marketing Cloud e fale com o suporte se algo não bater.

Manutenção da conexão

As credenciais do Installed Package não expiram sozinhas: a conexão vale até o pacote ser removido ou o Client Secret regenerado no Marketing Cloud, ou até você desconectar a integração na Toca. Se o secret for regenerado, reconecte com o valor novo.

Problemas comuns

• Taxa de abertura e clique não aparecem — não é falha da conexão: essas métricas ficam nas Data Views, fora da API consultada. Materialize uma Query Activity numa data extension e pergunte de novo apontando para ela.
• Os dados parecem de outra Business Unit — confira o MID no card. Vazio, a conexão lê a BU em que o pacote foi instalado.
• Erro de autenticação logo após conectar — confira se Client ID e Client Secret são do componente API Integration (Server-to-Server) e se o subdomínio corresponde à Authentication Base URI daquele pacote.
• Consultas voltam com acesso negado em um módulo específico — falta a permissão correspondente no pacote. Revise os direitos do componente e salve o pacote de novo.