Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
O Microsoft CIFramework fornece métodos para usar a API JavaScript para gerenciar o painel de comunicação (widget), notificação, guia do aplicativo, sessões, registros e formulários no aplicativo controlado por modelo do Dynamics 365.
Importante
- As APIs são suportadas apenas pelos provedores de canal ativos configurados em sua organização.
- O manipulador de eventos CIFInitDone deve ser invocado antes de chamar as outras APIs.
- O limite de tempo limite para as APIs é de 100 segundos. Se as APIs não forem executadas em 100 segundos, elas deverão ser executadas novamente com parâmetros ou escopo alterados.
APIs de gerenciamento de painel de comunicação
O painel de comunicação é onde você, como agente, interage com o cliente. Os widgets de parceiros criados usando o Channel Integration Framework 2.0 são carregados neste painel. O widget nesta versão é exibido à esquerda do painel de sessão e suporta os modos Encaixado, Minimizado e Oculto.
Use as APIs a seguir para gerenciar o estado do painel de comunicação (widget).
| Methods | Description |
|---|---|
| setWidth | Define a largura do painel para todas as sessões. |
| getWidth | Obtém a largura do painel em pixels. |
| setMode | Define o estado do painel. |
| getMode | Define o estado do painel. |
APIs de operações CRUD
Use as APIs a seguir para executar operações CRUD em registros de entidade.
| Methods | Description |
|---|---|
| createRecord | Cria um registro de entidade. |
| retrieveRecord | Recupera um registro de entidade. |
| updateRecord | Atualiza um registro de entidade. |
| deleteRecord | Exclui um registro de entidade. |
APIs de gerenciamento de notificações
Use as APIs a seguir para exibir ou cancelar notificações sobre conversas de entrada.
| Methods | Description |
|---|---|
| notificarEvento | Exibe uma notificação que pode ser usada para informar o agente sobre uma conversa de entrada. |
| cancelarEvento | Oculta ou cancela uma notificação com base no token de cancelamento, conforme especificado no notifyEvent método. |
APIs de gerenciamento da guia Aplicativo
Use as APIs a seguir para criar e gerenciar o estado de uma guia de aplicativo.
| Methods | Description |
|---|---|
| criarTab | Cria uma guia em uma sessão focada e retorna o identificador exclusivo da guia criada. |
| getTabs | Retorna uma matriz de identificadores de guia associados ao nome do modelo ou tags de modelo para guias na sessão em foco, se a sessão pertencer ao provedor de canal. |
| focusTab | Define o foco em uma guia, se a sessão focada pertencer ao provedor de canal e se a guia pertencer à sessão em foco. |
| getFocusedTab | Retorna o identificador de guia em uma sessão focada, se a sessão pertencer ao provedor. |
| refreshTab | Atualiza a guia. |
| setTabTitle | Define o título da guia, se a sessão focada pertence ao provedor de canal e se a guia pertence à sessão em foco. |
| fecharTab | Fecha a guia especificada na sessão atual. |
APIs de gerenciamento de sessão
Use as APIs a seguir para gerenciar sessões em um ambiente de provedor de várias sessões.
| Methods | Description |
|---|---|
| canCreateSession | Permite verificar se uma nova sessão pode ser criada. |
| criarSessão | Cria uma sessão com base no modelo de sessão definido como parte do modelo e retorna o identificador exclusivo da sessão que foi criada. |
| getSessão | Retorna um objeto que contém o identificador exclusivo da sessão, do contexto e do valor do parâmetro, se a sessão pertencer ao provedor de isFocused canal. |
| getFocusedSession | Retorna o identificador exclusivo da sessão que está em foco, se ele pertence ao provedor de canal else retorna null. |
| getAllSessions | Retorna a matriz de identificadores de sessão para um provedor de canal. |
| setSessionTitle | Define o título da sessão, se a sessão pertencer ao provedor de canal. |
| requestFocusSession | Define o foco na sessão cujo identificador de sessão é passado como um parâmetro, se a sessão pertencer ao provedor de canal. |
APIs de análise de canal
Use as APIs a seguir para acompanhar a análise de eventos.
| Methods | Description |
|---|---|
| logAnalyticsEvent | Invoque esse método para registrar análises para eventos personalizados. |
APIs do indicador de sessão
Use as APIs a seguir para indicar uma violação do indicador chave de desempenho (KPI) e para atualizar o número de novas atividades em uma sessão específica.
| Methods | Description |
|---|---|
| notificarKpiBreach | Esse método é usado para indicar uma violação de KPI. Quando esse método é usado, um círculo vermelho aparece na imagem de exibição do contato quando ocorre uma violação de KPI. |
| notificar NewActivity | Esse método é usado para atualizar o número de novas atividades em uma sessão específica. |
APIs de presença
Use essas APIs para definir e recuperar a presença do agente Omnichannel programaticamente. Você pode usar esses métodos quando um agente combinado está trabalhando em um aplicativo que não é da Microsoft com omnichannel e deseja sincronizar os estados de presença entre aplicativos diferentes para garantir que a capacidade do agente seja utilizada da melhor forma.
| Methods | Description |
|---|---|
| setPresença | Permite que a presença seja definida programaticamente para o agente na sessão do cliente. |
| getPresence | Permite que a presença seja retornada programaticamente para o agente na sessão do cliente. |
Métodos diversos
| Methods | Description |
|---|---|
| getEntityMetadata | Retorna os metadados da entidade para a entidade especificada. |
| setClickToAct | Define um valor booleano para habilitar ou desabilitar a comunicação de saída (ClickToAct). |
| getClickToAct | Retorna um valor booleano para indicar se a comunicação de saída (ClickToAct) está habilitada ou não. |
| pesquisaAndOpenRecords | O método procura o registro do widget de comunicação durante a comunicação de entrada e abre o registro. |
| getAmbiente | Obtém o aplicativo de Interface Unificada atual e os detalhes da página. Os detalhes incluem ID do aplicativo (appid), pageType(pageType), ID do registro (id), geografia da organização (orgGeo) e tipo de navegação da sessão (navigationType). |
| Formulário aberto | Abre um formulário de entidade ou um formulário de criação rápida. |
| renderSearchPage | Permite pesquisar entre os registos de um determinado tipo de entidade. Essa API abre a página da entidade Interface Unificada com o campo de pesquisa pré-preenchido com a cadeia de caracteres de pesquisa que é passada como parâmetro. |
| addHandler | Adiciona o assinante aos eventos.
Observação Essa API pode ser usada no widget e na página da Interface Unificada. |
| removeHandler | Remove o assinante dos eventos.
Observação Essa API pode ser usada no widget e na página da Interface Unificada. |
| raiseEvento | Invoca o assinante associado para o evento.
Observação Se você criou eventos personalizados usando o método addHandler, poderá gerar esses eventos passando o nome do evento como parâmetro nesse método. |
| updateContext | Esse método permite que você defina o dicionário de automação. |
| updateConversa | Esse método permite que você atualize um registro de conversa. |
Informações adicionais
O que há de novo no Dynamics 365 Channel Integration Framework
Requisitos do sistema para o Dynamics 365 Channel Integration Framework 2.0