Connettere un bot a Microsoft Teams

  • Articolo

SI APPLICA A: SDK v4

È possibile configurare il bot per comunicare con gli utenti tramite Microsoft Teams. Questo articolo descrive come creare un'app Teams in Teams, connettere il bot all'app Teams in Azure e quindi testare il bot in Teams.

Prerequisiti

  • Una sottoscrizione di Azure. Se non se ne ha già uno, creare un account gratuito prima di iniziare.
  • Un bot pubblicato in Azure che si vuole connettere a Teams.
  • Tenant per sviluppatori in Teams con caricamento di app personalizzate o trasferimento locale abilitato. Per altre informazioni, vedere Preparare il tenant di Microsoft 365.
  • Pacchetto dell'app Teams valido. Per altre informazioni, vedere Caricare l'app in Microsoft Teams.

Configurare il bot in Azure

  1. Apri il portale di Azure.
  2. Aprire il pannello delle risorse di Azure Bot per il bot.
  3. Aprire i canali e selezionare Microsoft Teams:
    1. Leggere e accettare le condizioni per il servizio.
    2. Nella scheda Messaggistica selezionare l'ambiente cloud per il bot. Per altre informazioni, vedere la sezione Post-compilazione di Pianificare l'app con le funzionalità di Teams.
    3. Selezionare Applica.
  4. Selezionare Recupera codice di incorporamento del bot, individuare il codice di incorporamento per Teams e quindi copiare la parte https del codice. Ad esempio: https://teams.microsoft.com/l/chat/0/0?users=28:b8a22302e-9303-4e54-b348-343232. È possibile usare questo codice per testare il bot in Teams.

Suggerimento

  • La scheda Chiamate supporta la funzionalità di chiamata di Teams. Per altre informazioni, vedere Registrare chiamate e bot riunioni per Microsoft Teams.
  • La scheda Pubblica contiene informazioni su come pubblicare l'app Teams in Teams Store.
  • Microsoft Azure gestito da 21Vianet non supporta la funzionalità Get bot embed code (Ottieni codice di incorporamento bot). Per testare il canale Teams, creare l'app Teams e distribuirla usando i passaggi indicati di seguito.

Testare il bot in Teams

I bot nell'ambiente di produzione devono essere aggiunti a Teams come parte di un'app Teams. Per altre informazioni, vedere Testare l'app.

Importante

L'aggiunta di un bot tramite GUID, per scopi diversi dai test, non è consigliata. Questa operazione limita infatti notevolmente la funzionalità di un bot. Per aggiungere bot in produzione a Teams, è necessario includerli in un'app.

  1. Nel browser aprire l'URL copiato dal codice di incorporamento, quindi scegliere l'app Microsoft Teams (client o Web) usata per aggiungere il bot a Teams. Dovrebbe essere possibile visualizzare il bot elencato come contatto a cui è possibile inviare e ricevere messaggi da Microsoft Teams.
  2. Interagire con il bot in Teams.

Suggerimento

Usare una registrazione del canale bot per ogni ambiente, poiché l'endpoint cambia quando si passa tra ambienti di sviluppo, gestione temporanea e produzione locali.

L'eliminazione della registrazione del canale di Teams causerà la generazione di una nuova coppia di chiavi quando viene riabilitata. Ciò invalida tutti gli ID 29:xxx e a:xxx archiviati dal bot per la messaggistica proattiva.

Pubblicare il bot in Teams

Per istruzioni su come pubblicare l'app, vedere la panoramica di Teams su come distribuire l'app Microsoft Teams. E gli articoli associati illustrano come:

  • Scegliere e configurare le opzioni di installazione per il bot
  • Creare il manifesto, l'icona e il pacchetto dell'app Teams
  • Caricare l'app in Teams
  • Pubblicare l'app nell'organizzazione o nello Store di Teams

Informazioni aggiuntive