Pubblicare un'app personalizzata inviata con l'API di invio dell'app Teams

  • Articolo
  • 7 minuti per la lettura
  • Si applica a:
    Microsoft Teams

Questo articolo fornisce indicazioni end-to-end su come portare l'app Teams dallo sviluppo alla distribuzione alla scoperta. Verrà fornita una panoramica delle esperienze connesse fornite da Teams per tutto il ciclo di vita delle app per semplificare lo sviluppo, la distribuzione e la gestione di app personalizzate nell'App Store dell'organizzazione.

Tratteremo ogni passaggio del ciclo di vita, incluso il modo in cui gli sviluppatori possono usare l'API di invio di app di Teams per inviare app personalizzate direttamente all'interfaccia di amministrazione di Microsoft Teams da rivedere e approvare, come impostare criteri per gestire le app per gli utenti dell'organizzazione e come gli utenti le individuano in Teams.

Panoramica dell'app dallo sviluppo alla distribuzione.

Queste linee guida sono incentrate sugli aspetti di Teams dell'app ed sono destinate agli amministratori e ai professionisti IT. Per informazioni sullo sviluppo di app di Teams, vedere la documentazione per sviluppatori di Teams.

Nota

Quando si pubblica un'app teams personalizzata, questa è disponibile per gli utenti nell'app store dell'organizzazione. Esistono due modi per pubblicare un'app personalizzata e il modo in cui usi dipende da come ottieni l'app. Questo articolo è incentrato su come approvare e pubblicare un'app personalizzata che uno sviluppatore invia tramite l'API di invio di app di Teams. L'altro metodo, il caricamento di un'app personalizzata, viene usato quando uno sviluppatore invia un pacchetto dell'app in formato .zip. Per altre informazioni su questo metodo, vedere Pubblicare un'app personalizzata caricando un pacchetto dell'app. Il widget approvazione app non è disponibile nei tenant GCC.

Importante

Questo metodo non è attualmente disponibile per gli ambienti GCC. In GCC usare il metodo di caricamento di un'app personalizzata .

Sviluppo

Creare l'app

La piattaforma per sviluppatori di Microsoft Teams consente agli sviluppatori di integrare facilmente le proprie app e i propri servizi per migliorare la produttività, prendere decisioni più velocemente e creare collaborazione attorno a contenuti e flussi di lavoro esistenti. Le app basate sulla piattaforma Teams sono ponti tra il client di Teams e i servizi e i flussi di lavoro, inserendoli direttamente nel contesto della piattaforma di collaborazione. Per altre informazioni, vedere la documentazione per sviluppatori di Teams.

Inviare l'app

Quando l'app è pronta per l'uso in produzione, lo sviluppatore può inviare l'app utilizzando l'API invio app Teams, che può essere chiamata da API Graph, un ambiente di sviluppo integrato (IDE) come Visual Studio Code o una piattaforma come Power Apps e Power Virtual Agents. In questo modo l'app è disponibile nella pagina Gestisci app dell'interfaccia di amministrazione di Teams, dove è possibile rivederla e approvarla.

L'API di invio delle app di Teams, basata su Microsoft Graph, consente alla tua organizzazione di sviluppare sulla piattaforma che preferisci e automatizza il processo di invio all'approvazione per le app personalizzate su Teams.

Ecco un esempio dell'aspetto di questo passaggio di invio dell'app in Visual Studio Code:

l'invio di un'app in Visual Studio Code.

Tenere presente che l'app non viene ancora pubblicata nell'app store dell'organizzazione. Questo passaggio invia l'app all'interfaccia di amministrazione di Teams, in cui è possibile approvarla per la pubblicazione nell'app store dell'organizzazione.

Per altre informazioni sull'uso della API Graph per l'invio di app, vedi qui.

Notificare

Puoi attivare le notifiche in modo da sapere quando gli sviluppatori inviano una nuova applicazione per la revisione e l'approvazione. Riceverai anche notifiche quando gli sviluppatori inviano gli aggiornamenti delle app. Per abilitare le notifiche di invio di app nell'interfaccia di amministrazione di Teams, passare a Notifiche & avvisi > Invii all'app Regole > e attivare la regola impostando lo stato su Attivo. Per impostazione predefinita, questa impostazione è disattivata. Per attivare questa impostazione, è necessario essere un amministratore globale o di Teams.

Dopo aver attivato questa impostazione, riceverai le notifiche nel team di Amministrazione Avvisi e notifiche in un nuovo canale denominato Invii di app. In alternativa, puoi scegliere un team e un canale esistenti per ricevere le notifiche a un team e un canale specifici. A tale scopo, eseguire la procedura seguente:

  1. Nella regola Invio di app selezionare la casella di controllo Avviso canale in Azioni.

  2. Scegliere il pulsante Seleziona canale .

  3. Cercare un team da aggiungere.

  4. Cercare un canale da aggiungere.

  5. Selezionare Applica.

    Casella di controllo notifica di avviso canale personalizzato.

Nota

Selezionare la casella di controllo Avviso canale predefinito per ricevere notifiche al team di Amministrazione avvisi e notifiche nel canale Invii di app.

Casella di controllo Notifica di avviso canale predefinita.

È anche possibile configurare le notifiche su un webhook esterno specificando un URL webhook pubblico dopo aver selezionato la casella di controllo Webhook . Un payload di notifica JSON verrà inviato all'URL webhook.

Notifica di invio di app.

Dopo aver configurato la regola per gli invii di app, è possibile esaminare le schede di notifica nel canale specificato per visualizzare i dettagli dell'app e selezionare Visualizza dettagli per aprire le app nell'interfaccia di amministrazione di Teams.

Convalidare

La pagina Gestisci app nell'interfaccia di amministrazione di Teams (nel riquadro di spostamento sinistro, passa alle app > di Teams Gestisci app), offre una visualizzazione di tutte le app di Teams per l'organizzazione. Il widget Approvazione in sospeso nella parte superiore della pagina consente di sapere quando viene inviata un'app personalizzata per l'approvazione.

Nella tabella, un'app appena inviata mostra automaticamente lo stato Pubblicazione inviato e lo stato del blocco. È possibile ordinare la colonna Stato pubblicazione in ordine decrescente per trovare rapidamente l'app.

Stato pubblicazione.

Fare clic sul nome dell'app per passare alla pagina dei dettagli dell'app. Nella scheda Informazioni è possibile visualizzare i dettagli dell'app, tra cui descrizione, stato, utente di invio e ID app.

Pagina dei dettagli dell'app per un'app inviata.

Per altre informazioni sull'uso della API Graph per controllare lo stato pubblicazione, vedere qui.

Pubblicare

Quando si è pronti per rendere l'app disponibile agli utenti, pubblicare l'app.

  1. Accedere all'interfaccia di amministrazione di Teams e passare alle app > di Teams**Gestire le app**.

  2. Selezionare il nome dell'app per passare alla pagina dei dettagli dell'app, quindi nella casella Stato pubblicazione selezionare Pubblica.

    Pulsante Pubblica nella pagina dei dettagli dell'app.

Dopo la pubblicazione dell'app, lo stato pubblicazione diventa Pubblicato e lo stato diventa Consentito.

Configurare e gestire

Controllare l'accesso all'app

Per impostazione predefinita, tutti gli utenti dell'organizzazione possono accedere all'app nell'app store dell'organizzazione. Per limitare e controllare chi è autorizzato a usare l'app, è possibile creare e assegnare criteri di autorizzazione per l'app. Per altre informazioni, vedere Gestire i criteri di autorizzazione delle app in teams.

Aggiungere e installare l'app per consentire agli utenti di individuare

Per impostazione predefinita, gli utenti possono trovare l'app che devono accedere all'App Store dell'organizzazione ed esplorarla o cercarla. Per consentire agli utenti di accedere facilmente all'app, è possibile aggiungere l'app alla barra dell'app in Teams. A questo scopo, creare un criterio di configurazione dell'app e assegnarlo agli utenti. Per altre informazioni, vedere Gestire i criteri di configurazione delle app in teams.

Cercare gli eventi dell'app Teams nel log di controllo

È possibile eseguire ricerche nel log di controllo per visualizzare l'attività delle app di Teams nell'organizzazione. Per altre informazioni su come eseguire ricerche nel log di controllo e visualizzare un elenco delle attività di Teams registrate nel log di controllo, vedere Cercare eventi in Teams nel log di controllo.

Prima di poter eseguire ricerche nel log di audit, è necessario attivare il controllo nel Centro sicurezza e conformità. Per altre informazioni, vedere Attivare o disattivare la ricerca nel log di controllo. Tenere presente che i dati di controllo sono disponibili solo dal momento in cui è stato attivato il controllo.

Scopri e adotta

Gli utenti che hanno le autorizzazioni per l'app possono trovarla nell'app store dell'organizzazione. Passare a Built for Your Organization Name nella pagina App per trovare le app personalizzate dell'organizzazione.

Pagina App che mostra l'app pubblicata.

Se hai creato e assegnato un criterio di configurazione dell'app, l'app viene aggiunta alla barra dell'app in Teams per facilitare l'accesso agli utenti a cui sono stati assegnati i criteri.

Update

Per aggiornare un'app, gli sviluppatori devono continuare a seguire i passaggi descritti nella sezione Sviluppo .

Quando lo sviluppatore invia un aggiornamento a un'app personalizzata pubblicata, si riceverà una notifica nel widget Approvazione in sospeso della pagina Gestisci app . Nella tabella , lo stato pubblicazione dell'app verrà impostato su Aggiornamento inviato. Se hai attivato le notifiche di invio delle app, riceverai una notifica anche nel team di avvisi e notifiche di Amministrazione nel canale di invio delle app. La scheda di notifica avrà un collegamento per portarti direttamente all'app nell'interfaccia di amministrazione di Teams. Per altre informazioni su come attivare le notifiche di invio delle app, vedi Notifica.

Pagina Gestisci app che mostra le richieste in sospeso e lo stato dell'app.

Per rivedere e pubblicare un aggiornamento dell'app:

  1. Nella barra di spostamento sinistra dell'interfaccia di amministrazione di Teams, passare alle app > di Teams****Gestire le app.

  2. Fare clic sul nome dell'app per passare alla pagina dei dettagli dell'app e quindi selezionare Aggiorna disponibile per rivedere i dettagli dell'aggiornamento.

    Pagina dei dettagli dell'app.

  3. Quando sei pronto, seleziona Pubblica per pubblicare l'aggiornamento. In questo modo l'app esistente viene sostituita, il numero di versione viene aggiornato e lo stato Pubblicazione diventa Pubblicato. Tutti i criteri di autorizzazione e i criteri di configurazione delle app rimangono applicati per l'app aggiornata.

    Se si rifiuta l'aggiornamento, la versione precedente dell'app rimane pubblicata.

Tenere presente quanto segue:

  • Quando un'app viene approvata, chiunque può inviare un aggiornamento all'app. Ciò significa che altri sviluppatori, incluso lo sviluppatore che ha inviato originariamente l'app, possono inviare un aggiornamento all'app.
  • Quando uno sviluppatore invia un'app e la richiesta è in sospeso, solo lo stesso sviluppatore può inviare un aggiornamento all'app. Altri sviluppatori possono inviare un aggiornamento solo dopo l'approvazione dell'app.

Per altre informazioni sull'uso della API Graph per aggiornare le app, vedere qui.