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

ATENÇÃO

Ao conectar o Adobe Campaign com o Microsoft Dynamics, não é possível:

  • Instalar plug-ins que podem alterar o comportamento do CRM, o que pode levar a problemas de compatibilidade com o Adobe Campaign
  • Selecionar várias listas discriminadas

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

OBSERVAÇÃO

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

OBSERVAÇÃO

Após a desativação do RDS da Microsoft, os tipos de implantações de CRM no local e no Office 365 não serão mais compatíveis com o Campaign. O Adobe Campaign agora só oferece suporte à implantação da API da Web para a versão do CRM Dynamic CRM 365. Saiba mais.

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.

OBSERVAÇÃO

Certifique-se de adicionar dois URLs à lista de permissões: o URL do servidor e login.microsoftonline.com na configuração do Servidor.

Tipos de dados de campo compatíveis

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

Nesta página