Partilhar via


Código de exemplo para integração de softphone usando o Dynamics 365 Channel Integration Framework 2.0

Baixe o exemplo de integração de softphone para o Microsoft Dynamics 365 Channel Integration Framework versão 2.0.

Observação

O código de exemplo não é suportado no Internet Explorer e navegadores que não têm suporte a webRTC. Saiba mais em WebRTC

Pré-requisitos

  • Omnichannel para Atendimento ao Cliente do Dynamics 365.

  • É necessária uma subscrição válida do Azure para publicar a aplicação de exemplo no Azure.

    Observação

    Se não tiver uma subscrição do Azure, pode criar uma conta gratuita.

Publicar um aplicativo de exemplo no Azure

  1. Abra SampleInteg.sln usando o Visual Studio 2017.

  2. No Gerenciador de Soluções, clique com o botão direito do mouse na solução e crie a solução completa.

  3. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto SampleInteg e selecione Publicar.

  4. Selecione Iniciar para iniciar o assistente de publicação .

  5. Escolha Serviço de Aplicativo como o destino de publicação.

  6. Selecione Criar novo e, em seguida, selecione Publicar.

  7. Forneça um nome de aplicativo. Por exemplo, SampleInteg.

  8. Forneça detalhes válidos de assinatura, grupo de recursos e plano de hospedagem.

  9. Selecione Criar para criar o serviço de aplicativo do Azure e salve a URL do serviço de aplicativo para uso futuro.

    Por exemplo, https://sampleinteg.azurewebsites.net.

    Selecione Criar para publicar aplicativo no Azure.

Criar função para usar com o serviço de aplicativo

  1. Crie um código de exemplo para a função client-voice .
    Consulte a função do arquivo readme empacotado com a integração de softphone de exemplo no Dynamics 365 Insider Portal.

  2. Use o código de exemplo para a função capability-token.
    Consulte a função do arquivo readme empacotado com a integração de softphone de exemplo no Dynamics 365 Insider Portal.

Observação

Guarde o URL para a função token de capacidade que obtém do código de amostra. Por exemplo, o URL é https://sampleinteg.sample/capability-token.

Configurar aplicativo de exemplo no Dynamics 365

  1. Observe a URL base da organização do Dynamics 365 de onde todos os recursos da Web são armazenados. Para uma organização online, o URL deve estar no formato, https://<orgname>.crmXX.dynamics.com. Por exemplo: https://sampleorg.crm10.dynamics.com

  2. Obtenha a solução Dynamics 365 Channel Integration Framework . Para obter mais informações, consulte Obter o Dynamics 365 Channel Integration Framework.

  3. Configure o provedor de canal fornecendo os detalhes conforme mostrado na matriz. Para obter mais informações, consulte Configurar o provedor de canal.

    Campo Description
    Nome Nome do fornecedor de canais.

    Exemplo: Contoso
    Unique Name Um identificador exclusivo no formato <prefixo>_<nome>.
    IMPORTANTE: São necessários os seguintes para o nome exclusivo:
    • O prefixo só pode ser alfanumérico e o seu comprimento deve ter entre 3 a 8 caracteres.
    • Um sublinhado deve estar lá entre o prefixo e o nome
    Etiqueta A etiqueta é apresentada como o título no widget.

    Exemplo: Contoso
    URL do Canal O URL do canal está no formato: <azure_app_service_url>?base=<crm_base_url>

    Observação: Para este exemplo, a URL é https://sampleinteg.azurewebsites.net?base=https://sampleorg.crm10.dynamics.com.
    Ativar Comunicação de Saída Yes
    Ordem do Canal 0
    Versão da API 2.0
    Domínios Fidedignos O domínio (URL) que pode acessar as APIs do Channel Integration Framework.
    Selecionar as Aplicações da Interface Unificada para o Canal A lista de aplicativos de Interface Unificada onde o canal é exibido para os representantes de atendimento ao cliente.
    Selecionar Funções para o Canal As funções de segurança presentes no Dynamics 365.
    Observação: Se você não atribuir nenhuma função, o provedor de canal será mostrado a todos os usuários atribuídos para o aplicativo Interface Unificada do Dynamics 365.
  4. Inicie o aplicativo Interface Unificada para ver o widget de comunicação no lado esquerdo.

Importante

  • Todos os URLs devem ser HTTPS.
  • Se você usar um certificado autoassinado para o aplicativo do Azure ou a organização do Dynamics 365, alguns navegadores poderão rejeitar a conexão e falhar ao carregar o telefone de exemplo. Como solução alternativa, abra o aplicativo do Azure em uma guia separada e aceite o certificado uma vez.
  • Verifique se o acesso ao microfone e ao alto-falante não está bloqueado pela política do navegador.

Importar dados de configuração

  1. Baixe a ferramenta de migração de configuração. A ferramenta de migração de configuração está disponível como um pacote NuGet.

  2. Inicie a ferramenta de migração de configuração. Clique duas vezes em DataMigrationUtility.exe na pasta: [your folder]\Tools\ConfigurationMigration\.

  3. No ecrã principal, selecione Importar dados e, em seguida, selecione Continuar.

  4. Na tela de entrada, forneça detalhes de autenticação para se conectar à sua instância do Dynamics 365 de onde você deseja importar dados. Se você tiver várias organizações no servidor do Dynamics 365 e quiser selecionar a organização para a qual importar os dados de configuração, marque a caixa de seleção Sempre exibir lista de organizações disponíveis . Selecione Iniciar sessão.

  5. Se você tiver várias organizações e marcar a caixa de seleção Sempre exibir lista de organizações disponíveis , a próxima tela permitirá que você escolha a organização à qual deseja se conectar. Selecione uma organização de aplicativos do Dynamics 365.

  6. Forneça o arquivo de dados (data.zip) a ser importado. Navegue até o arquivo de dados e selecione-o. Selecione Importar dados.

  7. Esta etapa é aplicável somente se os dados que você está importando contiverem as informações do usuário do sistema de origem. Insira as informações do usuário de mapeamento no sistema de destino. Você pode mapear todos eles para o usuário que está executando o processo de importação ou mapear para usuários individuais usando um arquivo de mapa do usuário (.xml). Se você escolher o último, você tem que especificar um arquivo de mapa de usuário existente ou a ferramenta pode gerá-lo para você. Se você gerar um novo arquivo, preencha o nome de usuário de mapeamento no parâmetro New para cada usuário no servidor de origem. Selecione o arquivo de mapa do usuário na ferramenta quando terminar e selecione OK.

  8. A próxima tela exibe o status de importação de seus registros. A importação de dados é efetuada em várias passagens primeiro para importar os dados de fundação enquanto coloca em fila os dados dependentes e, em seguida, importando os dados dependentes nas passagens subsequentes para processar as dependências ou enlaces de dados. Isso garante uma importação de dados limpa e consistente.

  9. Selecione Concluir para fechar a ferramenta.

Obter a Estrutura de Integração de Canais do Dynamics 365