Gerar automaticamente o arquivo de manifesto para carregamento em Microsoft Teams

Gerar automaticamente o arquivo de manifesto e personalizar a identidade visual do seu app Microsoft Teams para que você possa disponibilizar Virtual Agent em sua organização.

Antes de Iniciar

Função necessária: virtual_agent_admin ou admin

Por Que e Quando Desempenhar Esta Tarefa

Um gerador de arquivos de manifesto automatizado na nova IU do Microsoft Teams preenche automaticamente o ID do bot e atualiza outras configurações (por exemplo, identidade visual) com base na sua entrada como administrador​. O gerador de arquivos de manifesto também permite o download em um clique do pacote de manifesto.

• Antes de gerar um arquivo de manifesto, você deve criar um bot autoconfigurado (ou garantir que um já tenha sido criado) na instância do ServiceNow. Em seguida, você pode gerar um pacote de manifesto para cada bot autoconfigurado que criar​.
• Após salvar o formulário do manifesto, você pode baixar o pacote zip do manifesto, que contém os três seguintes arquivos:
  • manifest.json
  • color.png
  • outline.png
  Você pode editar o formulário de manifesto e fazer o download quantas vezes quiser.​

Nota:

Este recurso só é aplicável ao configurar a integração do Virtual Agent com o Microsoft Teams. Se você pretende usar ServiceNow para Microsoft Teams com ITSM recursos de RH, clique no link Saiba mais próximo ao Planejamento para habilitar integrações de ITSM e RH adicionais na página de Configuração do bot. Dessa forma, você pode configurar o manifesto em um módulo separado em vez de continuar configurando o manifesto aqui. Para obter mais informações, consulte Criação e download do arquivo de manifesto.

Procedimento

1. Navegar até Tudo > Interfaces conversacionais > Configurações.
2. Em Configurações Gerais nas opções Canais e roteamento, selecione Visualizar Todos.
3. Na página Canais e integrações, no bloco Microsoft Teams, clique em Gerenciar.
4. Na seção Bot autoconfigurado, selecione o ícone Gerenciar bot.
   Se você não habilitou a Extensão de Mensagem e este é seu primeiro acesso, você verá uma mensagem de alerta para Ativar novo recurso informando que o recurso de Extensão de mensagem para sua integração Microsoft Teams está disponível para ser ativado.
5. Na guia Configuração, selecione Editar configuração e preencha os campos no formulário.

   Tabela 1. Configurar seu bot - Manifesto do VA do Microsoft Teams

   Campo	Descrição
   Nome Curto	Nome de exibição curto do seu app. Nota: Certifique-se de que o nome não exceda 30 caracteres.
   Nome Completo	Nome completo do seu app. Use o nome completo se o nome curto do app exceder 30 caracteres. Nota: Certifique-se de que o nome completo não exceda 100 caracteres.
   ID do bot (Cliente)	Identificador único do Microsoft gerado. Este campo é vinculado automaticamente à etapa de criação do bot, e não pode ser alterado.
   Descrição resumida	Descrição resumida da sua experiência com o app. Use uma descrição resumida quando o espaço for limitado. Nota: Certifique-se de que a descrição resumida não exceda 80 caracteres.
   Descrição completa	Descrição completa do seu app. Nota: Certifique-se de que a descrição completa não exceda 4000 caracteres.
   Domínios válidos	Lista de domínios válidos para sites que o app espera carregar em Microsoft Teams. Nota: Atualmente, apenas o domínio ServiceNow é compatível.
   Versão	Uma versão específica do seu app para rastrear o envio de manifesto incremental para Microsoft Teams. Por exemplo, 1.0.0. Use no máximo 2 dígitos após cada decimal. Nota: Certifique-se de colocar um número mais alto para cada nova versão.
   Cor de destaque	Cor a ser usada como plano de fundo para os ícones de contorno. Nota: O valor deve ser um código de cor HTML válido que comece com uma hashtag (#). Por exemplo, #293E40.
   Ícone de cor	Ícone do seu app que você deseja que apareça na maioria dos cenários do Microsoft Teams. Você pode selecionar uma das seguintes opções: Usar ícone padrão: Modifica a cor do ícone para o ícone de cor padrão. Usar ícone personalizado: Modifica o ícone de cor para uma cor de ícone de sua escolha. Nota: Certifique-se de carregar somente arquivos de imagem .png que tenham menos de 192x192 pixels para mudar a cor do ícone.
   Ícone de contorno	Ícone exibido na barra do aplicativo quando ele está em uso. Você pode selecionar uma das seguintes opções: Usar ícone padrão: Modifica o ícone de contorno para o ícone de contorno padrão. Usar ícone personalizado: Modifica o ícone de contorno por um ícone de sua escolha. Nota: Certifique-se de carregar somente arquivos de imagem .png que tenham menos de 32x32 pixels para mudar o ícone de contorno.
   Extensão da Mensagem	Extensão de mensagem que permite que os usuários pesquisem e compartilhem os resultados por meio da área de composição de mensagem do cliente Microsoft Teams. Se você for usar este bot para Microsoft Copilot, certifique-se de habilitar a Extensão de mensagem. Ao habilitar a extensão de mensagem para um app ou bot, você verá o mesmo app ou bot na área de extensão de mensagem durante a conversa com Now Assist usando Microsoft Copilot.

   Para obter mais informações sobre cada campo, consulte a Documentação do Microsoft Teams.

6. Selecione Salvar.
   Você será redirecionado para a página de Configuração do bot, onde o arquivo de manifesto está salvo e pronto para ser baixado.

   Nota:

   Você também pode editar o arquivo de manifesto selecionando Editar configuração na página de download, e fazendo o download do arquivo quantas vezes quiser. Em cada novo manifesto, certifique-se de inserir um número de versão maior no campo Versão para que o formulário atualizado seja salvo com sucesso.

7. Na página de Configuração do bot, em Seu pacote, clique no botão Download para baixar o seu arquivo de pacote.
   Nota:

   Você também pode editar o arquivo de manifesto selecionando Editar configuração na página de download, e fazendo o download do arquivo quantas vezes quiser. No entanto, com cada novo manifesto, certifique-se de inserir um número de versão maior no campo Versão para que o formulário atualizado seja salvo com sucesso.

O que Fazer Depois

Carregar o arquivo do pacote de manifesto para publicar seu bot.