Integrazione con Microsoft Teams

Il primo passo consiste nel creare un'app in Microsoft Teams.

Per creare l'app Teams:

1. Accedere a Microsoft Teams come amministratore.
2. Sulla scheda App, cercare e aggiungere App Studio.
3. Sulla scheda Manifest editor di App Studio, selezionare Crea nuova app.
4. Specificare perlomeno i seguenti valori:
• nome breve
• nome e cognome
• descrizione breve
• descrizione completa
• nome pacchetto (ad esempio nomeazienda.isdteamsapp.com)
• versione (ad esempio, 1.0.0)
• descrizione breve
• descrizione lunga
• informazioni sullo sviluppatore (ad esempio, nome e indirizzo sito web aziendale)
• URL sito web (richiede https://)
• URL dichiarazione privacy (richiede https://)
• URL condizioni per l'utilizzo (richiede https://)
5. Fare clic su Genera.
   L'ID app viene generato.
6. Sotto Funzionalità, selezionare Bot, quindi fare clic su Configura.
7. Inserire un Nome, selezionare Il mio bot è un bot di notifica monodirezionale, quindi impostare l'Ambito su Team.
8. Fare clic su Crea bot.
   Il bot viene creato e appare sulla pagina Bot, mostrando l'ID utilizzato nelle impostazioni di sistema Service Desk come Id bot.
   
9. Fare clic su Genera new password.
   Viene creata una password, utilizzata successivamente nelle impostazioni di sistema Service Desk come Password bot.
10. Inserire un indirizzo endpoint Bot nel modulo:
    https://[URL per il server]/[nome istanza framework]/api/messages?v=*
    ad esempio:
    https://my.example.org/servicedesk.framework.web/api/messages?v=*
11. Dalla scheda Prova e distribuisci, scaricare l'app Teams come file zip.
    

Una volta creata l'app, sarà necessario caricarla.

Per caricare l'app Teams per la propria organizzazione:

1. Accedere a Teams come amministratore.
2. Sulla scheda App, fare clic su Carica un'app personalizzata, quindi caricare il file zip dalla sezione precedente.
   Per l'app caricata apparirà un riquadro.
3. Fare clic sul riquadro per l'app, quindi fare clic su Aggiungi a un team.
4. Ricercare il team richiesto, quindi fare clic su Configura a bot.
   L'app Teams verrà installata per il team selezionato.

Ora si è pronti per configurare Service Desk per l'utilizzo dell'app Teams, dopodiché sarà possibile aggiungere utenti al team in Teams.

Una volta creata l'app Teams, e caricata, sarà possibile configurarne l'integrazione con Service Desk. Ciò coinvolge l'aggiunta di alcune impostazioni di sistema di Service Desk dalla configurazione dell'app Teams, per poi aggiungere un membro al Team appropriato e ritornare alle impostazioni di sistema di Service Desk, per abilitare e configurare ulteriormente l'integrazione.

Per configurare l'integrazione tra Service Desk e l'app Teams:

1. Accedere alla console di Service Desk come amministratore.
2. Sul menu Impostazioni, fare clic su Sistema.
   Apparirà la pagina Impostazioni di sistema.
3. Sotto Integrazione Teams, impostare i seguenti valori:
   Id bot – l'ID generato in Microsoft Teams quando si è creato il bot
   Password bot – la password generata in Microsoft Teams dopo aver creato il bot
   Collega a team – l'URL creato quando si seleziona Ottieni collegamento a team dal menu di scelta rapida del team.
   Url immagine notifica – l'URL dell'immagine che si desidera visualizzare sulla notifica Teams
4. Salvare le impostazioni.
   La fase successiva consiste nell'impostare il valore di sola lettura Url servizio, che viene effettuato per l'utente quando si invia il primo messaggio a Service Desk Framework al completamento dei seguenti passaggi.
5. Nel Centro configurazioni di Service Desk, riciclare il pool di app Framework.
6. In Microsoft Teams, aggiungere un utente al team che presenta l'app Service Desk Notification installata.
   Tale operazione invia un messaggio al Service Desk FrameWork e popola l'impostazione di sistema Url servizio.
7. Sulla pagina Impostazioni di sistema Service Desk, sotto Integrazione Teams, impostare Abilita Notifiche Teams su True e verificare che l'impostazione Url servizio presenti un valore.