Configurar o Conector Microsoft Dynamics

Para conectar Microsoft Dynamics a uma base de conhecimento, você deve fornecer os parâmetros de configuração necessários para que Knowledge Hub entregue à NiCE Profissional Services ou inseri-los em Knowledge Hub você mesmo. Esta página descreve como configurar a integração de Microsoft Dynamics com Knowledge Hub. A configuração de Microsoft Dynamics envolve duas etapas:

Knowledge Hub gera e atualiza os tokens do OAuth para você. Você não precisa do Python nem de um script. Você precisa de cinco valores de Microsoft: Id DO cliente, Id DO locatário, Segredo do cliente, URL da instância e Nome do Objeto.

Complete cada uma dessas tarefas na ordem indicada.

Antes de começar

Verifique se você tem o seguinte:

  • Acesso de administrador ao centro de administração do Microsoft Entra para o locatário que hospeda Microsoft Dynamics.

  • Acesso à instância de Microsoft Dynamics que você deseja conectar.

  • Acessar o aplicativo Knowledge Hub em NiCE CXone.

  • Um entendimento básico de como os registros de aplicativo e OAuth funcionam no Microsoft Entra ID.

Registrar um Aplicativo no Microsoft Entra ID

Tudo no lado Microsoft começa aqui. Manter a ancoragem nomeada existente Registrar.

  1. Entre no Microsoft Entra admin center. Se você for redirecionado para o portal Azure, as etapas são as mesmas.

  2. Navegue até Entra ID > App registrations e selecione New registration.

  3. Digite um nome.

  4. Em tipos de conta suportados, especifique quem pode usar o aplicativo. Selecione a opção para Contas somente neste diretório de organização (locatário único).

  5. Clique em Registrar.

  6. Na página Visão geral do Aplicativo, copie o ID do aplicativo (cliente) e o ID do Diretório (locatário). Insira-os nos campos Id DO cliente e Id DO locatário em Knowledge Hub.

Configure as Configurações de Plataforma do Aplicativo

Adicione a URL de redirecionamento Knowledge Hub para que Microsoft possa retornar o código de autorização para Knowledge Hub. Manter a âncora denominada Configure existente.

  1. Ainda no centro de administração do Microsoft Entra, selecione Gerenciar > Autenticação (Visualizar).

  2. Na guia configuração de Redirect URI, clique em Add Redirect URI.

  3. Em Web applications, selecione Web.

  4. No campo Redirect URI, insira a URL de redirecionamento para a sua região. Encontre a sua em URLs de redirecionamento por Região.

  5. Clique em Configurar.

Redirecionar URLs por Região

A URL de redirecionamento é o local para onde Microsoft envia os tokens após aprovar Knowledge Hub. Ela deve corresponder à região em que o sistema NiCE CXone é executado. Encontre sua região na tabela e insira essa URL exatamente.

Copie a URL caractere por caractere. Um espaço extra, uma barra ausente ou uma URL da região errada causam um erro de incompatibilidade de redirect uri ao autenticar mais tarde.

Região

URI de redirecionamento
NA1 https://API-na1.niceincontact.com/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
NA2 https://API-na2.niceincontact.com/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
CA1 https://API-ca1.niceincontact.com/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
AU1 https://API-au1.niceincontact.com/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
AU2 https://API-au2.nicecxone-sov1.au/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
DE e EU1 https://API-eu1.niceincontact.com/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
UK1 https://API-uk1.niceincontact.com/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
UK2 hhttps://API-uk2.nicecxone-sov1.uk/eai-kh-public-services/config/v1/knowledgehub/oauth/callback
JP1 https://API-jp1.niceincontact.com/eai-kh-public-services/config/v1/knowledgehub/oauth/callback

Criar um Segredo do cliente

  1. Ainda no Microsoft Entra admin center, selecione Certificates & secrets > Client secrets > New client secret.

  2. Adicione uma descrição para o segredo do cliente.

  3. Selecione uma expiração para o segredo ou especifique um tempo de vida personalizado.

    • A vigência pode ser de até 24 meses.

    • Microsoft recomenda um prazo de expiração menor do que 12 meses.

  4. Selecione Adicionar.

  5. Copie o segredo Value e mantenha-o à mão. Você o insere no campo Segredo do cliente em Knowledge Hub. Não é necessário o Secret ID.

Microsoft exibe o valor secreto somente uma vez. Se você perdê-lo, ou quando ele expirar, crie um novo segredo do cliente e autentique novamente em Knowledge Hub. Anote a data de expiração para que você possa renová-lo a tempo.

Adicionar Permissões de API

Em seguida, adicione permissões de API ao registro do aplicativo.

  1. Ainda no Microsoft Entra admin center, selecione Manage > API permission.

  2. Clique em Adicionar uma permissão.

  3. Você precisa das seguintes permissões:

    • Permissão Dynamics CRM, com busca user _impersonation.

    • Microsoft Permissão Graph, com permissões delegadas.

Obtenha o Valor da Instância para seu Aplicativo Microsoft Dynamics

  1. Faça login em Microsoft Dynamics 365 Caixa com seta indicando navegação para site externo.. Use as credenciais que você usou ao registrar o aplicativo.

  2. Clique em Dynamics 365 Atendimento ao cliente.

  3. Copie a URL completa da barra de endereço do navegador, por exemplo, https://org25634.crm4.dynamics.com. Insira-a no campo URL da Instância em Knowledge Hub. Knowledge Hub aceita somente uma URL de instância válida.

A configuração do seu Microsoft está concluída agora. O restante do trabalho ocorre em Knowledge Hub.

Conectar Microsoft Dynamics a Knowledge Hub

Você não pode alterar as configurações após a conclusão da autenticação. Você pode editá-las somente se a criação da fonte ou a sincronização tiver falhado.

  1. Em NiCE CXone, clique no seletor de aplicativos Icon of three-by-three grid of white squares on a blue background e selecioneGeral > AI Studio > Knowledge Hub.

  2. Selecione MS Dynamics365 na lista suspensa Fonte de Conhecimento.
  3. Insira seus Microsoft Dynamics parâmetros nos campos correspondentes.
  4. Clique em Autenticar na parte inferior direita da página.
  5. Entre no Microsoft na janela que é aberta. Se solicitado, escolha a conta que você usou para registrar o aplicativo.

  6. Na página Permissões solicitadas, clique em Aceitar para conceder Knowledge Hub acesso
  7. Aguarde a janela Microsoft se fechar e a mensagem Autenticação Concluída aparecer.
  8. Clique em Salvar.
  9. The Source creation started successfully message appears, and the connector status changes to Pending. After five to seven minutes, refresh the page. Manual Sync becomes available.
    • Clique em Sincronizar ManualmenteTwo arrows forming a circle..
    • Esperar até que a sincronização termine.
    • Uma base de conhecimento grande pode levar várias horas para sincronizar. Não é necessário permanecer na página enquanto o processo é executado. Volte mais tarde e atualize para verificar o status.

  10. Quando a sincronização for concluída, o status muda para Ativo. Seus artigos Microsoft Dynamics agora estão disponíveis em Knowledge Hub.

Solução de problemas

Use a tabela a seguir para resolver problemas comuns do conector Microsoft Dynamics.

Problema

Causa possível Solução
Cliente inválido O id DO cliente ou o segredo do cliente está errado, ou ou o secreto expirou. Verifique os valores na sua inscrição de aplicativo. Se o segredo tiver expirado, crie um novo e autentique novamente.
Erro AADSTS após clicar em Autenticar O id DO locatário ou URL da instância está incorreto. Use o ID do Diretório (locatário) da página Visão geral do aplicativo e a URL completa da instância.
Incompatibilidade de URI de redirecionamento A URL de redirecionamento no Microsoft Entra ID não corresponde à sua região. Compare a URL em Microsoft Dynamics com Redirect URLs by Region. Ela deve corresponder exatamente, caractere por caractere.
Knowledge Hub não aceita a URL da Instância O URL não é um URL de instância válido. Digite o URL completo, por exemplo, https://org25634.crm4.dynamics.com.