Criar e baixar o arquivo de manifesto para apps pré-publicados

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 3 min. de leitura

    • Crie e baixe o arquivo de manifesto ServiceNow para Microsoft Teams da sua instância para habilitar Microsoft Teams para usar o aplicativo ServiceNow para Teams.

    Antes de Iniciar

    Função necessária: external_app_install_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode conectar várias instâncias ServiceNow a um locatário Microsoft Teams. Para obter mais informações, consulte Integrating multiple ServiceNow instances with a single Microsoft Teams tenant.

    Somente uma configuração de app pré-publicada pode ser conectada ao locatário Microsoft Teams.

    Nota:
    Você pode conectar vários ambientes de aplicações autoconfiguradas ao locatário Microsoft Teams, pois pode criar aplicações do Azure separadas para cada ambiente de aplicações autoconfiguradas. Para obter informações sobre como criar um arquivo de manifesto para apps autoconfigurados, consulte Criar e baixar o arquivo de manifesto para apps autoconfigurados.

    Procedimento

    1. Navegar até Todos > ServiceNow para Microsoft Teams > Manifesto da aplicação > ServiceNow para Teams.
    2. Selecione Novo.
      A seção Informações genéricas é aberta.
    3. Na seção Informações genéricas, preencha os campos.
      Tabela 1. Formulário de informações genéricas
      Campo Descrição
      Nome curto Nome curto do arquivo de manifesto.
      Nome completo Nome completo do arquivo de manifesto.
      Versão Versão do arquivo de manifesto. Por exemplo, 1.0.0.
      Estender links Opção para estender os links em Microsoft Teams.

      O desdobramento de link gera uma visualização de conteúdo rico (cartão adaptável) quando um link compatível é compartilhado em uma conversa com um usuário em Microsoft Teams. Para obter mais detalhes sobre o desdobramento de links, consulte Estender os links da Web no bate-papo do Microsoft Teams.
      Descrição resumida Descrição resumida sobre o arquivo de manifesto.
      Descrição Descrição detalhada sobre o arquivo de manifesto.
      Cor de destaque Cor personalizada para as conversas em Microsoft Teams de acordo com a identidade visual da empresa. A cor de destaque deve estar no formato de código de cores HTML.
      Usar imagens padrão Opção para usar as imagens padrão para identidade visual.
      Nota:
      Se você quiser personalizar a identidade visual da empresa, desmarque a opção Usar imagens padrão e carregue os ícones. Para obter mais informações sobre o tamanho dos ícones, consulte Ícones do app e ícones do esquema do manifesto.
    4. Selecione Enviar.
    5. Selecione Avançar.
      Próxima opção na guia Informações genéricas
      A seção Configurar Virtual Agent é aberta
    6. Na seção Configurar Virtual Agent, selecione uma das opções a seguir.
      • Selecione Conectar uma única instância da ServiceNow ao locatário do Microsoft Teams para conectar uma instância ServiceNow a um locatário Microsoft Teams. O ID do bot do Virtual Agent é preenchido automaticamente quando você seleciona essa opção.
      • Selecione Conectar várias instâncias da ServiceNow ao locatário do Microsoft Teams para conectar várias instâncias ServiceNow a um locatário Microsoft Teams. Isso se aplica a apps autoconfigurados. Para obter mais informações, consulte Criar e baixar o arquivo de manifesto para apps autoconfigurados.

      Guia Configurar Virtual Agent
    7. Configure o Virtual Agent em sua instância.
      Para obter mais informações, consulte Conversational Integration with Microsoft Teams.
    8. Na seção Configurar guia, preencha os campos.
      Tabela 2. Configurar formulário de guia
      Campo Descrição
      Habilitar guias Opção para adicionar guias na aplicação Microsoft Teams. Essa opção é selecionada por padrão.
      Nome da guia Nome da guia do portal de serviços que aparece na aplicação Microsoft Teams.
      Habilitar feed de atividades Opção para habilitar o feed de atividades para receber notificações de campanha em Microsoft Teams. Essa opção é selecionada por padrão.

      Para um app autoconfigurado, você deve fornecer o ID da aplicação (cliente) e o ID do diretório (locatário) na seção Configurar guia.


      Guia Configurar app pré-publicado
    9. Selecione Avançar.
      A seção Pronto é aberta.
    10. Na seção Pronto, selecione a opção Habilitar feed de atividades para receber notificações de campanhas.
    11. Navegue até o registro de aplicativo e exiba o registro de configuração do provedor OIDC.
      • Selecione o link na mensagem de informações na parte superior da página.
      • Navegar até OAuth de Sistema > Registro de aplicações e selecione Azure AD - sso -<Tenant-ID> .
      A declaração do usuário faz parte do id_token que é obtido de Microsoft Azure AD (ID de entrada). O campo Usuário deve ser configurado para que o valor obtido da tabela Usuário [sys_user] corresponda ao valor da Declaração do usuário.
      Nota:
      Se nenhum dos campos configurados corresponder ao valor da Declaração do usuário, você poderá criar um campo personalizado e inserir o valor necessário.
    12. Verifique os detalhes fornecidos e selecione Baixar manifesto.

      Arquivo de manifesto
      O arquivo de manifesto é baixado no formato zip.

    O que Fazer Depois

    Você deve carregar o arquivo de manifesto no Microsoft Teams. Para obter mais informações, consulte Carregar arquivo de manifesto no Microsoft Teams.