Compartilhar via


Gerenciar modelos da guia de aplicativo

Um modelo de guia do aplicativo no SAC permite a você especificar o tipo de aplicativo que pode ser aberto quando os agentes iniciam uma sessão no Customer Service workspace .

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 Customer Service workspace, cada sessão tem pelo menos uma guia de aplicativo, chamada de "Guia âncora", que você não pode fechar nem 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 agente 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 Centro de administração do Customer Service e realize as etapas.

    1. No mapa do site, selecione Espaços de trabalho em Experiência do agente.
    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 Descrição Exemplo
    Geral Name Especifique o nome da guia do aplicativo. Esse nome não permanece visível para os agentes em runtime. Pesquisa de artigos de conhecimento
    Geral Nome exclusivo Forneça um identificador exclusivo no formato <prefix>_<name>.
    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 que você deseja que os agentes vejam no runtime. Pesquisa de artigos de conhecimento
    Geral Tipo de página Selecione um tipo de página na lista. Recurso da Web
    Geral Descrição 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 Descrição 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 for o seguinte: > - em branco > - incorreto > - trata-se de um painel que não está 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 Descrição 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 Cadeia de Caracteres 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 novo 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 Descrição 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

d49e62a8-90df-e311-9565-a45d36fc5fe8

{anchor._customerid_value}

formId GUID da instância do formulário Não Cadeia de Caracteres 915f6055-2e07-4276-ae08-2b96c8d02c57
validateRecord Verifica se o registro existe no banco de dados da organização Não Booliano 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 Descrição 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 Cadeia de Caracteres 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 Descrição 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 Descrição 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}

Nota

Quando um agente alterna do tipo de site de terceiros do modelo de guia para outra guia e, em seguida, volta para o modelo de guia do 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.

Parâmetro url: 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

Parâmetrourl: 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

Nota

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 Descrição Obrigatória Valores com suporte Exemplo
webresourceName Nome do recurso da Web a ser aberto Sim Cadeia de Caracteres 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}

Nota

Quando um agente alterna do tipo de recurso da web do modelo de guia para outra guia e, em seguida, volta para o tipo de recurso da web do modelo de guia, 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 Descrição 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



d49e62a8-90df-e311-9565-a45d36fc5fe8

{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 Exibe a página de pesquisa do Omnicanal na guia. Control

Confira também

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