DocumentaçãoCampaignDocumentação do Campaign v8

Trabalhar com o Campaign e o Microsoft Dynamics 365 crm-ms-dynamics

Last update: Tue Sep 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Iniciante
  • Intermediário
  • Administrador
  • Usuário

Ative seus dados do CRM na comunicação entre canais: saiba como transmitir contatos do Microsoft Dynamics 365 para o Adobe Campaign e compartilhar dados de desempenho da campanha (envios, aberturas, cliques e rejeições) do Adobe Campaign para o Microsoft Dynamics 365.

Quando a configuração for concluída, a sincronização de dados entre sistemas será realizada por meio de uma atividade dedicada de fluxo de trabalho. Saiba mais.

NOTE
As versões compatíveis do Microsoft Dynamics estão detalhadas na Matriz de compatibilidade do Campaign.

Siga as etapas abaixo para configurar uma conta externa dedicada para importar e exportar dados do Microsoft Dynamics 365 para o Adobe Campaign.

Para cada sistema, essas etapas precisam ser executadas por um administrador.

CAUTION
As etapas desta documentação guiarão você pela criação de integrações/registros que envolvem a atribuição de permissões e/ou acesso de administrador. É sua responsabilidade garantir que essas etapas estejam em conformidade com as políticas de sua empresa antes de executar o, e executá-las com cuidado.

Configurar o Microsoft Dynamics 365 config-crm-microsoft

Para conectar o Microsoft Dynamics 365 para trabalhar com o Adobe Campaign via API da Web, faça logon no Diretório do Microsoft Azure usando uma credencial de Administrador global e siga as etapas abaixo:

  1. Obtenha sua ID de Aplicativo (cliente) do Dynamics 365. Saiba mais
  2. Gerar o identificador de chave de certificado e a ID de chave do Microsoft Dynamics. Saiba mais
  3. Configurar permissões. Saiba mais
  4. Crie um usuário do aplicativo. Saiba mais
  5. Codifique a chave privada. Saiba mais

Obter ID do cliente do Dynamics 365 get-client-id-microsoft

Para obter a ID do aplicativo (cliente), é necessário registrar um aplicativo no Azure Ative Diretory.

  1. Navegue até Azure Ative Diretory > Registros de Aplicativo e selecione Novo Registro.
  2. Insira um nome exclusivo que possa ajudar a identificar uma instância, como adobecampaign<instance identifier>.

Depois de salvar, o Microsoft Azure Diretory atribui uma ID do Aplicativo (cliente) exclusiva ao seu aplicativo. Essa ID será necessária posteriormente na configuração do Dynamics 365 no Adobe Campaign.

Saiba mais na documentação do Microsoft Dynamics 365.

Gerar o identificador de chave de certificado e a ID de chave do Microsoft Dynamics config-certificate-key-id

Para obter o Identificador de chave de certificado (customKeyIdentifier) e a ID de chave (keyId), carregue um certificado. Os certificados podem ser usados como segredos para provar a identidade do aplicativo ao solicitar um token. Também podem ser chamadas de chaves públicas.

Siga as etapas abaixo:

  1. Navegue até Azure Ative Diretory > Registros de Aplicativo e selecione o Aplicativo que foi criado anteriormente.
  2. Selecione em Certificados e Segredo.
  3. Na guia Certificados, clique em Carregar certificado
  4. Faça upload do seu certificado público.
  5. Navegue até o link Manifesto para obter o Identificador de chave de certificado (customKeyIdentifier) e a ID de chave (keyId).

O Identificador de chave de certificado (customKeyIdentifier) e a ID de chave (keyId) são necessários no Campaign para configurar a conta externa do Microsoft Dynamics 365 CRM usando o Certificado CRM O-Auth type.

Como gerar o certificado público

Para gerar o certificado, é possível usar o openssl.

Por exemplo:

code language-none 
- openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout '<'private key name'>' -out '<'public certificate name'>
note note
NOTE
Você pode alterar o número de dias, aqui -days 365, na amostra de código para um período de validade de certificado mais longo.

Você deve então codificar o certificado em base64. Para fazer isso, você pode usar a ajuda de um codificador Base64 ou usar a linha de comando base64 -w0 private.key para Linux.

Configurar permissões config-permissions-microsoft

Etapa 1: Configurar as Permissões necessárias para o aplicativo criado.

  1. Navegue até Azure Active Directory > Registros de aplicativo e selecione o Aplicativo que foi criado anteriormente.
  2. Clique em Configurações no canto superior esquerdo.
  3. Em Permissões necessárias, clique em Adicionar e Selecionar uma API > Dynamics CRM Online.
  4. Clique em Selecionar, ative Access Dynamics 365 como usuários da organização e clique em Selecionar.
  5. Em seguida, no aplicativo, selecione o Manifesto no menu Gerenciar.
  6. No editor Manifesto, defina a propriedade allowPublicClient de null para true e clique em Salvar.

Etapa 2: Dar consentimento administrativo

  1. Navegue até Azure Ative Diretory > Aplicativos empresariais.
  2. Selecione o aplicativo para o qual deseja conceder o consentimento administrativo do locatário.
  3. No menu do painel esquerdo, selecione Permissões em Segurança.
  4. Clique em Dar consentimento administrativo.

Para obter mais informações, consulte a documentação do Azure.

Criar um usuário do aplicativo create-app-user-microsoft

NOTE
Esta etapa é opcional com autenticação Password credentials.

O usuário do aplicativo é o usuário que o aplicativo registrado acima usará. Todas as alterações feitas no Microsoft Dynamics usando o aplicativo registrado acima serão feitas por meio desse usuário.

Etapa 1: criar um usuário não interativo no Azure Active Directory

  1. Clique em Azure Ative Directory > Usuários e clique em Novo usuário.
  2. Dê um nome adequado que você deseja usar, e o nome de usuário deve ser um formato do email.
  3. Escolha Administrador do Dynamics 365 na Função de diretório.

Etapa 2: atribuir uma licença adequada ao usuário criado

  1. No Microsoft Azure, clique em Aplicativo admin.
  2. Vá para Usuários > Usuários ativos e clique no usuário recém-criado.
  3. Clique em Editar licenças de produto e selecione o Plano de Envolvimento do Cliente do Dynamics 365.
  4. Clique em Fechar.

Etapa 3: criar um usuário do aplicativo no Dynamics CRM

  1. No Microsoft Azure, navegue até Configurações > Segurança > Usuários.
  2. Clique na lista suspensa, selecione Usuários do aplicativo e clique em Novo.
  3. Use o mesmo nome de usuário que o usuário criado no ative diretory acima.
  4. Atribua o ID da aplicação para o aplicativo criado anteriormente.
  5. Clique em Gerenciar funções e escolha a função Administrador do sistema para o usuário.

Configurar o Campaign configure-acc-for-microsoft

Criar a conexão new-ms-dyn-external-account

Primeiro, você deve criar a conta externa do Microsoft Dynamics 365.

  1. Navegue pelo nó Administration > Platform > External accounts do explorador do Campaign e crie uma conta externa.

  2. Selecione a conta externa Microsoft Dynamics CRM na seção Type.

  3. Selecione o método de autenticação na lista suspensa CRM O-Auth type.

    1. Para configurar a conta externa do Microsoft Dynamics CRM para conexão com o Adobe Campaign com Credenciais de Senha, forneça os seguintes detalhes:

      • Servidor: a URL do servidor Microsoft CRM. Para localizar a URL do Servidor do Microsoft CRM, acesse sua conta do Microsoft Dynamics CRM, clique em Dynamics 365 e selecione seu aplicativo. Você pode então encontrar o URL do servidor na barra de endereços do navegador, por exemplo, https://myserver.crm.dynamics.com/.
      • Conta: conta usada para entrar no Microsoft CRM.
      • Senha: conta usada para entrar no Microsoft CRM.
      • Identificador do cliente: a ID do aplicativo (cliente) que pode ser encontrada no portal de gerenciamento do Microsoft Azure na categoria Update your code, no campo Client ID
      • Versão do CRM: escolha a versão do Dynamics CRM 365 CRM.

    2. Para configurar a conta externa do Microsoft Dynamics CRM para conexão com o Adobe Campaign com um Certificado, forneça os seguintes detalhes:

      • Servidor: a URL do servidor Microsoft CRM. Para localizar a URL do Servidor do Microsoft CRM, acesse sua conta do Microsoft Dynamics CRM, clique em Dynamics 365 e selecione seu aplicativo. Você pode então encontrar o URL do servidor na barra de endereços do navegador, por exemplo, https://myserver.crm.dynamics.com/.
      • Chave privada: copie/cole a chave privada, codificada em base64 conforme explicado em esta seção.
      • Key ID: chave disponível na guia Manifest do seu aplicativo, conforme explicado em esta seção.
      • Identificador de Chave Personalizada: Identificador disponível na guia Manifesto do seu aplicativo, conforme explicado em esta seção.
      • Identificador do cliente: a ID do aplicativo (cliente) que pode ser encontrada no portal de gerenciamento do Microsoft Azure como explicado em esta seção.
      • Versão do CRM: escolha a versão do Dynamics CRM 365 CRM.

  4. Selecione a opção Habilitar para ativar a conta no Campaign.

NOTE
Para aprovar a configuração, faça logoff e logon novamente no console do cliente do Adobe Campaign.

Selecionar tabelas para sincronizar ms-dyn-create-tables

Agora você pode configurar tabelas para sincronizar.

  1. Clique no Microsoft CRM configuration wizard….
  2. Selecione as tabelas para sincronizar e iniciar o processo.
  3. Verifique o schema gerado no Adobe Campaign no nó Administration > Configuration > Data schemas.
NOTE
Certifique-se de adicionar ao incluo na lista de permissões dois URLs: o URL do servidor e login.microsoftonline.com. Para fazer isso, entre em contato com o representante da Adobe.

Sincronize as enumerações sfdc-enum-sync

Depois que o esquema for criado, você poderá sincronizar enumerações automaticamente do Dynamics 365 para o Adobe Campaign.

  1. Abra o assistente no link Synchronizing enumerations….
  2. Selecione a enumeração do Adobe Campaign que corresponde à enumeração do Dynamics 365.
    É possível substituir todos os valores de uma lista discriminada do Adobe Campaign pelos valores do CRM: para fazer isso, selecione Yes na coluna Replace.
  3. Clique em Next e depois em Start para começar a importar as listas discriminadas.
  4. Navegue pelo nó Administration > Platform > Enumerations para verificar os valores importados.

O Adobe Campaign e o Microsoft Dynamics 365 agora estão conectados. Você pode configurar a sincronização de dados entre os dois sistemas.

Para sincronizar dados entre o Adobe Campaign e o Microsoft CRM, crie um fluxo de trabalho e use a atividade CRM connector.

Saiba mais sobre a sincronização de dados nesta página.

Tipos de dados de campo compatíveis ms-dyn-supported-types

Os tipos de atributos suportados/não suportados do Microsoft Dynamics 365 estão listados abaixo:

Tipo de atributo
Suportado
Tipos básicos: booleano, datetime, decimal, float, double, integer, bigint , string
Sim
Dinheiro (como duplo)
Sim
memo, entityname, primarykey, uniqueidentifier (como strings)
Sim
Status, lista de opções (armazenamos os valores possíveis na lista discriminada), estado (string)
Sim
proprietário (como string)
Sim
Pesquisa (somente pesquisas de referência de entidade única)
Sim
cliente
Não
Sobre
Não
PartyList
Não
ManagedProperty
Não
recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b