Integração com o Microsoft Teams

A primeira etapa é criar um aplicativo no Microsoft Teams.

Para criar um aplicativo Teams:

1. Faça login no Microsoft Teams como administrador.
2. Na guia Aplicativos, busque e adicione o App Studio.
3. Na guia Editor de manifesto do App Studio, selecione Criar novo aplicativo.
4. Especifique, no mínimo, os seguintes valores:
• nome curto
• nome completo
• descrição curta
• descrição completa
• nome do pacote (por exemplo, nomedasuaempresa.isdteamsapp.com)
• versão (por exemplo, 1.0.0)
• descrição curta
• descrição longa
• informações do desenvolvedor (por exemplo, seu nome e o endereço do site da empresa)
• site (requer https://)
• URL da declaração de privacidade (requer https://)
• URL dos termos de uso (requer https://)
5. Clique em Gerar.
   O ID do aplicativo é gerado.
6. Em Recursos, selecione Bots e clique em Configurar.
7. Insira um Nome, selecione Meu bot é de notificação unidirecional e defina o Escopo como Equipe.
8. Clique em Criar bot.
   O bot é criado e aparece na página Bots, mostrando o ID que será usado nas configurações de sistema do Service Desk como ID do bot.
   
9. Clique em Gerar nova senha.
   É criada uma senha que, posteriormente, será usada nas configurações de sistema do Service Desk como Senha do bot.
10. Insira o endereço do ponto de extremidade do bot no formulário:
    https://[URL do servidor]/[nome da instância do framework]/api/messages?v=*
    por exemplo:
    https://meu.exemplo.org/servicedesk.framework.web/api/messages?v=*
11. Na guia Testar e distribuir, baixe o aplicativo Teams como um arquivo zip.
    

Depois de criar o aplicativo, você precisa carregá-lo.

Para carregar o aplicativo Teams para sua organização:

1. Entre no Teams como administrador.
2. Na guia Aplicativos, clique em Carregar um aplicativo personalizado e carregue o arquivo zip da seção anterior.
   Um bloco é exibido para o aplicativo carregado.
3. Clique no bloco do aplicativo e depois em Adicionar a uma equipe.
4. Procure a equipe desejada e clique em Configurar um bot.
   O aplicativo Teams é instalado para a equipe selecionada.

Agora você está pronto para configurar o Service Desk para usar o aplicativo Teams. Depois disso, você pode adicionar usuários à equipe no Teams.

Depois de criar o aplicativo Teams e carregá-lo, você pode configurar a integração entre ele e o Service Desk. Isso envolve adicionar algumas configurações de sistema do Service Desk a partir da configuração do aplicativo Teams, depois adicionar um membro à equipe pertinente e, então, retornar às configurações de sistema do Service Desk para habilitar e configurar outros detalhes da integração.

Para configurar a integração entre o Service Desk e o aplicativo Teams:

1. Faça login no console do Service Desk como administrador.
2. No menu Configurações, clique em Sistema.
   A página Configurações do Sistema é exibida.
3. Em Integração com o Teams, defina os seguintes valores:
   Id do bot – o ID gerado no Microsoft Teams quando você criou o bot.
   Senha do bot – a senha gerada no Microsoft Teams após você criar o bot.
   Link para a equipe – o URL criado quando você seleciona Obter link para a equipe no menu de contexto do Teams.
   URL da imagem de notificação - o URL da imagem a ser exibida na notificação do Teams.
4. Salve as configurações.
   O próximo estágio é definir o valor somente leitura de URL do Serviço. Isso é feito automaticamente quando você realiza as etapas a seguir e a primeira mensagem é enviada ao Service Desk Framework.
5. No Centro de Configuração do Service Desk, recicle o pool de aplicativos do Framework.
6. No Microsoft Teams, adicione um usuário à equipe que possui o aplicativo de notificações do Service Desk instalado.
   Isso envia uma mensagem ao Service Desk Framework e preenche o parâmetro URL do Serviço.
7. Na página Configurações do Sistema do Service Desk, em Integração com o Teams, defina Habilitar Notificações do Teams como Verdadeiro e verifique se o parâmetro URL do Serviço possui um valor.