Instalar Agent Workspace (Embedded) (Agent Embedded) em Microsoft Dynamics CIF v2
Esta é a primeira etapa de configuração do Agent Workspace (Embedded) (Agent Embedded) no Microsoft Dynamics.
Estas instruções são para a Channel Integration Framework (CIF) versão 2 do Microsoft Dynamics. Se você usar a CIF versão 1, saiba como instalar Agent Workspace (Embedded) (Agent Embedded) em Microsoft Dynamics CIF v1.
Esta página explica como instalar NiCE CXone Agent Workspace (Embedded) (Agent Embedded) em Microsoft Dynamics. uma vez instalado, os agentes podem usá-lo para lidar com interações diretamente do Microsoft Dynamics.
Esta instalação é realizada em Microsoft Dynamics. Se você não tiver acesso a uma seção de Microsoft Dynamics mencionada nestas etapas, contate o administrador de Microsoft Dynamics da sua organização para garantir que você tenha as permissões corretas.
Complete cada uma dessas tarefas na ordem indicada.
Criar um Perfil de Agent Experience
Para acessar o Centro de administração do Atendimento ao cliente no Microsoft Dynamics 365, você precisa de pelo menos uma destas funções de segurança:
-
Administrador do App Profile Manager e Usuário Básico.
-
Gerente de CSR.
-
Administrador do Omnichannel e Usuário Básico.
-
Administrador de sistemas.
-
Personalizador de sistemas.
Primeiro, você precisa criar um perfil de experiência do agente, ou perfil de aplicativo, para o Agent Workspace (Embedded) (Agent Embedded).
-
Abra o Microsoft Power Apps.
-
Acesse Apps > todos os aplicativos.
-
Clique em Centro de Administração de Atendimento ao cliente.
-
No menu esquerdo, acesse Agent Experience > Espaços de trabalho.
-
Em Perfis de experiência do Agente, clique em Gerenciar.
-
Clique Novo.
-
Preencha os campos no formulário Novo perfil.
-
Dê ao perfil de experiência do agente um Nome.
-
Para Nome Exclusivo, digite um valor neste formato: prefixo_nome. Por exemplo, CXone_appProfile.
-
Para fornecer informações extras sobre o perfil, escreva uma Descrição.
Saiba mais sobre os campos nesta etapa
Campo Detalhes Nome O nome DO perfil de experiência do agente como aparece na lista de perfis. Nome exclusivo
Um identificador exclusivo para o perfil. Deve seguir este formato: prefixo_nome. O prefixo deve ter entre 3 e 8 caracteres e não pode conter caracteres especiais. Você pode clicar em Verificar
para ver se o que você inseriu atende aos requisitos.Descrição A descrição do perfil conforme aparece na lista de perfis. -
-
Certifique-se de que o perfil de experiência do agente tenha o privilégio Read session template (prvReadmsdyn_sessiontemplate) atribuído a ele. Ambas as funções App Profile Manager Administrator e App Profile User
têm esse privilégio. -
Clique em Criar.
Adicionar usuários ao Perfil Agent Experience
-
No perfil de experiência do agente que você acabou de criar, localize a seção Usuários e, em seguida, clique em Editar.
-
Clique em Adicionar usuários.
-
Selecione os usuários que usarão o Agent Workspace (Embedded) (Agent Embedded). Você pode procurar usuários na janela Registros de pesquisa. Depois de selecionar todos os usuários que deseja, clique em Adicionar.
Criar um Modelo de Guia de Aplicativo
Se ainda não o fez, crie um modelo de guia de aplicativo para Agent Workspace (Embedded) (Agent Embedded). O modelo de guia de Aplicativo determina qual guia é aberta quando uma nova sessão em Agent Workspace (Embedded) (Agent Embedded) é iniciada.
A Anchor tab
aparece em todas as sessões. Ela não pode ser oculta ou removida.
-
No centro de administração do Power Apps Microsoft Atendimento ao cliente, vá para Agent Experience > Espaços de trabalho no menu à esquerda.
-
Em Modelos de Guia do Aplicativo, clique em Gerenciar.
-
Clique Novo.
-
Preencha os campos no formulário novo modelo de Guia de Aplicativo.
-
Dê um Nome ao modelo de guia do aplicativo.
-
Para Nome Exclusivo, digite um valor sem espaços.
-
No campo Tipo de Página, selecione Registro de Entidade.
-
No campo Pode fechar, selecione Sim.
Saiba mais sobre os campos nesta etapa
Campo Detalhes Nome O nome do modelo de guia do aplicativo. Nome exclusivo
Um identificador exclusivo para o modelo. Deve seguir este formato: prefixo_nome. O prefixo deve ter entre 3 e 8 caracteres e não pode conter caracteres especiais. Você pode clicar em Verificar
para ver se o que você inseriu atende aos requisitos.Título O título do Agent Workspace (Embedded) (Agent Embedded) como aparece para os agentes. Tipo de página O tipo de página que aparece no modelo. Os valores possíveis são:
-
Controle
-
Personalizado
-
Dashboard
-
Lista de entidade
-
Registro de entidade
-
Pesquisar
-
Site de terceiros
-
Recurso da Web
Descrição Uma descrição do modelo. Pode fechar Dois valores possíveis:
-
Sim: O modelo pode fechar.
-
Não: O modelo sempre permanece aberto no Microsoft Dynamics.
-
Criar um Modelo de sessão
Para exibir Agent Workspace (Embedded) (Agent Embedded) no espaço de trabalho Microsoft Dynamics, você deve criar um modelo de sessão para Agent Workspace (Embedded) (Agent Embedded).
Você pode criar um ou dois modelos de sessão. Se você criar um modelo de sessão, ele aparecerá para os agentes em todos os momentos, independentemente de estarem lidando com interações ou não. Se você criar dois modelos de sessão, eles incluem:
-
Modelo de sessão padrão: aparece quando o agente não está lidando com uma interação.
-
Modelo de sessão de interação: aparece quando o agente está lidando com uma interação. Você pode configurar esse modelo de sessão para exibir guias que ajudam os agentes a lidar com as interações. Se o agente abrir outra interação, uma guia para ela pode aparecer na mesma sessão Microsoft Dynamics que a primeira. Isso ocorre devido a uma limitação de Microsoft Dynamics.
-
No Microsoft Power Apps Customer Service admin center, vá para Agent Experience > Espaços de trabalho no menu à esquerda.
-
Em Modelos de Sessão, clique em Gerenciar.
-
Clique Novo.
-
Preencha os campos no formulário novo modelo de sessão. As alterações são salvas automaticamente.
-
Dê um Nome ao modelo de sessão.
-
No campo Nome Exclusivo, insira default_template se estiver criando um modelo de sessão padrão, ou se estiver criando somente um modelo de sessão. Insira interaction_template se estiver criando um modelo de sessão de interação.
-
No campo Tipo, selecione Genérico.
-
No campo Título, digite {title}.
-
No campo Modo do painel de comunicação, selecione Encaixado.
-
No campo Proprietário, pesquise e selecione a unidade de negócios
dos usuários que utilizarão este modelo de sessão. -
Para Guia Âncora, selecione o nome do modelo de guia do aplicativo que você criou.
Saiba mais sobre os campos nesta etapa
Campo Detalhes Nome O nome do modelo de sessão. Nome exclusivo
Um identificador exclusivo para o modelo. Deve seguir este formato: prefixo_nome. O prefixo deve ter entre 3 e 8 caracteres e não pode conter caracteres especiais. Você pode clicar em Verificar
para ver se o que você digitou atende aos requisitos.Esse valor será usado para configurar o provedor de canal.
Tipo O tipo do modelo. Os valores possíveis são:
-
Entidade: Exibe o campo Entdade.
-
Genérico: Permite que o modelo seja atribuído a um provedor de canal.
Título O título do Agent Workspace (Embedded) (Agent Embedded) como aparece para os agentes. Modo do painel de comunicação Determina o tamanho do Agent Workspace (Embedded) (Agent Embedded) quando os agentes abri-lo. Os valores possíveis são:
-
Encaixado: O aplicativo inteiro aparece.
-
Oculto: O aplicativo fica oculto.
-
Minimizado: O aplicativo é minimizado.
Descrição A descrição do modelo. Ícone da Sessão O ícone que aparece para o Agent Workspace (Embedded) (Agent Embedded). Deve ser um arquivo de recurso da web. Somente disponível quando Tipo está definido como Generic. Proprietário O usuário encarregado de manter o modelo. Você pode procurar usuários neste campo. Guia Âncora Selecione o nome do modelo de guia de aplicativo que você criou para que Agent Workspace (Embedded) (Agent Embedded) seja aberto automaticamente quando os agentes fizerem login. Somente disponível quando Tipo está definido como Genérico. -
-
Para criar um segundo modelo de sessão, repita as etapas acima.
Criar modelos de Notificação
Opcionalmente, você poderá criar dois modelos de notificação no Microsoft Power Apps:
-
Chamada de entrada CTI: Alertar os usuários quando uma sessão em Agent Workspace (Embedded) (Agent Embedded) for fechada.
-
Máximo de sessões atingido: alerta os usuários quando tiver sido atingido o número máximo de nove sessões.
Caso não queira criar os modelos de notificação, pule para a próxima seção.
Criar um Modelo de Notificação para Chamada de entrada CTI
Esse modelo de notificação alerta os usuários quando uma sessão no Agent Workspace (Embedded) (Agent Embedded) será encerrada.
-
No centro de administração do Power Apps Customer Service Microsoft, vá até Agent Experience > Espaços de trabalho no menu à esquerda.
-
Em Modelos de Notificação, clique em Gerenciar.
-
Clique em novo modelo de Notificação.
-
Preencha os campos no formulário novo modelo de Notificação. As alterações são salvas automaticamente.
-
Dê ao modelo de notificação um Nome. Por exemplo, CTI: Chamada de entrada.
-
No campo Nome Exclusivo, digite CTI_inboundCallNotification.
-
No campo Título, digite {headerText}.
-
Configure os demais campos de acordo com as suas preferências.
Saiba mais sobre os campos nesta etapa
Campo Detalhes Nome O nome do modelo de notificação. Nome exclusivo
Um identificador exclusivo para o modelo. Deve seguir este formato: prefixo_nome. O prefixo deve ter entre 3 e 8 caracteres e não pode conter caracteres especiais. Você pode clicar em Verificar
para ver se o que você inseriu atende aos requisitos.Título O título do Agent Workspace (Embedded) (Agent Embedded) como aparece para os agentes. Ícone O ícone que aparece para o Agent Workspace (Embedded) (Agent Embedded). Deve ser um arquivo de recurso da web. Atribuir itens DE trabalho automaticamente Quando ativado, as interações são atribuídas automaticamente aos agentes. Recomenda-se desativar essa opção.
Mostrar contagem regressiva Selecione Sim para mostrar um temporizador de contagem regressiva para os agentes por meio de uma notificação (recomendado). Selecione Não para ocultar o temporizador.
Contagem regressiva (segundos) Se você selecionou Sim para Mostrar contagem regressiva, digite o número de segundos que você quer que a notificação do temporizador apareça. O valor recomendado é 5 Botão Aceitar Os agentes de texto clicam para aceitar as interações. O texto recomendado é Sim.
Mostrar o botão Rejeitar Quando habilitado, a opção de rejeitar uma interação é mostrada para os agentes. Recomenda-se ativar essa opção. Botão Rejeitar Os agentes de texto clicam para rejeitar as interações. O texto recomendado é Rejeitar. Mostrar Notificações do Desktop Escolha se é para habilitar notificações na área de trabalho para Agent Workspace (Embedded) (Agent Embedded). A opção recomendada é Nunca. Proprietário O usuário encarregado de manter o modelo. Você pode procurar usuários neste campo. -
Criar um Modelo de Notificação para Máximo de sessões atingido
Esse modelo de notificação alerta os usuários quando o número máximo de nove sessões foi atingido.
-
No Microsoft centro de administração do Power Apps Customer Service, vá para Experiência do Agente > Espaços de trabalho no menu à esquerda.
-
Em Modelos de Notificação, clique em Gerenciar.
-
Clique em novo modelo de Notificação.
-
Preencha os campos no formulário novo modelo de Notificação. As alterações são salvas automaticamente.
-
Dê um Nome ao modelo de notificação. Por exemplo, máximo de sessões atingido.
-
No campo Título, digite {headerText}.
-
Configure os demais campos de acordo com as suas preferências.
Saiba mais sobre os campos nesta etapa
Campo Detalhes Nome O nome do modelo de notificação. Nome exclusivo
Um identificador exclusivo para o modelo. Deve seguir este formato: prefixo_nome. O prefixo deve ter entre 3 e 8 caracteres e não pode conter caracteres especiais. Você pode clicar em Verificar
para ver se o que você inseriu atende aos requisitos.Título O título do Agent Workspace (Embedded) (Agent Embedded) como aparece para os agentes. Ícone O ícone que aparece para o Agent Workspace (Embedded) (Agent Embedded). Deve ser um arquivo de recurso da web. Atribuir itens DE trabalho automaticamente Quando ativado, as interações são atribuídas automaticamente aos agentes. Recomenda-se desativar essa opção.
Mostrar contagem regressiva Selecione Sim para mostrar um temporizador de contagem regressiva para os agentes por meio de uma notificação (recomendado). Selecione Não para ocultar o temporizador.
Contagem regressiva (segundos) Se você selecionou Sim para Mostrar contagem regressiva, digite o número de segundos que você quer que a notificação do temporizador apareça. O valor recomendado é 15 Botão Aceitar Os agentes de texto clicam para aceitar as interações. O texto recomendado é OK.
Mostrar o botão Rejeitar Quando habilitado, a opção de rejeitar uma interação é mostrada para os agentes. Recomenda-se desativar essa opção. Mostrar Notificações do Desktop Escolha se é para habilitar notificações na área de trabalho para Agent Workspace (Embedded) (Agent Embedded). A opção recomendada é Nunca. Proprietário O usuário encarregado de manter o modelo. Você pode procurar usuários neste campo. -
Configurar o Provedor de Canal
-
No Microsoft centro de administração do Power Apps Atendimento ao cliente, vá para Experiência do Agente > Espaços de trabalho no menu à esquerda.
-
Em Agent Experience Profiles, selecione o Perfil de experiência do Agente que você criou anteriormente.
-
Clique em Editar ao lado de Provedores de Canal.
-
Clique em Novo ao lado de Provedores de canal de voz de Terceiros.
-
Preencha os campos no formulário. As alterações são salvas automaticamente.
-
Dê um nome ao provedor de canal.
-
No campo Nome Exclusivo, digite um valor sem espaços.
-
No campo Rótulo, digite o nome que você quer que apareça para os usuários.
-
Para URL do Canal, insira a URL do seu Agent Workspace (Embedded) (Agent Embedded), seguida de _msd&base=, seguida da URL da instância do seu Microsoft Dynamics. O URL do seu Agent Workspace (Embedded) (Agent Embedded) é um destes:
-
Se você não estiver em FedRAMP: https://cxagent.nicecxone.com/login?app=cxa
-
Se você estiver no FedRAMP: https://cxagent.nicecxone-gov.com/login?app=cxa
Por exemplo, se você não estiver no FedRAMP, e a URL da instância do Microsoft Dynamics for https://my.dynamics.com, sua URL do Canal seria https://cxagent.nicecxone.com/login?app=cxa_msd&base=https://my.dynamics.com.
-
-
Para Habilitar saída, selecione Sim.
-
Para Ordem do Canal, digite 1.
-
No campo Custom Parameters, adicione os seguintes atributos e valores, separados por comercial "e" (&):
- mode=1
- width=450
- sessionTemplate=default_template: O valor deste atributo deve ser igual ao nome exclusivo do modelo de sessão padrão que você criou.
- notificationTemplate=CTI_inboundCallNotification: O valor deste atributo deve ser igual ao nome exclusivo do modelo de notificação de Chamada de entrada do CTI que você criou.
- maxSessionTemplate=max_session_reached: O valor deste atributo deve ser igual ao nome exclusivo do modelo de notificação de Max Session Reached que você criou.
- omniSessionTemplate=interaction_template: O valor deste atributo deve ser igual ao nome exclusivo do modelo de sessão de interação que você criou.
- inboundOnlySession: Quando este atributo é definido como true, o modelo de sessão abre somente para interações de entrada. Ele não abre para interações de saída.
Você pode copiar e colar o seguinte para usar como modelo. Corresponda o valor de cada atributo do modelo ao nome exclusivo do modelo correspondente.
mode=1&sessionTemplate=default_template¬ificationTemplate=CTI_inboundCallNotification&maxSessionTemplate=max_session_reached&omniSessionTemplate=interaction_template&inboundOnlySession=true
Com exceção de mode=1 e sessionTemplate, todos os parâmetros personalizados listados aqui são opcionais. No entanto, se você criou mais de um modelo de sessão, você deve adicionar o parâmetro omniSessionTemplate. Ele deve vir após o parâmetro sessionTemplate. Se você criou apenas um modelo de sessão, você deve usar apenas o parâmetro sessionTemplate.
-
No campo Sandbox Configuration, insira allow-top-navigation.
-
No campo Habilitar Analytics, selecione Sim.
Saiba mais sobre os campos nesta etapa
Campo Detalhes Nome O nome do provedor de canal. Nome exclusivo
Um identificador exclusivo para o provedor de canal. Deve seguir este formato: prefixo_nome. O prefixo deve ter entre 3 e 8 caracteres e não pode conter caracteres especiais. Você pode clicar em Verificar
para ver se o que você digitou atende aos requisitos.Rótulo O título do Agent Workspace (Embedded) (Agent Embedded) como aparece para os agentes. URL do canal Inclui três componentes:
-
Primeiro, o URL do seu Agent Workspace (Embedded) (Agent Embedded).
-
Segundo, _msd&base=.
-
Terceiro, o URL da sua instância do Microsoft Dynamics.
Por exemplo: https://cxagent.nicecxone.com/login?app=cxa_msd&base=https://my.dynamics.com.
Ativar saída Permite clicar para discar no Agent Workspace (Embedded) (Agent Embedded) para números de telefone no Microsoft Dynamics.
Ordem do canal Determina a prioridade do provedor do canal. Se definido como 1, o provedor do canal será usado antes de outros provedores de canal. Por exemplo, se Agent Workspace (Embedded) (Agent Embedded) estiver definido como 1 e outro aplicativo do agente estiver definido como 2, Agent Workspace (Embedded) (Agent Embedded) será usado primeiro para interações. Versão da API Corresponde à sua versão da Channel Integration Framework. O valor deve ser 2. Domínio confiável Espaço para um domínio adicional. Deixe este campo em branco. Agent Workspace (Embedded) (Agent Embedded) sempre usa o domínio no campo URL do Canal. Parâmetros personalizados Espaço para configurações adicionais. Adicione estes parâmetros:
- mode=1
- width=450
- sessionTemplate=default_template: O valor deste atributo deve ser igual ao nome exclusivo do modelo de sessão padrão que você criou.
- notificationTemplate=CTI_inboundCallNotification: O valor deste atributo deve ser igual ao nome exclusivo do modelo de notificação de Chamada de entrada do CTI criado.
- maxSessionTemplate=max_session_reached: O valor deste atributo deve ser igual ao nome exclusivo do modelo de notificação Max Session Reached que você criou.
- omniSessionTemplate=interaction_template: O valor deste atributo deve ser igual ao nome exclusivo do modelo de sessão de interação que você criou.
- inboundOnlySession: Quando esse atributo é definido como true, o modelo de sessão abre somente para interações de entrada. Ele não abre para interações de saída.
Cada parâmetro deve ser separado por um "E" comercial (&).
Configuração do Sandbox Espaço para uma lista de atributos de caixa de areia para o provedor de canal. Enter um dos seguintes:
-
allow-top-navigation: Permite que Agent Workspace (Embedded) (Agent Embedded) controle redirecionamentos na Microsoft Dynamics.
-
allow-top-navigation-by-user-activation: Permite que Agent Workspace (Embedded) (Agent Embedded) controle redirecionamentos em Microsoft Dynamics somente após uma ação do usuário, como aceitar uma chamada.
Isso permite que Tela pops e hiperlinks funcionem. Se você inserir atributos adicionais, separe-os com vírgulas.
Habilitar Analytics Quando ativado, permite que Microsoft Dynamics colete dados de análises sobre o provedor de canal. -
Atualizar o Perfil de experiência do Agente
-
No centro de administração do Power Apps Customer Service Microsoft, vá para Experiência do Agente > Espaços de trabalho no menu à esquerda.
-
Em Perfis de experiência do Agente, clique em Gerenciar.
-
Selecione o perfil de experiência do agente que você criou anteriormente.
-
Em Provedores de Canal, certifique-se de que o provedor de canal que você criou seja listado ao lado de Provedores de canal de voz de Terceiros. Se não aparecer, clique em Editar e, em seguida, selecione-o na lista. As alterações são salvas automaticamente.
A próxima etapa da configuração de Agent Workspace (Embedded) (Agent Embedded) em Microsoft Dynamics é configurar uma configuração de CRM.