Compartilhar via

Gerenciar modelos da guia de aplicativo

Aplica-se a: Dynamics 365 Contact Center — autônomo e Dynamics 365 Customer Service somente

Um modelo de guia de aplicativo no Atendimento ao Cliente permite especificar o tipo de aplicativos que podem ser abertos quando representantes do atendimento ao cliente (representantes do serviço ou representantes) iniciam uma sessão no workspace do Serviço Copilot.

A barra vertical no painel esquerdo mostra a lista de sessões. O painel sempre mostra a sessão Página Inicial que não consegue fechar nem personalizar.

No ambiente de trabalho do serviço Copilot, cada sessão tem pelo menos uma guia de aplicativo, chamada "Anchor tab", que você não pode fechar ou personalizar. Quando você inicia uma sessão, a página do aplicativo correspondente e eventuais outras páginas adicionais são abertas com base nas definições de configuração.

Usando o modelo de guia de aplicativo, é possível definir os aplicativos que estão disponíveis para uma sessão e associá-los à sessão. Por exemplo, você pode criar a guia de página Conversa ativa e associá-la a um chat ou uma sessão de SMS. Agora, quando um representante aceita uma notificação dos canais de chat ou SMS, uma sessão é iniciada e a página Conversa Ativa é aberta.

Como administrador, você pode criar vários modelos de guia de aplicativo.

Nota

Não é possível personalizar os modelos prontos para uso, mas é possível criar seus próprios modelos personalizados.

Pré-requisitos

Você precisa da função Administrador do Sistema para realizar as tarefas mencionadas neste artigo.

Criar modelos de guia de aplicativo

  1. Selecione o Centro de administração do Serviço copilot e execute as etapas.

    1. No mapa do site, selecione Espaços de trabalho em Experiência do suporte.
    2. Na página Espaços de trabalho, selecione Gerenciar em Modelos de guia de aplicativo.

  2. Selecione Novo na página Modelos de Guia de Aplicativo Ativos.

  3. Especifique os itens a seguir na página Novo Modelo de Guia de Aplicativo.

    Tabulação Name Description Exemplo
    Geral Name Especifique o nome da guia do aplicativo. Este nome não ficará visível para os representantes no runtime. Pesquisa de artigos de conhecimento
    Geral Nome exclusivo Forneça um identificador exclusivo no formato <prefix>_<name> format.
    IMPORTANTE
    Os seguintes itens são necessários para o nome exclusivo:
    • O prefixo só pode ser alfanumérico e seu tamanho deve ter entre 3 e 8 caracteres.
    • Um sublinhado deve ser adicionado entre o prefixo e o nome.

    Você pode selecionar o ícone da lâmpada e, em seguida, Aplicar para verificar se o nome inserido atende aos requisitos.    		 contoso_application_tab
    Geral Título Forneça um título para o aplicativo para ser visto pelos representantes durante a execução. Pesquisa de artigos de conhecimento
    Geral Tipo de página Selecione um tipo de página na lista. Recurso da Web
    Geral Description Forneça uma descrição para sua referência. O tipo de página é usado para exibir uma página de pesquisa da base de dados de conhecimento.

  4. Selecione Salvar. A seção Parâmetros exibe os parâmetros do tipo de página que você selecionou.

    Nota

    Sempre que você editar o modelo da guia do aplicativo, salve as alterações para ver os campos correspondentes na seção Parâmetros.

  5. Selecione o campo Valor de um parâmetro que você deseja editar e forneça o valor.

  6. Selecione Salvar.

Tipos de página

Os tipos de página a seguir estão disponíveis:

  • Painel
  • Lista de entidades
  • Registro da entidade
  • Pesquisa
  • Site de terceiros
  • Recurso da Web
  • Controle (somente para uso interno)
  • Personalizada

Painel

Este tipo de página é usado para exibir o painel como um aplicativo. O parâmetro a seguir está disponível para o tipo de página de painel.

Parâmetro Description Obrigatória Valores com suporte Exemplo
dashboardId GUID do painel Sim String d201a642-6283-4f1d-81b7-da4b1685e698

Observação

  • O painel padrão será exibido se o parâmetro dashboardId estiver:
    > - em branco
    > - incorreto
    > - um painel que não estiver incluído na definição do módulo do aplicativo
  • Os painéis padrão pessoais não são compatíveis.

Lista de entidades

Este tipo de página é usado para exibir uma exibição de entidade que define como uma lista de registros para uma entidade específica é exibida. Os parâmetros a seguir estão disponíveis para o tipo de página de exibição da entidade.

Parâmetro Description Obrigatória Valores com suporte Exemplo
entityName Nome lógico da entidade Sim Cadeia de caracteres

Campos de dados dinâmicos
 conta

{anchor._customerid_value@Microsoft.Dynamics.CRM.lookuplogicalname}
viewId GUID da exibição Não String 00000000-0000-0000-00aa-000010001031

Observação

Se a exibição de destino não existir ou não estiver incluída na definição do módulo de aplicativo, a exibição da entidade padrão será exibida.

Registro da entidade

Este tipo de página é usado para exibir um registro existente ou abrir um formulário para criar um registro.

Os parâmetros a seguir estão disponíveis para o tipo de página de registro da entidade quando um registro existente é aberto.

Parâmetro Description Obrigatória Valores com suporte Exemplo
entityName Nome lógico da entidade Sim Cadeia de caracteres

Campos de dados dinâmicos

conta

{anchor._customerid_value@Microsoft.Dynamics.CRM.lookuplogicalname}
entityId GUID do registro da entidade Não Cadeia de caracteres

Campos de dados dinâmicos

11bb11bb-cc22-dd33-ee44-55ff55ff55ff

{anchor._customerid_value}

formId GUID da instância do formulário Não String 915f6055-2e07-4276-ae08-2b96c8d02c57
validateRecord Verifica se o registro existe no banco de dados da organização Não booleano Verdadeiro

Observação

Se o sistema não comparar o valor entityId com um registro existente no Dataverse, o formulário será aberto em modo de criação para criar um registro. Se você quiser que o sistema só carregue o formulário quando o registro existir no Dataverse, defina o parâmetro validateRecord como verdadeiro.

Se o parâmetro validateRecord não estiver presente, crie o parâmetro assim:

  1. No formulário Modelo da Guia do Aplicativo, selecione Novo Parâmetro de Modelo e insira os seguintes valores:
    • Nome: validateRecord
    • Nome Exclusivo: new_tabtemplateparam_validateRecord
    • Valor: verdadeiro
  2. Salve e feche.

Os seguintes parâmetros estão disponíveis para o tipo de página do registro da entidade quando um formulário de entidade é aberto para criar um registro.

Parâmetro Description Obrigatória Valores com suporte Exemplo
entityName Nome lógico da entidade Sim Cadeia de caracteres

Campos de dados dinâmicos

contato

{anchor._customerid_value@Microsoft.Dynamics.CRM.lookuplogicalname}

data Dados a serem pré-populados no formulário Não JSON {"subject":"Task created from {anchor.ticketnumber}","description":"Follow-up needed with customer","prioritycode":"2","scheduledend":"06/12/2023", "regardingobjectid": [{"id": "{anchor.incidentid}", "name": "{anchor.title}", "entityType":"{anchor.entityName}"}]}
formId GUID da instância do formulário Não String 915f6055-2e07-4276-ae08-2b96c8d02c57

Os parâmetros a seguir estão disponíveis para o tipo de página de pesquisa da entidade.

Parâmetro Description Obrigatória Valores com suporte Exemplo
searchType Defina para usar a Pesquisa de relevância ou Pesquisa categorizada. Os valores possíveis são:
  • 0 para pesquisa de relevância
  • 1 para pesquisa categorizada
Não Número 0
searchText Define a cadeia de caracteres que você deseja pesquisar. Sim Cadeia de caracteres

Campos de dados dinâmicos

OData


contoso

{anchor.title}

{anchor._customerid_value@OData.Community.Display.V1.FormattedValue}
{$odata.incident.title.?$filter=incidentid eq '{anchor.incidentid}'&$select=title}

Site de terceiros

Este tipo de página é usado para exibir sites de terceiros como um aplicativo. É possível usar esse tipo para hospedar apenas os sites compatíveis com a hospedagem de iframe. Se o site não for compatível com a hospedagem iframe, uma mensagem de erro informando que o site se recusou a se conectar será exibida. O modelo da guia do aplicativo analisa a URL e os parâmetros de dados para formatar o endereço da URL a ser exibido.

Parâmetro Description Obrigatória Valores com suporte Exemplo
url A URL do site a ser exibido na guia do aplicativo
 Sim Cadeia de caracteres
https://www.bing.com/search?q=
data Parâmetro de dados adicional a ser analisado com o parâmetro url
 Não Cadeia de caracteres

Campos de dados dinâmicos

OData


contoso

{anchor.title}

{anchor._customerid_value@OData.Community.Display.V1.FormattedValue}
{$odata.incident.title.?$filter=incidentid eq '{anchor.incidentid}'&$select=title}

Observação

Quando um representante alterna do tipo de guia do site de terceiros para outra guia e, em seguida, alterna de volta para o modelo de guia de site de terceiros, a página é atualizada para o estado inicial. Para obter mais informações, consulte a seção "A guia do aplicativo de terceiros é atualizada quando o foco é alterado" no documento Problemas conhecidos.

Como funciona a análise

Esses exemplos são baseados em um cenário em que o caso foi aberto como a Guia âncora em uma nova sessão com o número do tíquete: CAS-01003-P3B7G1.

url parâmetro: https://www.bing.com/search?q=
Parâmetro data usando campos de dados dinâmicos: {anchor.ticketnumber}
URL esperada: https://www.bing.com/search?q=CAS-01003-P3B7G1

url parâmetro: https://www.bing.com/search?q=
Parâmetro data usando OData: {$odata.incident.ticketnumber.?$filter=incidentid eq'{anchor.incidentid}'&$select=ticketnumber}
URL esperada: https://www.bing.com/search?q=CAS-01003-P3B7G1

Observação

O parâmetro url requer o formato de URL correto usando 'https://'.

Recurso da Web

Esse tipo de página é usado para exibir recursos da Web que representam arquivos, que são usados para estender o aplicativo Web, como arquivos HTML, JavaScript, CSS e vários formatos de imagem. Os parâmetros a seguir estão disponíveis para o tipo de página de recursos da Web.

Parâmetro Description Obrigatória Valores com suporte Exemplo
webresourceName Nome do recurso da Web a ser aberto Sim String new_myresource.html
data Forneça um par de cadeia de caracteres ou valor-chave, de acordo com o requisito do recurso da Web. Não Cadeia de caracteres

Campos de dados dinâmicos

OData


contoso

{anchor.title}

{anchor._customerid_value@OData.Community.Display.V1.FormattedValue}
{$odata.incident.title.?$filter=incidentid eq '{anchor.incidentid}'&$select=title}

Observação

Quando um representante alterna do template de aba de tipo de recurso web para outra aba e, em seguida, alterna de volta para o template de aba de tipo de recurso web, a página é atualizada para o estado inicial. Para obter mais informações, consulte a seção "A guia do aplicativo de terceiros é atualizada quando o foco é alterado" no documento Problemas conhecidos.

Personalizada

Esse tipo de página é usado para exibir páginas personalizadas na guia do aplicativo. Você pode usar esse tipo de modelo da guia para hospedar páginas personalizadas disponíveis no aplicativo correspondente. Para mais informações sobre as páginas personalizadas, consulte Visão geral das páginas personalizadas para aplicativos baseados em modelo.

Os parâmetros a seguir estão disponíveis para páginas personalizadas.

Parâmetro Description Obrigatória Valores com suporte Exemplo
entityName Nome lógico da entidade Não Cadeia de caracteres

Campos de dados dinâmicos
incidente

{anchor.entityName}
name Nome exclusivo da página personalizada Sim Cadeia de caracteres
new_mycustompage
recordId GUID do registro da entidade Não Cadeia de caracteres

Campos de dados dinâmicos



OData



 11bb11bb-cc22-dd33-ee44-55ff55ff55ff

{caseId}

{anchor.incidentid}

{$odata.incident.title.?$filter=incidentid eq '{anchor.incidentid}'&$select=title}

Modelos de guia de aplicativo em formato pré-configurado

Os modelos de guia de aplicativo prontos para uso a seguir estão disponíveis.

Nome do modelo Descrição Tipo de aplicativo
Conversa Ativa Exibe a página Conversa ativa na guia. Registro da Entidade
Registro da entidade Exibe um registro de entidade na guia. Registro da Entidade
Pesquisa de Conhecimento Exibe a página de pesquisa do artigo de conhecimento na guia. Recurso da Web
Painel de Conversas Omnicanal Exibe o Painel de Conversas do Omnicanal na guia. Painel
Insights Intraday do Omnicanal Exibe um relatório do Power BI na guia. Control
Versão Preliminar de Resposta Rápida Exibe uma resposta rápida na guia. Control
Versão Preliminar de Mensagem Avançada Exibe uma mensagem rich na guia. Control
Pesquisa (preterido) Exibe a página de pesquisa do Omnicanal na guia. (preterido) Control

Introdução ao centro de administração do Copilot Service
Gerenciar modelos de sessão
Gerenciar modelos de notificação
Associar modelos a fluxos de trabalho

  • Last updated on