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

Ative seus dados de CRM na comunicação entre canais: saiba como transmitir contatos de Microsoft Dynamics 365 para o Adobe Campaign e compartilhar dados de desempenho da campanha (envios, aberturas, cliques e devoluçõ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 são detalhadas no Campaign Matriz de compatibilidade.

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 um 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 adobecpaign<instance identifier>.

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

Saiba mais em 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 a Identificador de chave de certificado (customKeyIdentifier) e a variável ID da chave (keyId), você deve carregar 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. Selecionar em Certificados e Segredo.
  3. No Certificados clique em Carregar certificado
  4. Faça upload do seu certificado público.
  5. Navegue até o Manifesto link para obter o Identificador de chave de certificado (customKeyIdentifier) e a variável ID da chave (keyId).

A variável Identificador de chave de certificado (customKeyIdentifier) e a variável ID da 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 Administration > Platform > External accounts do explorador do Campaign e criar uma conta externa.

  2. Selecionar Microsoft Dynamics CRM conta externa no Tipo seção.

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

    1. Para configurar a conta externa do Microsoft Dynamics CRM para conexão com o Adobe Campaign 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 a conta do Microsoft Dynamics CRM, clique em Dynamics 365 e selecione o 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: 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 se conectar 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 a conta do Microsoft Dynamics CRM, clique em Dynamics 365 e selecione o 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 nesta seção.
      • ID da chave: Chave disponível no Manifesto do aplicativo, conforme explicado em nesta seção.
      • Identificador de chave personalizada: Identificador disponível na Manifesto do aplicativo, conforme explicado em nesta seção.
      • Identificador do cliente: a ID do aplicativo (cliente) que pode ser encontrada no portal de gerenciamento do Microsoft Azure, conforme explicado em nesta seção.
      • Versão do CRM: escolha a versão do Dynamics CRM 365 CRM.
  4. Selecione o Ativar opção 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 em 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
Adicione 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 Synchronizing enumerations… link.
  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 Start para começar a importar as listas discriminadas.
  4. Navegue pelo Administration > Platform > Enumerations nó para verificar 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 os dados do Adobe Campaign e o Microsoft CRM, crie um fluxo de trabalho e use o CRM connector atividade.

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, duplo, 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