DocumentaçãoAEM 6.5Guia do usuário

Integração com o Salesforce integrating-with-salesforce

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador

A integração do Salesforce com o Adobe Experience Manager (AEM) fornece recursos de gerenciamento de clientes potenciais e usa os recursos existentes fornecidos prontos para uso pelo Salesforce. Você pode configurar o AEM para publicar leads no Salesforce e criar componentes que acessam dados diretamente do Salesforce.

A integração bidirecional e extensível entre o AEM e o Salesforce permite:

  • Organizações para usar e corrigir totalmente os dados e aprimorar a experiência do cliente.
  • Engajamento de marketing em atividades de vendas.
  • Organizações para transmitir e receber dados automaticamente de um armazenamento de dados do Salesforce.

Este documento descreve o seguinte:

  • como configurar o Salesforce Cloud Service (configurar o AEM para integrar com o Salesforce).
  • como usar as informações de lead/contato do Salesforce no Client Context e para o Personalization.
  • como usar o modelo de fluxo de trabalho do Salesforce para publicar usuários do AEM como clientes em potencial no Salesforce.
  • como criar um componente que mostre dados do Salesforce.

Configuração do AEM para integrar com o Salesforce configuring-aem-to-integrate-with-salesforce

Para configurar o AEM para integrar com o Salesforce, primeiro configure um aplicativo de acesso remoto no Salesforce. Em seguida, você configura o serviço de nuvem Salesforce para apontar para esse aplicativo de acesso remoto.

NOTE
Você pode criar uma conta de desenvolvedor gratuita no Salesforce.

Para configurar o AEM para integrar com o Salesforce:

CAUTION
Instale o pacote de integração da API da força do Salesforce antes de continuar com o procedimento. Para obter mais detalhes sobre como trabalhar com pacotes, consulte a página Como trabalhar com pacotes.

  1. No AEM, navegue até Cloud Service. Em Serviços de terceiros, clique em Configurar agora no Salesforce.

    chlimage_1-70

  2. Crie uma configuração, por exemplo, desenvolvedor.

    note note
    NOTE
    A nova configuração redireciona para uma nova página: http://localhost:4502/etc/cloudservices/salesforce/developer.html. Esse é exatamente o mesmo valor que você deve especificar na URL de retorno de chamada ao criar o aplicativo de acesso remoto no Salesforce. Esses valores devem corresponder a.

  3. Faça logon na sua conta do Salesforce (ou se você não tiver uma, crie uma em https://developer.salesforce.com.)

  4. No Salesforce, navegue até Criar > Aplicativos para acessar Aplicativos Conectados (nas versões anteriores do Salesforce, o fluxo de trabalho era Implantar > Acesso Remoto).

  5. Clique em Novo para conectar o AEM ao Salesforce.

    chlimage_1-71

  6. Insira o Nome do Aplicativo Conectado, Nome da API e Email de Contato. Marque a caixa de seleção Habilitar configurações do OAuth, insira a URL de retorno de chamada e adicione um escopo do OAuth (por exemplo, acesso completo). A URL de retorno é semelhante a esta: http://localhost:4502/etc/cloudservices/salesforce/developer.html

    Altere o nome do servidor/número da porta e o nome da página para corresponder à sua configuração.

    chlimage_1-72

  7. Clique em Salvar para salvar a configuração do Salesforce. O Salesforce cria uma chave do consumidor e um segredo do consumidor, que você precisa para a configuração do AEM.

    chlimage_1-73

    note note
    NOTE
    Aguarde vários minutos (até 15 minutos) para que o aplicativo de acesso remoto no Salesforce seja ativado.

  8. No AEM, navegue até Cloud Service e acesse a configuração do Salesforce que você criou anteriormente (por exemplo, desenvolvedor). Clique em Editar e insira a chave do cliente e o segredo do cliente em salesforce.com.

    chlimage_1-15

    table 0-row-2 1-row-2 2-row-2
    URL de login Este é o endpoint de autorização do Salesforce. Seu valor é pré-preenchido e serve a maioria dos casos.
    Chave do cliente Insira o valor obtido da página Registro de aplicativo de acesso remoto em salesforce.com
    Segredo do cliente Insira o valor obtido da página Registro de aplicativo de acesso remoto em salesforce.com

  9. Clique em Conectar ao Salesforce para se conectar. O Salesforce solicita que você permita que sua configuração se conecte ao Salesforce.

    chlimage_1-74

    No AEM, uma caixa de diálogo de confirmação é aberta, informando que você se conectou com êxito.

  10. Navegue até a página raiz do site e clique em Propriedades da página. Em seguida, selecione Cloud Service, adicione Salesforce e selecione a configuração correta (por exemplo, developer).

    chlimage_1-75

    Agora você pode usar o modelo de fluxo de trabalho para publicar leads no Salesforce e criar componentes que acessam dados do Salesforce.

Exportar usuários do AEM como clientes em potencial do Salesforce exporting-aem-users-as-salesforce-leads

Se quiser exportar um usuário AEM como cliente potencial do Salesforce, configure o fluxo de trabalho para publicar clientes potenciais no Salesforce.

Para exportar usuários do AEM como clientes potenciais do Salesforce:

  1. Navegue até o fluxo de trabalho do Salesforce em http://localhost:4502/workflow clicando com o botão direito do mouse no fluxo de trabalho Salesforce.com Export e clicando em Start.

    chlimage_1-76

  2. Selecione o usuário do AEM que deseja criar como cliente potencial como a Carga deste fluxo de trabalho (início > usuários). Selecione o nó de perfil do usuário, pois ele contém informações como givenName e familyName, que estão mapeadas para os campos FirstName e LastName do cliente potencial do Salesforce.

    chlimage_1-77

    note note
    NOTE
    Antes de iniciar esse fluxo de trabalho, há determinados campos obrigatórios que um nó principal no AEM deve ter antes de ser publicado no Salesforce. Estes são givenName, familyName, company e email. Para ver uma lista completa de mapeamentos entre o usuário AEM e o lead Salesforce, consulte Configuração de mapeamento entre o usuário AEM e o lead Salesforce.

  3. Clique em OK. As informações do usuário são exportadas para salesforce.com. Você pode verificá-lo em salesforce.com.

    note note
    NOTE
    Os logs de erros mostram se um cliente potencial foi importado. Verifique o log de erros para obter mais informações.

Configuração do workflow de exportação do Salesforce.com configuring-the-salesforce-com-export-workflow

Se necessário, configure o workflow de exportação do Salesforce.com para corresponder à configuração correta do Salesforce.com ou para fazer outras alterações.

Para configurar o workflow de exportação do Salesforce.com:

  1. Navegue até http://localhost:4502/cf#/etc/workflow/models/salesforce-com-export.html.

    chlimage_1-16

  2. Abra a etapa Exportação do Salesforce.com, selecione a guia Argumentos, selecione a configuração correta selecionada e clique em OK. Além disso, se você quiser que o fluxo de trabalho recrie informações privilegiadas excluídas no Salesforce, marque a caixa de seleção.

    chlimage_1-78

  3. Clique em Salvar para salvar as alterações.

    chlimage_1-79

Configuração de mapeamento entre o usuário do AEM e o líder do Salesforce mapping-configuration-between-aem-user-and-salesforce-lead

Para exibir ou editar a configuração de mapeamento atual entre um usuário AEM e um cliente potencial do Salesforce, abra o Configuration Manager: https://<hostname>:<port>/system/console/configMgr e pesquise por Configuração de mapeamento de cliente potencial do Salesforce.

  1. Abra o Configuration Manager clicando em Console da Web ou indo diretamente para https://<hostname>:<port>/system/console/configMgr.

  2. Pesquise por Configuração de mapeamento de clientes em potencial do Salesforce.

    chlimage_1-80

  3. Altere os mapeamentos, conforme necessário. O mapeamento padrão segue o padrão aemUserAttribute=sfLeadAttribute. Clique em Salvar para salvar as alterações.

Configuração do Salesforce Client Context Store configuring-salesforce-client-context-store

O armazenamento de contexto do cliente Salesforce mostra informações adicionais sobre o usuário conectado no momento além das que já estão disponíveis no AEM. Ele extrai essas informações adicionais do Salesforce dependendo da conexão do usuário com o Salesforce.

Para fazer isso, configure o seguinte:

  1. Vincule um usuário do AEM a uma ID do Salesforce por meio do componente Salesforce Connect.
  2. Adicione os Dados de perfil do Salesforce na página de contexto do cliente para que você possa configurar quais propriedades deseja ver.
  3. (Opcional) Crie um segmento que use os dados do Salesforce Client Context Store.

Vincular um usuário AEM a uma ID do Salesforce linking-an-aem-user-with-a-salesforce-id

Mapeie um usuário do AEM com uma ID do Salesforce para que você possa carregá-lo no contexto do cliente. Em um cenário real, você estaria vinculando com base em dados de usuário conhecidos com validação. Para fins de demonstração, neste procedimento, você usa o componente Salesforce Connect.

  1. Navegue até um site no AEM, entre e arraste e solte o componente Salesforce Connect do sidekick.

    note note
    NOTE
    Se o componente Salesforce Connect não estiver disponível, vá para a exibição Design e selecione-o para torná-lo disponível na exibição Editar.

    chlimage_1-17

    Ao arrastar o componente para a página, ele exibe Link to Salesforce=Off.

    chlimage_1-81

    note note
    NOTE
    Este componente é apenas para fins de demonstração. Para cenários do mundo real, haveria outro processo para vincular/combinar usuários com leads.

  2. Depois de arrastar o componente na página, abra-o para configurá-lo. Selecione a configuração, o tipo de contato e o cliente em potencial ou contato do Salesforce e clique em OK.

    chlimage_1-82

    O AEM vincula o usuário ao contato ou lead do Salesforce.

    chlimage_1-83

Adicionar dados do Salesforce ao contexto do cliente adding-salesforce-data-to-client-context

Você pode carregar dados do usuário do Salesforce no Client Context para usar na personalização:

  1. Abra o contexto de cliente que você deseja estender navegando até lá, por exemplo, http://localhost:4502/etc/clientcontext/default/content.html.

    chlimage_1-18

  2. Arraste o componente Dados de perfil do Salesforce para o contexto do cliente.

    chlimage_1-19

  3. Abra o componente clicando duas vezes nele. Selecione Adicionar item e selecione uma propriedade na lista suspensa. Adicione quantas propriedades desejar e selecione OK.

    chlimage_1-84

  4. Agora, você vê as propriedades específicas do Salesforce no Salesforce exibidas no contexto do cliente.

    chlimage_1-85

Criar um segmento usando dados do Salesforce Client Context Store building-a-segment-using-data-from-salesforce-client-context-store

Você pode criar um segmento que use dados do Salesforce Client Context Store. Para fazer isso:

  1. Navegue até a segmentação no AEM, acessando Ferramentas > Segmentação ou http://localhost:4502/miscadmin#/etc/segmentation.
  2. Crie ou atualize um segmento para incluir dados do Salesforce. Para obter mais informações, consulte Segmentação.

Pesquisar clientes em potencial searching-leads

O AEM vem com um componente de Pesquisa de amostra que pesquisa clientes potenciais no Salesforce de acordo com os critérios fornecidos. Esse componente mostra como usar a API REST do Salesforce para pesquisar objetos do Salesforce. Para acionar uma chamada para salesforce.com, vincule uma página a uma configuração do Salesforce.

NOTE
Este é um componente de exemplo que mostra como usar a API REST do Salesforce para consultar objetos do Salesforce. Use-o como exemplo para criar componentes mais complexos com base em suas necessidades.

Para usar este componente:

  1. Navegue até a página onde deseja usar essa configuração. Abra as propriedades da página e selecione Cloud Service. Clique em Adicionar serviços e selecione Salesforce e a configuração apropriada e clique em OK.

    chlimage_1-20

  2. Arraste o componente de pesquisa do Salesforce para a página (desde que tenha sido ativado). Para ativá-lo, vá para o modo Design e adicione-o à área apropriada).

    chlimage_1-21

  3. Abra o componente de Pesquisa, especifique os parâmetros de pesquisa e clique em OK.

    chlimage_1-86

  4. O AEM exibe os leads especificados no componente de pesquisa que correspondem aos critérios especificados.

    chlimage_1-87

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2