DocumentaçãoCampaignDocumentação do Campaign Classic v7

Conectar o Campaign e o Microsoft Dynamics 365 connect-to-msdyn

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

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 microsoft-dynamics-implementation-steps

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 enumerações
  4. Crie o fluxo de trabalho de sincronização

Saiba mais nesta seção

CAUTION
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 config-crm-microsoft

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 get-client-id-microsoft

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 config-certificate-key-id

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:

    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.

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

    note note
    NOTE
    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 configure-acc-for-microsoft

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

    note note
    NOTE
    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 assistant…. 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.

    note note
    NOTE
    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.

NOTE
Certifique-se de adicionar dois URLs à lista de permissões: o URL do servidor e login.microsoftonline.com na configuração do Servidor. Para obter mais informações sobre como configurar permissões de URL, consulte esta 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
Conjunto de opções de seleção múltipla
Não
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1