Criar um conector CTI
Publicado: novembro de 2016
Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2013, Dynamics CRM 2015, Dynamics CRM 2016
O componente Conector CTI em seu adaptador CTI contém a lógica para conectar e comunicar com um sistema CTI externo. O Conector CTI consiste na interface do ICtiControl, que inclui a classe CtiHostedControl contém os métodos e eventos que serão chamados ouvidos pelo componente CTI Desktop Manager.
O Conector CTI oferece suporte a dois modelos de interação com sistemas de CTI:
O primeiro modelo é um sistema de sondagem com base no serviço. Neste modelo, o desenvolvedor define uma conexão de serviço para uma origem de interação de CTI ascendente e sonda essa origem para atualizações e eventos. Esse modelo é preferido para origens de CTI que fornecem acesso aos eventos e às ações de CTI via serviços da Web. Neste modelo, a consideração deve ser fornecida a um modelo de threading apropriado para suportar comunicações assíncronas com o serviço Web de CTI ascendente.
O segundo modelo usa um objeto instanciado ou estático que usa um retorno ou sistema de notificação de evento. Este modelo é preferido para origens de CTI que fornecem uma API. Como no modelo de sondagem, a consideração deve ser fornecida para oferecer suporte assíncrono, por meio de thread, para evitar um impacto em Unified Service Desk.
A estrutura de CTI de UII oferece suporte a uma única instância do componente Conector CTI.
Neste tópico
Defina o conector de CTI
Configurar um controle hospedado para o Conector de CTI no Unified Service Desk
Defina o conector de CTI
O Conector CTI implementa a interface ICtiControl. Para definir um Conector CTI, use o modelo do projeto de Dynamics 365 SDK de Microsoft Visual Studio em uma das seguintes maneiras:
Baixe o modelo SDK de CRM da galeria do Visual Studio. Clique duas vezes no arquivo CRMSDKTemplates.vsix para instalar o modelo no Visual Studio.
Baixe e instale o SDK do CRM. O arquivo de modelos CRMSDKTemplates.vsix está localizado na pasta SDK\Templates. Clique duas vezes no arquivo para instalar o modelo no Visual Studio.
Dica
O modelo funciona se você tiver o Microsoft .NET Framework 4.5.2 e o Microsoft Visual Studio 2012, Visual Studio 2013 ou o Visual Studio 2015. Além disso, você deve ter Gerenciador de Pacotes NuGet para Visual Studio 2012, Visual Studio 2013 ou Visual Studio 2015.
O modelo de Conector CTI fornece eventos e métodos pré-vinculados o ajudam a definir um Conector CTI.
Inicie o Visual Studio e crie um novo projeto.
Na caixa de diálogo Novo projeto:
Na lista de modelos instalados, expanda Visual C# e selecione Modelos de SDK do Dynamics 365 > Unified Service Desk > Conector de CTI de USD.
Especifique o nome e o local do projeto e clique em OK.
No Solution Explorer, clique com o botão direito no arquivo CtiConnector.cs e selecione Exibir Código para exibir o código.
Implemente os métodos e eventos necessários. Para código de exemplo que demonstra como criar um Conector CTI, baixe e instale o SDK de UII e procure a pasta UII\SampleCode\UII\CCA\Source Code\Cti Root. Para obter mais informações sobre os métodos e eventos para implementação de um Conector CTI, consulte a interface ICtiControl.
Salve seu projeto e compile-o (Compilar > Compilar Solução). Depois de compilar o projeto com êxito, um assembly (arquivo dll) é gerado com os mesmos nomes de seu projeto (a não ser que você tenha alterado-o nas propriedades do projeto) na pasta \bin\debug de seu projeto.
Dica
Anote o nome da classe usada para compilar seu controle de CTI no arquivo CtiConnector.cs. Você precisará dessa informação na próxima etapa.
Copie esse arquivo no diretório de instalação do aplicativo cliente do Unified Service Desk (geralmente, C:\Program Files\Microsoft Dynamics CRM USD\USD). Esse arquivo é necessário para testar e usar o Conector CTI de seu aplicativo cliente de Unified Service Desk.
Configurar um controle hospedado para o Conector de CTI no Unified Service Desk
Após compilar o controle de Conector CTI, você deverá configurá-lo no Unified Service Desk.
Dica
O projeto Conector CTI também permite que você defina seu componente de CTI Desktop Manager. É preciso criar dois controles hospedados separados, um para o Conector CTI e CTI Desktop Manager, no Unified Service Desk depois de ter adicionado o código no último Visual Studio.Para obter mais informações:Criar um CTI Desktop Manager
Entre no Microsoft Dynamics 365.
Na barra de navegação, escolha Microsoft Dynamics 365 > Configurações > Unified Service Desk.
Na página do Unified Service Desk, selecione Controles Hospedados.
Na página Controles Hospedados, selecione Novo.
Na página Novo Controle Hospedado, especifique os seguintes valores
Campo
Valor
Nome
CTIConnector
Tipo de Componente do USD
Aplicativo Hospedado do CCA
Aplicativo Hospedado
Controle Hospedado
O Aplicativo é Global
Verificado
Grupo de Exibição
HiddenPanel
Adaptador
Não Usar Adaptador
URI do Assembly
Esse é o nome do arquivo de assembly (.dll) que é integrado à etapa anterior.
Tipo de Assembly
Esse é o nome do arquivo de assembly (.dll), seguido por um ponto e o nome da classe de seu Conector CTI. Por exemplo, se o nome do arquivo .dll for MyCtiConnector, e o nome da classe do projeto de CTI for CtiConnector, digite o seguinte valor neste campo: MyCtiConnector.CtiConnector.
Selecione Salvar para criar o controle hospedado.
Confira Também
Criar um CTI Desktop Manager
Criar um controle CTI
Estrutura UII de integração entre telefonia e computador (CTI)
Passo a passo: Usar o adaptador de escuta genérica para o roteamento de eventos CTI
Unified Service Desk 2.0
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais