Creare un bot in grado di inviare messaggi proattivi a Microsoft Teams

  • 3 minuti

L'estensione Teams Toolkit per Visual Studio Code fornisce diversi modelli di app basati su scenari per la compilazione di bot. Il modello di app basata sullo scenario del bot di notifica chat crea un bot che può essere attivato per inviare una notifica proattiva a Microsoft Teams. Un messaggio proattivo è un messaggio inviato in risposta a un evento o un trigger esterno. Questo modello verrà usato per creare un bot nell'unità successiva.

Nota

L'esercizio in questo modulo usa Teams Toolkit v5.0.0.

Componenti per la compilazione di un bot

Per sviluppare un bot per Teams, è necessario:

  • Un server Web per ospitare ed eseguire il codice del bot.
  • Un bot del servizio Azure Bot per rendere il bot disponibile per Teams.
  • Un'app Microsoft Entra per registrare il bot con Microsoft Cloud.
  • Un servizio tunnel HTTP per fornire un URL accessibile pubblicamente per l'endpoint locale usato per ricevere messaggi dal servizio bot.
  • Pacchetto dell'app Microsoft Teams per distribuire il bot in Teams. Questo pacchetto include il file manifesto dell'app, che descrive le funzionalità del bot e dove è possibile installare il bot (chat, canale, riunione, app personale).

Configurazione semplificata

Teams Toolkit per Visual Studio Code gestisce la complessità della creazione e della configurazione delle risorse necessarie per sviluppare un bot. Quando si esegue il bot per la prima volta, viene eseguita automaticamente la procedura seguente:

  1. Verifica e installa i prerequisiti.
  2. Avvia un tunnel HTTP usando il servizio VisualStudio Dev Tunnels.
  3. Crea una registrazione dell'app Microsoft Entra.
  4. Crea una registrazione del servizio Azure Bot.
  5. Compila il codice del bot e avvia un server Web locale.
  6. Genera un pacchetto dell'app Teams.
  7. Distribuisce il pacchetto dell'app in Teams.
  8. Avvia una sessione di debug.
  9. Apre una finestra del browser, passa a un client Web di Teams e visualizza una finestra di dialogo di installazione dell'app.

Messaggi proattivi

Per attivare l'invio di un messaggio proattivo a Teams, è necessario inviare una richiesta HTTP POST all'endpoint di notifica ospitato nel server Web locale. È possibile usare qualsiasi client HTTP per inviare la richiesta. Ad esempio, è possibile usare uno strumento da riga di comando come cURL o PowerShell, un'applicazione desktop come Postman o un servizio cloud come Funzioni di Azure.

Schede adattive

Un bot può inviare schede interattive denominate schede adattive a Teams come messaggi proattivi. Le schede adattive offrono un modo potente e flessibile per creare esperienze complete, coerenti e interattive che possono essere usate in un'ampia gamma di piattaforme e dispositivi.

Nell'esercizio successivo si apprenderà come creare un bot per Teams usando il modello di app basato su scenario bot di notifica . Si apprenderà anche come attivare il bot per inviare una scheda adattiva a Teams dalla riga di comando.