Cosa sono le app di Microsoft Teams?

10 minuti

Un'app creata a partire dalla piattaforma di Microsoft Teams estende il client di Microsoft Teams (Web, mobile e desktop) con le app e i servizi Web ospitati. La piattaforma Teams offre un set ricco e flessibile di punti di estendibilità, costrutti di interfaccia utente e API per sfruttarne i vantaggi durante la creazione dell'app. L'app può essere semplice come incorporare il sito Web esistente in una scheda per il team oppure trattarsi di un'app completa e multi sfaccettata che coinvolge gli utenti nell'intera area del client di Teams. È possibile scegliere di integrare un'app esistente o di creare una nuova esperienza, creata appositamente per Teams.

Con la piattaforma Microsoft Teams è possibile arricchire i servizi con informazioni specifiche del contesto offerte dalle varie API di Microsoft Teams, ad esempio informazioni sul team o sul canale in cui è installata l'app o i messaggi da cui l'app è stata attivata. È possibile creare app per un singolo utente, un team, l'intera organizzazione oppure pubblicare l'app nell'app store pubblico in modo che tutti possano usarla.

Come si diventa un'app Microsoft Teams?

Le app create a partire dalla piattaforma di Microsoft Teams sono costituite da tre componenti principali:

Il client di Microsoft Teams fornisce i punti di estensione e gli elementi dell'interfaccia utente che l'app userà per coinvolgere gli utenti.
Il pacchetto delle app di Teams è installato in Microsoft Teams. Contiene una piccola icona, un'icona di grandi dimensioni e un file manifest JSON. Il file manifest contiene i metadati per l'app, ad esempio il nome dell'app, il nome dello sviluppatore e così via, l'estendibilità utilizzata dall'app, come le schede e le estensioni di messaggistica, e i puntatori ai servizi Web per l'alimentazione dell'app, ad esempio l'ID del bot o l'URL della scheda.
I servizi Web ospitati dall'utente forniscono le API e la logica per l'app.

È importante tenere presente che la piattaforma Microsoft Teams non è un servizio di hosting, i servizi Web che potenziano l'app devono essere ospitati dall'utente ed essere resi accessibili con HTTPS tramite Internet.

Dove è possibile estendere il client di Teams?

Il client di Microsoft Teams può essere esteso in diversi punti per consentire agli utenti di interagire con l'app. A seconda dello scenario, si può scegliere di concentrarsi su un singolo punto di estensione (ad esempio un bot conversazione personale) o combinare più punti di estensione.

Team, canali e chat di gruppo

Team, canali e chat di gruppo consentono a più persone di collaborare. Le app che estendono il contesto si rendono disponibili a tutti i membri del gruppo o della conversazione, in genere concentrandosi sulla modalità di abilitare altri flussi di lavoro di collaborazione o su come sbloccare nuove interazioni social. L'app avrà accesso alle API per consentire all'app di ottenere informazioni sui membri della conversazione, sui canali di un team e sui metadati relativi al team o alla conversazione.

Possono essere espansi con:

Bot di conversazione, di chiamata e per i media online che interagiscono con i membri della conversazione tramite chat e rispondono a eventi, come l'aggiunta di un nuovo membro o l’assegnazione di un nuovo nome a un canale. Tutte le conversazioni con un bot in questo contesto sono visibili a tutti i membri del canale o del gruppo, quindi è necessario assicurarsi che la conversazione sia pertinente per tutti.
Schede chat di canale e di gruppo che offrono un'esperienza Web incorporata a schermo intero configurata per il canale o la chat di gruppo in cui è installato. Tutti i membri interagiranno nella stessa app Web condivisa, quindi un'esperienza dell'app a pagina singola senza stato è tipica.
Webhook e connettori che consentono ai servizi esterni di pubblicare messaggi nella conversazione. È possibile sfruttare le schede e le azioni per creare messaggi rtf su cui è possibile eseguire azioni. I webhook offrono un metodo unidirezionale semplice, non autenticato, per pubblicare i messaggi in un canale, mentre i connettori offrono un'esperienza di invio leggermente più efficace.

App personali

Le app personali sono la parte dell'app Teams incentrata sulle interazioni con un singolo utente. L'esperienza è univoca per ogni singolo utente. Questa parte dell'app può essere aggiunta al riquadro di spostamento sinistro, consentendo agli utenti l'accesso con un clic.

Possono contenere:

Bot di conversazione, di chiamata e per i media online che interagiscono singolarmente con l’utente. Dal momento che si tratta di una conversazione privata, se l'app deve avere una conversazione a più turni con un utente o fornire una notifica pertinente solo a un singolo utente, è in genere meglio interagire in un'app personale.
Schede personali un'esperienza Web incorporata a schermo intero.

Messaggi

I messaggi sono alla base della collaborazione in Teams. Con l'estensione della messaggistica , l'app può consentire agli utenti di richiamare l'API dell'app da un messaggio, inviando il contenuto del messaggio all'app a scopo di elaborazione o azione. L'app può rispondere presentando un modulo, un modulo attività, all'utente per raccogliere altre informazioni, inviare una risposta al messaggio originale o inviare un messaggio direttamente all'utente.

Scrittura di messaggi

L'app può aiutare gli utenti a creare messaggi più efficaci consentendo loro di eseguire ricerche o intervenire in un sistema esterno e di inserire i risultati in un formato completo e strutturato, con pulsanti interattivi.

L'app può aiutare gli utenti a creare messaggi migliori in tre modi:

Estensione messaggistica: comandi azione presenta all'utente un modulo modale (un modulo attività), invia i risultati del modulo all'app, quindi inserisce un messaggio direttamente nella conversazione oppure crea parte di un messaggio che l'utente può modificare prima dell'invio alla conversazione.
Estensione messaggistica: comandi di ricerca, che consentono di eseguire rapidamente ricerche in un sistema esterno, di visualizzare in anteprima i risultati della ricerca e quindi inserire il risultato nella chat come scheda avanzata.
Estensione messaggistica: collegamento che consente all'app di monitorare i domini Web a cui si è interessati. Quando nella finestra di composizione del messaggio viene incollato un URL contenente tale dominio, viene richiamata l'API dell'app, che consente di aggiungere una scheda RTF al messaggio con informazioni aggiuntive sull'elemento a cui viene collegato l'elemento.

App per riunioni

Le riunioni consentono collaborazione, partnership, comunicazioni informate e feedback condivisi. L'app per riunioni può offrire un'esperienza utente per ogni fase del ciclo di vita delle riunioni.

Il ciclo di vita della riunione include l'esperienza dell'app pre-riunione, durante la riunione e post-riunione, a seconda dello stato del partecipante.

Elementi dell'interfaccia utente

Inoltre, per i punti di estendibilità, la piattaforma Microsoft Teams offre elementi flessibili dell'interfaccia utente di cui le app possono trarre vantaggio. Questi elementi consentono di creare esperienze utente native per il client di Teams.

Schede e azioni della scheda

Le schede sono contenitori di interfaccia utente definiti da JSON schematizzato, che possono contenere più proprietà e allegati. Possono contenere testo formattato, elementi multimediali, controlli (come caselle di riepilogo a discesa e pulsanti di opzione) e pulsanti che attivano azioni del biglietto. Le azioni della scheda possono inviare payload all'API dell'app, aprire un collegamento, avviare flussi di autenticazione o inviare messaggi alle conversazioni. La piattaforma Microsoft Teams supporta più tipi di schede, tra cui schede adattive, schede hero, schede di anteprima e altro ancora. Possono essere combinate in Raccolte schede e visualizzate in un elenco o in un carousel.

Moduli attività (finestre di dialogo)

I moduli attività consentono di creare esperienze popup modali nell'applicazione Teams. All'interno del popup è possibile eseguire codice HTML/JavaScript personalizzato, mostrare un <iframe> come un video di YouTube o Microsoft Stream o visualizzare una scheda adattiva. Sono particolarmente utili per avviare e completare attività o per visualizzare informazioni dettagliate come video o dashboard di Power BI. Un'esperienza popup è spesso più naturale per gli utenti che iniziano e completano attività rispetto a una scheda o a un'esperienza di bot basata su conversazioni.

Collegamenti diretti

L'app può creare collegamenti diretti dell'URL per esplorare l'utente nell'app e nel client di Teams. È possibile creare un collegamento completo per la maggior parte delle entità in Teams e alcune, come una nuova convocazione riunione, consentono di precompilare le informazioni usando stringhe di query nell'URL. Ad esempio, il bot conversazionale potrebbe inviare un messaggio a un canale con un collegamento completo a un modulo attività che comporta l'invio di una scheda come messaggio personale per un utente, che a sua volta contiene un collegamento completo per creare una nuova riunione con un utente specifico in una determinata data/ora. Usare i collegamenti diretti per connettersi tra i vari punti di estensione disponibili per l'app, mantenendo l'utente nel contesto corretto.

Pagine di contenuto Web

Una pagina di contenuto Web è una pagina Web ospitata che può essere incorporata in una scheda o in un modulo attività. Per abilitare l'incorporazione della pagina Web in un client di Microsoft Teams, è necessario:

Essere ospitato in un endpoint HTTPS.
Supporto incorporato in un <iframe> oggetto dal client di Teams.
Includere l'SDK del client JavaScript di Microsoft Teams e richiamare il metodo initialize() SDK al caricamento della pagina.

Riepilogo

Un'app di Microsoft Teams è quindi una raccolta di servizi Web, ospitati esternamente in Microsoft Teams, che sfrutta i punti di estendibilità e gli elementi dell'interfaccia utente resi disponibili tramite la piattaforma Microsoft Teams.