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

Pesquisa

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