Criar e baixar o arquivo de manifesto para apps autoconfigurados

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 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.

    Vários ambientes de app autoconfigurados podem ser conectados ao locatário Microsoft Teams, já que você pode criar apps do Azure separados para cada ambiente de app autoconfigurado.

    Este processo é para configurar um arquivo de manifesto Microsoft Teams, que determina como uma aplicação se comportaria em Microsoft Teams. Para obter informações sobre a geração de manifesto fornecida pelo ITSM/RH, consulte Auto-generate the manifest file for uploading on Microsoft Teams, que inclui mais configurações disponíveis.

    Nota:
    Você só pode conectar uma configuração de app pré-publicada ao locatário Microsoft Teams. Para obter informações sobre como criar um arquivo de manifesto para apps pré-publicados, consulte Criar e baixar o arquivo de manifesto para apps pré-publicados.

    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. Isso se aplica a apps pré-publicados. Para obter mais informações, consulte Criar e baixar o arquivo de manifesto para apps pré-publicados.
      • 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.

      Guia Configurar Virtual Agent

      Para configurar o Virtual Agent em sua instância, selecione Configurar Virtual Agent. Para obter mais informações, consulte Conversational Integration with Microsoft Teams.

      Para integrar o Virtual Agent com Microsoft Teams configurando seus próprios bots, consulte Integração do Virtual Agent ao Microsoft Teams usando o bot autoconfigurado.

    7. 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.
      ID da aplicação (cliente) O ID de cliente do app do Azure.
      ID do diretório (locatário) A ID do locatário da aplicação do Azure.

      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. A ID do locatário e a ID do cliente (ID da aplicação) podem ser obtidas no portal do Azure.


      opções do app autoconfigurado
    8. Selecione Avançar.
      A seção Pronto é aberta.
    9. Na seção Pronto, selecione a opção Habilitar feed de atividades para receber notificações de campanhas.
    10. 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 -<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.
    11. Verifique os detalhes fornecidos e selecione Baixar manifesto.

      Arquivo de manifesto
      O arquivo de manifesto é baixado no formato zip e um registro de aplicação é criado.

    O que Fazer Depois

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