DocumentaçãoExperience PlatformGuia de destinos

Salesforce CRM conexão

Last update: Tue Nov 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador
  • Usuário

Visão geral overview

Salesforce CRM é uma plataforma popular de CRM (relacionamento com o cliente) e oferece suporte aos tipos de perfis descritos abaixo:

  • Clientes potenciais - Um cliente potencial é o nome de uma pessoa ou empresa que pode (ou não) estar interessada nos produtos ou serviços que você vende.
  • Contatos - Um contato é um indivíduo com quem um de seus representantes estabeleceu uma relação e foi qualificado como um cliente potencial.

Este Adobe Experience Platform destino aproveita o Salesforce composite API, que oferece suporte aos dois tipos de perfis descritos acima.

Ao ativar segmentos, você pode selecionar entre clientes em potencial ou contatos e atualizar atributos e dados de público-alvo para Salesforce CRM.

Salesforce CRM usa OAuth 2 com Concessão de Senha como um mecanismo de autenticação para se comunicar com a API REST do Salesforce. As instruções para autenticar na sua instância do Salesforce CRM estão mais abaixo, na seção Autenticar no destino.

Casos de uso use-cases

Como profissional de marketing, você pode fornecer experiências personalizadas aos seus usuários com base em atributos de seus perfis do Adobe Experience Platform. Você pode criar públicos-alvo com base em seus dados offline e enviá-los para o Salesforce CRM, para atualizar a associação ao CRM assim que os públicos-alvo e perfis forem atualizados no Adobe Experience Platform.

Pré-requisitos prerequisites

Pré-requisitos no Experience Platform prerequisites-in-experience-platform

Antes de ativar dados para o destino do Salesforce CRM, você deve ter um esquema, um conjunto de dados e segmentos criados em Experience Platform.

Pré-requisitos em Salesforce CRM prerequisites-destination

Observe os seguintes pré-requisitos em Salesforce CRM para exportar dados do Experience Platform para sua conta do Salesforce:

Você precisa ter uma conta Salesforce prerequisites-account

Vá para a página de Salesforce avaliação para se registrar e criar uma conta Salesforce, caso ainda não tenha uma.

Configurar um aplicativo conectado no Salesforce prerequisites-connected-app

Primeiro, você precisa configurar um Salesforce aplicativo conectado na sua conta do Salesforce, se ainda não tiver um. Salesforce CRM aproveitará o aplicativo conectado para se conectar a Salesforce.

Em seguida, habilite OAuth Settings for API Integration para o Salesforce connected app. Consulte a documentação de Salesforce para obter orientação.

Além disso, verifique se os escopos mencionados abaixo estão selecionados para o Salesforce connected app.

  • chatter_api
  • lightning
  • visualforce
  • content
  • openid
  • full
  • api
  • web
  • refresh_token
  • offline_access

Finalmente, certifique-se de que a concessão password esteja habilitada em sua conta Salesforce. Consulte a documentação do Salesforce Fluxo de Nome de Usuário-Senha do OAuth 2.0 para Cenários Especiais se precisar de orientação.

IMPORTANT
Se o administrador da sua conta do Salesforce tiver restringido o acesso a intervalos IP confiáveis, você precisará contatá-los para obter IPs do Experience Platform incluir na lista de permissões. Consulte a documentação Salesforce Restringir Acesso a Intervalos IP Confiáveis para um Aplicativo Conectado se precisar de orientação adicional.

Criar campos personalizados em Salesforce prerequisites-custom-field

Ao ativar públicos para o destino Salesforce CRM, você deve inserir um valor no campo Mapping ID para cada público ativado, na etapa Agenda de público.

Salesforce CRM exige esse valor para ler e interpretar corretamente os públicos-alvo provenientes da Experience Platform e atualizar o status dos públicos-alvo em Salesforce. Consulte a documentação do Experience Platform para Grupo de campos do esquema de Detalhes da associação do público-alvo se precisar de orientação sobre os status do público-alvo.

Para cada público-alvo ativado do Experience Platform para Salesforce CRM, é necessário criar um campo personalizado do tipo Text Area (Long) em Salesforce. Você pode definir o comprimento de caracteres de qualquer tamanho entre 256 e 131.072 caracteres de acordo com suas necessidades comerciais. Consulte a página de documentação Salesforce Tipos de campo personalizado para obter informações adicionais sobre tipos de campo personalizado. Consulte também a documentação do Salesforce para criar campos personalizados, se precisar de assistência para a criação de campos.

IMPORTANT
Não inclua caracteres de espaço em branco no nome do campo. Em vez disso, use o caractere de sublinhado (_) como separador.
Em Salesforce você deve criar campos personalizados com um Field Name que corresponda exatamente ao valor especificado em Mapping ID para cada segmento ativado do Experience Platform. Por exemplo, a captura de tela abaixo mostra um campo personalizado chamado crm_2_seg. Ao ativar um público-alvo para esse destino, adicione crm_2_seg como Mapping ID para preencher públicos-alvo do Experience Platform nesse campo personalizado.

Um exemplo de criação de campo personalizado em Salesforce, Etapa 1 - Selecionar o tipo de dados, é mostrado abaixo:
Captura de tela da interface do usuário do Salesforce mostrando a criação de campo personalizado, Etapa 1 - Selecione o tipo de dados.

Um exemplo de criação de campo personalizado em Salesforce, Etapa 2 - Inserir os detalhes do campo personalizado, é mostrado abaixo:
Captura de tela da interface do usuário do Salesforce mostrando a criação de campo personalizado, Etapa 2 - Insira os detalhes do campo personalizado.

TIP
  • Para distinguir entre campos personalizados usados para públicos-alvo da Experience Platform e outros campos personalizados no Salesforce, você pode incluir um prefixo ou sufixo reconhecível ao criar o campo personalizado. Por exemplo, em vez de test_segment, use Adobe_test_segment ou test_segment_Adobe
  • Se você já tiver outros campos personalizados criados no Salesforce, poderá usar o mesmo nome do segmento do Experience Platform para identificar facilmente o público-alvo no Salesforce.
NOTE
  • Os objetos no Salesforce são restritos a 25 campos externos, consulte Atributos de campo personalizado.
  • Essa restrição implica que você só pode ter um máximo de 25 associações de público-alvo do Experience Platform ativas a qualquer momento.
  • Se você atingiu esse limite no Salesforce, é necessário remover os atributos personalizados do Salesforce que foram usados para armazenar o status do público-alvo em relação a públicos-alvo mais antigos no Experience Platform, antes que um novo Mapping ID possa ser usado.

Obter credenciais de Salesforce CRM gather-credentials

Anote os itens abaixo antes de autenticar no destino Salesforce CRM:

Credencial
Descrição
Exemplo
Username
Seu nome de usuário da conta Salesforce.
Password
A senha da sua conta Salesforce.
Security Token
O token de segurança Salesforce que você anexará posteriormente ao final da Senha Salesforce para criar uma cadeia de caracteres concatenada a ser usada como Password ao autenticar no destino.
Consulte a documentação do Salesforce para redefinir seu token de segurança e saber como gerá-lo novamente a partir da interface do Salesforce se você não tiver o Token de Segurança.
Custom Domain
O prefixo de domínio Salesforce.
Consulte a Salesforce documentação para saber como obter este valor da interface Salesforce.
Se o domínio Salesforce for
d5i000000isb4eak-dev-ed.my.salesforce.com,
você precisará de d5i000000isb4eak-dev-ed como valor.
Client ID
Seu Salesforce Consumer Key.
Consulte a Salesforce documentação para saber como obter este valor na interface Salesforce.
Client Secret
Seu Salesforce Consumer Secret.
Consulte a Salesforce documentação para saber como obter este valor na interface Salesforce.

Medidas de proteção guardrails

Salesforce equilibra cargas de transação impondo limites de solicitação, taxa e tempo limite. Consulte Limites e alocações de solicitação de API para obter detalhes.

Se o administrador da conta do Salesforce impôs restrições de IP, será necessário adicionar endereços IP Experience Platform aos intervalos IP confiáveis das contas do Salesforce. Consulte a documentação Salesforce Restringir Acesso a Intervalos IP Confiáveis para um Aplicativo Conectado se precisar de orientação adicional.

IMPORTANT
Ao ativar segmentos, você deve selecionar entre os tipos Contato ou Cliente Potencial. É necessário garantir que seus públicos-alvo tenham o mapeamento de dados apropriado de acordo com o tipo selecionado.

Identidades suportadas supported-identities

Salesforce CRM oferece suporte à atualização de identidades descritas na tabela abaixo. Saiba mais sobre identidades.

Identidade de destino
Descrição
Considerações
SalesforceId
O identificador Salesforce CRM das identidades de contato ou cliente potencial que você exporta ou atualiza por meio do seu segmento.
Obrigatório

Tipo e frequência de exportação export-type-frequency

Consulte a tabela abaixo para obter informações sobre o tipo e a frequência da exportação de destino.

Item
Tipo
Notas
Tipo de exportação
Profile-based
  • Você está exportando todos os membros de um segmento, juntamente com os campos de esquema desejados (por exemplo: endereço de email, número de telefone, sobrenome), de acordo com o mapeamento de campos.
  • Cada status de público-alvo no Salesforce CRM é atualizado com o status de público-alvo correspondente do Experience Platform, com base no valor Mapping ID fornecido durante a etapa agendamento de público-alvo.
Frequência de exportação
Streaming
  • Os destinos de transmissão são conexões baseadas em API "sempre ativas". Assim que um perfil for atualizado no Experience Platform com base na avaliação do público-alvo, o conector enviará a atualização downstream para a plataforma de destino. Leia mais sobre destinos de streaming.

Conectar ao destino connect

IMPORTANT
Para se conectar ao destino, você precisa das View Destinations e Manage Destinations permissões de controle de acesso. Leia a visão geral do controle de acesso ou contate o administrador do produto para obter as permissões necessárias.

Para se conectar a este destino, siga as etapas descritas no tutorial de configuração de destino. No workflow de configuração de destino, preencha os campos listados nas duas seções abaixo.

Em Destinations > Catalog pesquise por Salesforce CRM. Como alternativa, você pode localizá-lo na categoria CRM.

Autenticar para o destino authenticate

Para autenticar no destino, preencha os campos obrigatórios abaixo e selecione Connect to destination. Consulte a seção Coletar Salesforce CRM credenciais para obter qualquer orientação.

Credencial
Descrição
Username
Seu nome de usuário da conta Salesforce.
Password
Uma cadeia de caracteres concatenada composta por sua senha de conta do Salesforce anexada com seu Token de Segurança do Salesforce.
O valor concatenado assume a forma de {PASSWORD}{TOKEN}.
Observação: não use chaves ou espaços.
Por exemplo, se a sua Senha do Salesforce for MyPa$$w0rd123 e o Token de Segurança do Salesforce for TOKEN12345....0000, o valor concatenado que você usará no campo Password será MyPa$$w0rd123TOKEN12345....0000.
Custom Domain
O prefixo de domínio Salesforce.
Por exemplo, se o seu domínio for d5i000000isb4eak-dev-ed.my.salesforce.com, você precisará fornecer d5i000000isb4eak-dev-ed como valor.
Client ID
Seu Salesforce conectou o aplicativo Consumer Key.
Client Secret
Seu Salesforce conectou o aplicativo Consumer Secret.

Captura de tela da interface do Experience Platform mostrando como autenticar.

Se os detalhes fornecidos forem válidos, a interface exibirá um status Connected com uma marca de seleção verde e você poderá prosseguir para a próxima etapa.

Preencher detalhes do destino destination-details

Para configurar detalhes para o destino, preencha os campos obrigatórios e opcionais abaixo. Um asterisco ao lado de um campo na interface do usuário indica que o campo é obrigatório.

  • Name: Um nome pelo qual você reconhecerá este destino no futuro.

  • Description: uma descrição que ajudará você a identificar este destino no futuro.

  • Salesforce ID Type

    • Selecione Contact se as identidades que você deseja exportar ou atualizar são do tipo Contato.
    • Selecione Lead se as identidades que você deseja exportar ou atualizar forem do tipo Lead.

Captura de tela da interface do Experience Platform mostrando os detalhes do destino.

Ativar alertas enable-alerts

Você pode ativar os alertas para receber notificações sobre o status do fluxo de dados para o seu destino. Selecione um alerta na lista para assinar e receber notificações sobre o status do seu fluxo de dados. Para obter mais informações sobre alertas, consulte o manual sobre assinatura de alertas de destinos usando a interface.

Quando terminar de fornecer detalhes da conexão de destino, selecione Next.

Ativar públicos-alvo para esse destino activate

IMPORTANT

Leia Ativar perfis e públicos-alvo para destinos de exportação de público-alvo de streaming para obter instruções sobre como ativar públicos-alvo para este destino.

Considerações e exemplo de mapeamento mapping-considerations-example

Para enviar corretamente seus dados de público-alvo do Adobe Experience Platform para o destino Salesforce CRM, é necessário passar pela etapa de mapeamento de campos. O mapeamento consiste na criação de um link entre os campos do esquema do Experience Data Model (XDM) na sua conta do Experience Platform e seus equivalentes correspondentes no destino.

Os atributos especificados em Target field devem ser nomeados exatamente como descrito na tabela de mapeamentos de atributos, pois esses atributos formarão o corpo da solicitação.

Os atributos especificados em Source field não seguem nenhuma restrição desse tipo. Você pode mapeá-los com base na sua necessidade. No entanto, verifique se o formato dos dados de entrada é válido de acordo com a Salesforce documentação. Se os dados de entrada não forem válidos, a chamada de atualização para Salesforce falhará e seus contatos/clientes potenciais não serão atualizados.

Para mapear corretamente os campos XDM para os campos de destino (API) Salesforce CRM, siga estas etapas:

  1. Na etapa Mapping, selecione Add new mapping, você verá uma nova linha de mapeamento na tela.
    Exemplo de captura de tela da interface do Experience Platform para Adicionar novo mapeamento.

  2. Na janela Select source field, escolha a categoria Select attributes e selecione o atributo XDM ou escolha a Select identity namespace e selecione uma identidade.

  3. Na janela Select target field, escolha a Select identity namespace e selecione uma identidade ou escolha a categoria Select custom attributes e selecione um atributo ou defina um usando o campo Attribute name, conforme necessário. Consulte a Salesforce CRM documentação para obter orientação sobre os atributos suportados.

    • Repita essas etapas para adicionar os seguintes mapeamentos entre o esquema de perfil XDM e o (API) Salesforce CRM:

    Trabalhando com Contatos

    • Se você estiver trabalhando com Contatos no seu segmento, consulte a Referência de Objeto no Salesforce para Contato para definir mapeamentos para os campos que serão atualizados.

    • Você pode identificar campos obrigatórios procurando a palavra Obrigatório, que é mencionada nas descrições dos campos no link acima.

    • Dependendo dos campos que deseja exportar ou atualizar, adicione mapeamentos entre o esquema de perfil XDM e (API) Salesforce CRM:

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      Campo de origem Campo de público alvo Notas
      IdentityMap: crmID Identity: SalesforceId Mandatory
      xdm: person.name.lastName Attribute: LastName Mandatory. Sobrenome do contato com até 80 caracteres.
      xdm: person.name.firstName Attribute: FirstName O nome do contato tem até 40 caracteres.
      xdm: personalEmail.address Attribute: Email O endereço de email do contato.

    • Um exemplo usando esses mapeamentos é mostrado abaixo:
      Exemplo de captura de tela da interface do Experience Platform mostrando os mapeamentos do Target.

    Trabalhando com clientes em potencial

    • Se você estiver trabalhando com clientes em potencial no seu segmento, consulte a Referência de Objeto no Salesforce para cliente em potencial para definir mapeamentos para os campos que serão atualizados.

    • Você pode identificar campos obrigatórios procurando a palavra Obrigatório, que é mencionada nas descrições dos campos no link acima.

    • Dependendo dos campos que deseja exportar ou atualizar, adicione mapeamentos entre o esquema de perfil XDM e (API) Salesforce CRM:

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      Campo de origem Campo de público alvo Notas
      IdentityMap: crmID Identity: SalesforceId Mandatory
      xdm: person.name.lastName Attribute: LastName Mandatory. Sobrenome do lead com até 80 caracteres.
      xdm: b2b.companyName Attribute: Company Mandatory. A empresa do lead.
      xdm: personalEmail.address Attribute: Email O endereço de email do lead.

    • Um exemplo usando esses mapeamentos é mostrado abaixo:
      Exemplo de captura de tela da interface do Experience Platform mostrando os mapeamentos do Target.

Quando terminar de fornecer os mapeamentos para sua conexão de destino, selecione Next.

Agendar exportação de público e exemplo schedule-segment-export-example

Ao executar a etapa Agendar exportação de público-alvo, mapeie manualmente os públicos-alvo ativados do Experience Platform para o campo personalizado correspondente em Salesforce.

Para fazer isso, selecione cada segmento e insira o nome do campo personalizado de Salesforce no campo Salesforce CRM Mapping ID. Consulte a seção Criar campos personalizados em Salesforce para obter orientação e práticas recomendadas sobre como criar campos personalizados em Salesforce.

Por exemplo, se o campo personalizado Salesforce for crm_2_seg, especifique esse valor no Salesforce CRM Mapping ID para preencher os públicos-alvo do Experience Platform nesse campo personalizado.

Um exemplo de campo personalizado de Salesforce é mostrado abaixo:
Captura de tela da interface do usuário Salesforce mostrando o campo personalizado.

Um exemplo indicando o local de Salesforce CRM Mapping ID é mostrado abaixo:
Exemplo de captura de tela da interface do Experience Platform mostrando a opção Agendar exportação de público-alvo.

Como mostrado acima, Salesforce Field Name corresponde exatamente ao valor especificado em Salesforce CRM Mapping ID.

Dependendo do seu caso de uso, todos os públicos ativados podem ser mapeados para o mesmo campo personalizado Salesforce ou para Field Name diferente em Salesforce CRM. Um exemplo típico com base na imagem mostrada acima pode ser.

Nome do segmento Salesforce CRM
Salesforce Field Name
Salesforce CRM Mapping ID
crm_1_seg
crm_1_seg
crm_1_seg
crm_2_seg
crm_2_seg
crm_2_seg

Repita esta seção para cada segmento do Experience Platform ativado.

Validar exportação de dados exported-data

Para validar se você configurou o destino corretamente, siga as etapas abaixo:

  1. Selecione Destinations > Browse para navegar até a lista de destinos.
    Captura de tela da interface do Experience Platform mostrando os Destinos de Navegação.

  2. Selecione o destino e valide se o status é enabled.
    Captura de tela da interface do Experience Platform mostrando a execução do fluxo de dados de destinos.

  3. Alterne para a guia Activation data e selecione um nome de público-alvo.
    Exemplo de captura de tela da interface do usuário do Experience Platform mostrando Dados de Ativação de Destinos.

  4. Monitore o resumo do público-alvo e verifique se a contagem de perfis corresponde à contagem criada no segmento.
    Exemplo de captura de tela da interface do Experience Platform mostrando o Segmento.

  5. Por fim, faça logon no site da Salesforce e valide se os perfis do público-alvo foram atualizados.

    Trabalhando com Contatos

    • Se você selecionou Contatos no seu segmento do Experience Platform, navegue até a página Apps > Contacts.
      Captura de tela do Salesforce CRM mostrando a página Contatos com os perfis do segmento.

    • Selecione um Contato e verifique se os campos estão atualizados. Você pode ver que cada status de público-alvo em Salesforce CRM foi atualizado com o status de público-alvo correspondente do Experience Platform, com base no valor Mapping ID fornecido durante o agendamento de público-alvo.
      Captura de tela do Salesforce CRM mostrando a página Detalhes do Contato com status de público-alvo atualizados.

    Trabalhando com clientes em potencial

    • Se você selecionou Clientes potenciais no seu segmento do Experience Platform, navegue até a página Apps > Leads.
      Captura de tela do Salesforce CRM mostrando a página de clientes potenciais com os perfis do segmento.

    • Selecione um cliente em potencial e verifique se os campos estão atualizados. Você pode ver que cada status de público-alvo em Salesforce CRM foi atualizado com o status de público-alvo correspondente do Experience Platform, com base no valor Mapping ID fornecido durante o agendamento de público-alvo.
      Captura de tela do Salesforce CRM mostrando a página Detalhes do cliente potencial com status de público atualizado.

Uso e governança de dados data-usage-governance

Todos os destinos do Adobe Experience Platform são compatíveis com as políticas de uso de dados ao manipular seus dados. Para obter informações detalhadas sobre como o Adobe Experience Platform impõe a governança de dados, consulte a visão geral da Governança de Dados.

Erros e solução de problemas errors-and-troubleshooting

Erros desconhecidos encontrados ao enviar eventos para o destino unknown-errors

  • Ao verificar uma execução de fluxo de dados, você pode encontrar a seguinte mensagem de erro: Unknown errors encountered while pushing events to the destination. Please contact the administrator and try again.
    Captura de tela da interface do Experience Platform mostrando erro.

    • Para corrigir esse erro, verifique se o Mapping ID fornecido no fluxo de trabalho de ativação para o destino Salesforce CRM corresponde exatamente ao valor do tipo de campo personalizado criado em Salesforce. Consulte a seção Criar campos personalizados em Salesforce para obter orientação.

  • Ao ativar um segmento, você pode obter uma mensagem de erro: The client's IP address is unauthorized for this account. Allowlist the client's IP address...

Recursos adicionais additional-resources

Informações adicionais úteis do portal do desenvolvedor do Salesforce estão abaixo:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6