--- title: "Salesforce Marketing Cloud" slug: "salesforce-marketing-cloud" updated: 2026-06-12T10:30:48Z published: 2026-06-12T10:30:48Z canonical: "docs.xtremepush.com/salesforce-marketing-cloud" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt > Use this file to discover all available pages before exploring further. # Salesforce Marketing Cloud Inclua mensagens Xtremepush como parte de uma jornada em múltiplas etapas no Salesforce Marketing Cloud A integração com o Salesforce Marketing Cloud permite que você crie campanhas na plataforma Xtremepush que estarão disponíveis para serem acionadas pelo Journey Builder do Salesforce Marketing Cloud. ## Etapas de configuração no Salesforce Marketing Cloud Para começar, acesse sua conta no Salesforce Marketing Cloud e navegue até **Configurações > Configurar > Apps > Pacotes Instalados** e clique em **Novo**. Dê um nome para seu pacote (por exemplo, Xtremepush) e clique **em Salvar**. Depois de concluído, você precisará adicionar dois componentes ao app: um para a Atividade do Construtor de Jornadas e outro para a integração da API. ### Criar a integração da API Clique **em Adicionar Componente**, que abrirá uma janela com os diferentes tipos de componentes e selecionará **Integração de API** como seu tipo de componente. Na próxima tela, selecione **Servidor-para-Servidor** como seu tipo de integração e clique em **Próximo**. Dê acesso de leitura na **seção de Lista de Contatos > e Assinantes** , acesse leitura e escrita pela **Extensão de Dados >** e clique **em Salvar**. ### Adicione o componente de Atividade Construtor de Jornada Após configurar a integração da API, de **Configurações > Configuração > Apps > Pacotes Instalados > aplicação Xtremepush** , clique novamente no **botão Adicionar Componente** . ![1222](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/646dc8c-Screenshot_2021-11-24_at_10.54.59(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A29%3A08Z&se=2026-11-04T10%3A29%3A08Z&sr=c&sp=r&sig=XqNQKW9zEcsV5LO3vfid07V1yixcpuDE408DdHLd5Fs%3D) Selecione **Journey Builder Activity** como seu tipo de componente e clique **em Próximo** . Dê um **nome** à sua atividade do Construtor de Jornadas, selecione **Mensagens** como Categoria e inclua a **URL do Endpoint**. Por fim, clique **em Salvar**. ![1290](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/f9fe546-Screenshot_2021-12-20_at_12.17.31(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A29%3A08Z&se=2026-11-04T10%3A29%3A08Z&sr=c&sp=r&sig=XqNQKW9zEcsV5LO3vfid07V1yixcpuDE408DdHLd5Fs%3D) > [!NOTE] > Endpoint URL > > A *URL do Endpoint* pode ser obtida nas **Configurações > Integrações > Conecte Nova página** sob o **campo Chave de Atividade** . ## Etapas de configuração no Xtremepush Depois de completar os passos acima, abra uma nova aba no seu navegador e faça login na sua conta Xtremepush. Navegue até **Integrações > Marketplace**, selecione o cartão **Cloud de Marketing Salesforce** na aba **Integrations Marketplace** e clique **em Conectar**. Você precisará configurar as seções **de Configurações de Conexão** e **Mapeamento de Dados** . ### Configurações de Conexão Você precisará recuperar os detalhes do seu aplicativo Xtremepush no seu Salesforce Marketing Cloud navegando até **Configurações > Configuração > Apps > Pacotes Instalados > aplicação Xtremepush** . Em particular, você vai precisar: - **URL da Base de Autenticação** - **URL da Base de Descanso** - **SOAP Base URL** - **ID do cliente** - **Segredo do Cliente** - **Client MID**: clique no seu nome na barra principal para encontrar seu *Client MID* - **Chave de Atividade**: encontrada na seção de Atividades do Construtor de Jornadas, onde é chamada de *Chave Única* - **JWT Token**: referido como *JWT signing secret* no Salesforce Após preencher esses dados, você precisará mapear o ContactID do Salesforce para o identificador Xtremepush. > [!NOTE] > Mapear o ContactID para o Xtremepush customer_id > > Se você quiser mapear seu ContactID para o identificador Xtremepush `customer_id` e ele não estiver ativado para o seu projeto, por favor, entre em contato com seu Gerente de Conta. Após mapear o ContatoID, você deve ir para a seção de **Mapeamento de Dados** . ### Mapeamento de dados Nesta seção, você poderá mapear o sistema Salesforce e os atributos personalizados para o sistema Xtremepush e os atributos personalizados, respectivamente. Para configurar o mapeamento, clique em **Adicionar Extensão de Dados** para abrir a lista de extensões de dados criada no seu MC do Salesforce. Escolha uma extensão de dados da lista e clique em **Aplicar**. Atributos personalizados do Salesforce para a extensão de dados selecionada são mostrados na primeira coluna. Para cada um deles, você pode opcionalmente armazenar o valor de um atributo Xtremepush, que pode ser selecionado no menu suspenso na coluna final. Os atributos , `email` e `mobile_number` do `Contact Key`Salesforce (listados nos campos **Colun**) serão automaticamente mapeados para os atributos `user_id`do sistema do Xtremepush, `email` e `mobile_number`. Você pode adicionar várias extensões de dados e fazer o mapeamento de dados de atributos para cada uma. > [!NOTE] > Criação de atributos > > Atributos do sistema são criados automaticamente no Xtremepush. No entanto, para mapear atributos personalizados, você precisa criar esses atributos primeiro no sistema Xtremepush. Revise nosso guia [de Atributos e Tags](/documentation/docs/pt-br/attributes-tags) para ver como fazer isso. > [!WARNING] > Atributos de e-mail e telefone > > Para enviar campanhas de E-mail e SMS, é necessário garantir que os atributos de e-mail e telefone da conta Salesforce estejam mapeados para o padrão `email` e `mobile_number` atributos Xtremepush. ### Mapeamento de Eventos Nesta seção, você poderá mapear os eventos do Salesforce para os eventos do Xtremepush, o que permitirá usar eventos do Xtremepush como fonte de entrada de eventos da API para jornadas do Salesforce. Para configurar o mapeamento, clique em **Adicionar Mapeamento de Evento** para abrir o modal *de evento Adicionar Salesforce* . Insira o nome do evento da API do Salesforce e a chave de definição do evento, que precisa ser recuperada do **Journey Builder > Eventos > Fontes de Entrada** no Salesforce. Depois, escolha o evento Xtremepush que você gostaria de mapear e a extensão de dados que deseja vincular a esse evento. Após configurar o mapeamento do modal, clique em **Aplicar**. Para mapear mais eventos, siga os mesmos passos. > [!WARNING] > Mapeamento de Eventos Salesforce > > Eventos da API do Salesforce precisam ser criados previamente no Salesforce para poder mapeá-los para eventos Xtremepush. Quando o mapeamento de eventos estiver concluído, clique no botão **Conectar** e sua integração será conectada com sucesso. ### Revisando e modificando uma integração existente Navegue até **Integrações > Marketplace > Integrações Configuradas > Configurações de > do Salesforce Marketing** Cloud para revisar e modificar as configurações. Se você adicionar novos atributos na sua extensão de dados no Salesforce Marketing Cloud, certifique-se de clicar no **botão Atualizar** . Isso atualizará a lista de atributos dessa extensão de dados e você poderá mapeá-la para o atributo personalizado Xtremepush apropriado da seção de Mapeamento de Dados da integração existente. ## Crie uma campanha Salesforce no Xtremepush Você pode criar uma campanha no Xtremepush que pode ser selecionada para ser acionada na janela de atividades personalizadas do Salesforce Journey Builder para o Xtremepush. No Xtremepush, navegue até **Campanhas > Criar Campanha** e escolha **Campanha de Estágio Único > campanha Salesforce** , seguindo os passos [habituais de configuração da campanha](/documentation/docs/pt-br/campaign-setup) . Você também pode adicionar seu [conteúdo dinâmico](/documentation/docs/pt-br/dynamic-programmable-content) usando um atributo do Salesforce no texto da sua mensagem, clicando no ícone **do Salesforce** e escolhendo o atributo dinâmico relacionado no menu suspenso. ![2230](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/996f20f-Screenshot_2023-03-17_at_16.18.19(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A29%3A08Z&se=2026-11-04T10%3A29%3A08Z&sr=c&sp=r&sig=XqNQKW9zEcsV5LO3vfid07V1yixcpuDE408DdHLd5Fs%3D) Neste exemplo, clique no ícone do Salesforce para puxar a lista de atributos disponíveis do Salesforce, incluindo o first_name dos usuários. ## Use o Xtremepush no seu Construtor de Jornadas Salesforce Quando você navega até o Construtor de Jornadas a partir do seu Salesforce Marketing Cloud para criar uma jornada em várias etapas, agora poderá listar a atividade das mensagens do Xtremepush na seção *Atividades* . Para escolher uma fonte de entrada, arraste-a do menu à esquerda. A atividade Xtremepush atualmente suporta Data Extension, API Event e Event (apenas Data Based Only) como fontes de entrada. ![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/dba08d5-Screenshot_2021-11-24_at_17.17.15(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A29%3A08Z&se=2026-11-04T10%3A29%3A08Z&sr=c&sp=r&sig=XqNQKW9zEcsV5LO3vfid07V1yixcpuDE408DdHLd5Fs%3D) Clique na fonte de entrada para selecioná-la entre suas fontes pré-criadas (Extensões de Dados, Eventos da API, Evento) na sua conta Salesforce Marketing Cloud. > [!WARNING] > Evento Baseado em Data > > O evento base de data (DBE) passa o ID da extensão de dados para a atividade Xtremepush somente após salvar a jornada. Por causa disso, você precisa adicionar DBE à jornada e depois salvá-la antes de adicionar a atividade Xtremepush à jornada. Caso contrário, a campanha não será acionada. Depois de selecionar a fonte de entrada, você poderá gerenciar o cronograma da viagem. ![2856](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/716cbbe-Screenshot_2021-11-30_at_12.54.32(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A29%3A08Z&se=2026-11-04T10%3A29%3A08Z&sr=c&sp=r&sig=XqNQKW9zEcsV5LO3vfid07V1yixcpuDE408DdHLd5Fs%3D) A programação da campanha é definida clicando em 'Programar'. Depois, arraste o tipo de atividade Xtremepush para a jornada a partir da **seção Atividades > Mensagens** à esquerda. ![2294](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/7fb3752-Screenshot_2021-12-20_at_12.03.01(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A29%3A08Z&se=2026-11-04T10%3A29%3A08Z&sr=c&sp=r&sig=XqNQKW9zEcsV5LO3vfid07V1yixcpuDE408DdHLd5Fs%3D) > [!TIP] > O nome que demos ao nosso componente ao configurar a integração será o nome que será mostrado na mensagem Xtremepush (neste caso, chamamos **de Xtremepush**). Clique no ícone de atividade do Xtremepush, que abrirá uma janela de dois passos. No primeiro passo (aba *de Configuração* ), você precisará selecionar a campanha que quer acionar no Xtremepush. ![1198](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/0d0fbe7-Screenshot_2021-12-20_at_12.05.03(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A29%3A08Z&se=2026-11-04T10%3A29%3A08Z&sr=c&sp=r&sig=XqNQKW9zEcsV5LO3vfid07V1yixcpuDE408DdHLd5Fs%3D) Selecione a campanha Xtremepush no menu suspenso. Clique **em Próximo** para navegar até a aba **Atributos da Extensão** e verificar quais atributos serão atualizados com essa jornada. Termine sua jornada adicionando quantos passos precisar e clique em **Ativar** assim que terminar de editar. > [!TIP] > Listar estatísticas da campanha > > Para verificar o desempenho da sua campanha, após enviar a jornada, você navega de volta para a jornada e passa o mouse sobre o ícone de atividade XP, que mostrará uma janela de 'desempenho da campanha'. Clique no **botão Expandir** para ver os detalhes sobre o desempenho da campanha. > [!WARNING] > Se você usar a mesma campanha Xtremepush em jornadas diferentes, as estatísticas da campanha mostrarão o número total de todas as jornadas. Se você quiser ver estatísticas individuais de cada jornada, precisa garantir que cada campanha Xtremepush seja usada apenas em uma jornada Salesforce. > [!WARNING] > Alteração da extensão de dados após a configuração da campanha > > Se você mudar sua extensão de dados após configurar sua campanha, deve abrir e reconfigurar cada atividade do Xtremepush dentro dessa campanha. ## Use eventos de mensagens do Xtremepush e dados de assinatura Uma vez que a campanha seja enviada no Xtremepush, os eventos de mensagens da campanha e os dados de assinatura serão enviados de volta para a Salesforce. Os dados de engajamento da campanha serão armazenados na extensão de dados **XP Message Events** , que é atualizada a cada 10 minutos. Essa extensão de dados será criada automaticamente com a integração. A extensão de dados *XP Message Events* terá as seguintes colunas: | Coluna | Descrição | | --- | --- | | `contact_key` | Identificador do contato | | `journey_id` | ID de jornada Salesforce de onde os dados relacionados ao evento estão sendo enviados | | `campaign_id` | ID de campanha Xtremepush de onde os dados de eventos relacionados estão sendo recebidos | | `event_name` | Atividade da mensagem do contato | | `event_time_utc` | Carimbo de tempo da atividade da mensagem | Os dados de status da assinatura serão armazenados na extensão de dados **XP Subscription Statuses** , que é atualizada a cada 10 minutos. Essa extensão de dados será criada automaticamente com a integração. A extensão de dados *XP Subscription Statuses* incluirá a endereçabilidade e os dados de assinatura dos contatos relacionados. Você pode ler mais sobre endereçabilidade do Xtremepush e dados de assinatura [aqui](/documentation/docs/pt-br/user-profile#channels) > [!WARNING] > Uso de dados na segmentação > > Para usar essas extensões de dados (*Eventos de Mensagens XP* e *Status de Assinatura XP*) em suas futuras campanhas, certifique-se de atribuí-las a um grupo de atributos do Construtor de Contatos no Salesforce.