Conectar o Campaign e o Microsoft Dynamics 365

Nesta página, você aprenderá a conectar o Campaign Classic ao Microsoft Dynamics CRM 365.

A possível implantação é via Web API (recomendado). Consulte esta seção abaixo para saber como configurar a conexão com o Microsoft Dynamics.

A sincronização de dados é realizada por meio de uma atividade de fluxo de trabalho dedicada. Saiba mais.

Etapas de implementação

Para conectar o Microsoft Dynamics 365 para trabalhar com o Adobe Campaign via API da Web, é necessário aplicar as seguintes etapas:

No Microsoft Dynamics CRM:

1. Obter a ID do Cliente do Microsoft Dynamics
2. Gerar o identificador de chave de certificado e a ID de chave do Microsoft Dynamics
3. Configurar permissões
4. Criar um usuário do aplicativo
5. Codificar a chave privada

Saiba mais nesta seção

No Campaign Classic:

1. Criar uma nova conta externa
2. Configurar a conta externa com as configurações do Microsoft Dynamics
3. Use o assistente de configuração para mapear tabelas e sincronizar as listas discriminadas
4. Crie o fluxo de trabalho de sincronização

Saiba mais nesta seção

Configurar o Microsoft Dynamics CRM

Para gerar o token de acesso e as chaves para configurar a conta, é necessário fazer logon no Microsoft Azure Directory usando as credenciais de Administrador global. Depois, siga as etapas descritas abaixo.

Obter a ID do Cliente do Microsoft Dynamics

Para obter a ID do cliente, é necessário registrar um aplicativo no Azure Active Directory. A ID do cliente é a mesma da ID da aplicação.

1. Navegue até Azure Active Directory > Registros de aplicativo e clique em Novo registro de aplicativo.
2. Dê um nome exclusivo que possa ajudar a identificar uma instância, como adobecampaign<instance identifier>.
3. Escolha Tipo de aplicativo como Aplicativo Web/API.
4. Use http://localhost para URL de logon.

Depois de salvar, você obtém uma ID da aplicação que é o Identificador de Cliente do Campaign.

Saiba mais nesta página.

Gerar o identificador de chave de certificado e a ID de chave do Microsoft Dynamics

Para obter o Identificador de chave de certificado (customKeyIdentifier) e o ID de chave (keyId), siga as etapas abaixo:

1. Navegue até o Azure Active Directory > Registros de aplicativo e selecione o Aplicativo que foi criado anteriormente.

2. Clique em Certificados e Segredo.

3. Clique em Fazer upload do certificado e procure e faça upload do seu certificado público gerado.

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

   Por exemplo:

   - openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout '<'private key name'>' -out '<'public certificate name'>
   

   OBSERVAÇÃO

   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.

5. Em seguida, será necessário codificá-lo 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.

6. Clique no 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) serão necessários posteriormente para configurar a conta externa do Microsoft Dynamics CRM usando o Certificado CRM O-Auth type.

Configurar permissões

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

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 active directory acima

   OBSERVAÇÃO

   O uso do mesmo nome gera um erro de chave do duplicado, portanto, até que tenhamos uma confirmação de que essa etapa é necessária, use um nome de usuário diferente e continue.

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

Para conectar o Microsoft Dynamics 365 e o Campaign, é necessário criar e configurar uma External Account dedicada no Campaign.

1. Navegue até Administration > Platform > External accounts.

2. Selecione a conta externa do Microsoft Dynamics CRM. Marque a opção Enabled.

3. Preencha as informações necessárias para conectar o Microsoft Dynamics 365 e o Campaign.

   OBSERVAÇÃO

   A configuração de Conta externa do Microsoft Dynamics CRM com cada CRM O-Auth type está detalhada nesta seção.

   

4. Clique no link Microsoft CRM configuration wizard…. O Adobe Campaign detecta automaticamente as tabelas do template de dados do Microsoft Dynamics.

   

5. Selecione as tabelas a serem recuperadas.

   

6. Clique em Next para começar a criar o esquema correspondente.

   

   OBSERVAÇÃO

   Para aprovar a configuração, você deve se desconectar/reconectar ao console do Adobe Campaign.

   Você pode verificar se o esquema de dados correspondente fica disponível no Adobe Campaign.

   

7. Clique no link Synchronizing enumerations… para começar a sincronizar enumerações entre o Adobe Campaign e o Microsoft Dynamics.

   

O Campaign e o Microsoft Dynamics agora estão conectados. Você pode configurar a sincronização de dados entre os dois sistemas. Saiba mais na seção Sincronização de dados.

Tipos de dados de campo compatíveis

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