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

  • 5 minuti

In questo esercizio si apprenderà come creare, eseguire ed eseguire il debug del bot. Si apprenderà anche come attivare il bot per inviare una scheda adattiva a Microsoft Teams dalla riga di comando.

Creare il bot

  1. Aprire Visual Studio Code.

  2. Nella barra laterale selezionare l'icona di Microsoft Teams per aprire il pannello TEAMS TOOLKIT .

  3. Nel pannello TEAMS TOOLKIT selezionare il pulsante Crea una nuova app .

  4. Nel menu Nuovo progetto selezionare Bot.

    Screenshot di Visual Studio Code che mostra le selezioni per iniziare a creare un nuovo bot usando Teams Toolkit.

  5. Nel menu Funzionalità dell'app Usando un bot selezionare la funzionalità Messaggio di notifica chat.

    Screenshot di Visual Studio Code che mostra le funzionalità dell'app usando un menu Bot per Teams Toolkit e la funzionalità Messaggio di notifica chat.

  6. Nel menu Scegli trigger selezionare Trigger HTTP (Funzioni di Azure).

  7. Nel menu Linguaggio di programmazione selezionare JavaScript.

  8. Nel menu Cartella area di lavoro selezionare Cartella predefinita.

  9. Nel campo Nome applicazione immettere Avvisi ticket di supporto e quindi selezionare la chiave INVIO.

Teams Toolkit crea automaticamente il progetto e i file di codice sorgente.

Nota

È possibile ricevere un messaggio da Visual Studio Code che chiede se si considerano attendibili gli autori dei file in questa cartella. Selezionare il pulsante Sì, si considera attendibile il pulsante autori per continuare.

Screenshot di Visual Studio Code che mostra il file leggimi per il modello di bot di notifica e i file di codice nel riquadro Esplora risorse.

Eseguire ed eseguire il debug

Ora è il momento di eseguire il bot per la prima volta.

  1. Sulla barra laterale selezionare l'icona Debug per aprire il pannello ESEGUI E DEBUG .

  2. Nel pannello ESEGUI E DEBUG selezionare Chrome o Edge nella casella di riepilogo a discesa come browser che si vuole usare per eseguire il debug del bot. Selezionare quindi il pulsante Riproduci (o selezionare il tasto F5) per avviare la sessione di debug.

    Screenshot di Visual Studio Code che mostra il codice del bot di notifica, il riquadro di debug e le attività del terminale.

    Nota

    Se non è stato eseguito l'accesso al tenant di Microsoft 365, verrà richiesto. Selezionare Accedi e seguire la procedura di accesso per autenticare Teams Toolkit con il tenant di Microsoft 365.

    Teams Toolkit distribuisce, configura e avvia tutti i componenti necessari. Apre anche una finestra del browser e passa a Microsoft Teams.

  3. Nella finestra di dialogo di installazione selezionare il pulsante Aggiungi per installare l'app come app personale.

È tutto. Il bot è installato, in esecuzione in Teams e pronto per il test.

Screenshot del client Web di Teams che mostra una finestra di chat bot vuota per gli avvisi dei ticket di supporto.

Attivare un messaggio proattivo

Usando uno strumento da riga di comando, inviare una richiesta HTTP POST all'endpoint di notifica ospitato nel server Web locale per attivare il bot per inviare un messaggio a Teams.

curl -X POST http://localhost:3978/api/notification

Il bot invia una scheda adattiva alla chat di Teams.

Screenshot del client Web di Teams che mostra una scheda adattiva pubblicata nella chat del bot per gli avvisi dei ticket di supporto.

Chiudere la finestra del browser per arrestare la sessione di debug.