Integrazione con Microsoft Teams

IBM Cloud

Aggiungete un chatbot a Microsoft Teams per creare e personalizzare un hub produttivo dove contenuti, strumenti e persone si incontrano per chattare, incontrarsi e collaborare.

Dopo aver creato un'azione, è possibile utilizzare questa integrazione per collegare l'assistente a Microsoft Teams.

Prima di iniziare

Per integrare l'assistente con Microsoft Teams, è necessario avere i ruoli Global Administrator o Teams Administrator. Per ulteriori informazioni, vedi Politiche di autorizzazione dell'app.

Registrati per un indirizzo email di Microsoft 365 Developer Administrator, se non ne hai uno:

Vai al Microsoft Dev Center.
Fare clic su Iscriviti ora per diventare membro del programma Microsoft 365 Developer.
Nel dashboard, fare clic su Configura sottoscrizione E5 e selezionare una sandbox Instant o Configurable.
Copiare l'indirizzo email elencato in Amministratore. Le tue credenziali di amministratore sono richieste in diversi punti di configurazione.

Aggiunta dell'integrazione Microsoft Teams

Vai alla pagina Integrazioni facendo clic sull'icona delle integrazioni () nel menu a sinistra.
Fare clic su Aggiungi nel riquadro Microsoft Teams piastrella.
Fare clic su Conferma. La pagina Introduzione fornisce un riepilogo del processo di configurazione.
Fare clic su Avanti per avviare la registrazione dell'applicazione.

Registrazione dell'app

Vai al portale Microsoft Azuree accedi con le tue credenziali di amministratore.
Nella pagina Registrazioni app, fare clic su Nuova registrazione.
Nella pagina Registra un'applicazione, immetti un nome, seleziona l'opzione a più tenant che si applica alla tua applicazione e fai clic su Registra.
Copiate l'ID dell'applicazione dalla pagina Panoramica della vostra app e incollatelo nel campo di registrazione dell'app dell'integrazione watsonx Assistant Microsoft Teams.
Nella stessa pagina Microsoft Azure Panoramica, fare clic sul collegamento ipertestuale Aggiungi un certificato o un segreto accanto a Credenziali client.
Nella pagina Certificati & segreti per la creazione del token, fare clic su Nuovo segreto client. Immettere una descrizione e selezionare Consigliato 180 giorni. Fai clic su Aggiungi.
Copiare la stringa in Valore e incollarla nel Valore segreto del cliente nella pagina di registrazione dell'app dell'integrazione watsonx Assistant Microsoft Teams. Nota: è necessario creare un nuovo valore prima che quello corrente scada il giorno 180.
Fare clic su Avanti per creare il bot.

Crea il tuo bot

Accedi a Microsoft Bot Framework developer portale accedi con le credenziali di amministratore.
Nella pagina Parlaci del tuo bot, completa il tuo profilo bot.
Copiare l'endpoint generato dalla pagina Create your bot dell'integrazione watsonx Assistant Microsoft Teams e incollarlo nel campo Messaging endpoint della sezione Configuration.
Selezionare Multi-Tenant come tipo di applicazione.
Copia e incolla il tuo ID applicazione, quindi fai clic su Register.
Nella pagina Connessione ai canali, fare clic su Configura canale Microsoft Teams nella sezione Aggiungi un canale in primo piano.
Nella pagina Configura Microsoft Teams, specificare le opzioni nelle schede Messaggistica, Chiamate e Pubblicazione che soddisfano le esigenze del bot, quindi fare clic su Salva.
Nell'integrazione watsonx Assistant Microsoft Teams, fare clic su Avanti per creare l'app Teams.

Crea la tua app Teams

Accedere al portale degli sviluppatori di Microsoft Teams ed effettuare il login con le proprie credenziali di amministratore.
Nella scheda Applicazioni, fare clic su Nuova applicazione.
Immettere un nome e fare clic su Aggiungi.
Nella pagina Informazioni di base, immetti i nomi dell'applicazione, l'ID applicazione, le descrizioni, le informazioni sullo sviluppatore e gli URL dell'applicazione e copia e incolla il tuo ID applicazione in ID applicazione (client). Fare clic su Salva.
Nella sezione Configure, seleziona App features e quindi Bot.
Nella pagina Identifica il tuo bot, seleziona il tuo bot.
Nella sezione Seleziona l'ambito in cui le persone possono utilizzare questo comando, selezionare Personale, Team e Conversazione di gruppo.
Fare clic su Salva, ma tenere aperta la finestra.
Nell'integrazione di watsonx Assistant Microsoft Teams, fare clic su Fine.
Fai clic su Pubblica per pubblicare il tuo bot.

Quando un'estensione personalizzata viene eseguita durante una conversazione in Microsoft Teams, il client riceve le fasi di pre-esecuzione solo dopo il completamento della chiamata all'estensione. Per ulteriori informazioni, vedere chiamare un interno personalizzato.

Pubblicazione della tua app Teams

Nella finestra del portale per sviluppatori Microsoft Teams in cui è stata creata e salvata l'applicazione Teams, fare clic su Pubblica per pubblicare il bot.
Fai clic su Scarica il pacchetto dell'app.
Andare a Microsoft Teams e accedere con le proprie credenziali di amministratore.
Fai clic su Apps nel menu della barra laterale, quindi su Manage your apps e Upload an app.
Selezionate Carica un'app personalizzata e specificate il file compresso del pacchetto app scaricato.
Fare clic su Aggiungi per terminare.
Verifica le tue azioni e risposte nella sezione Chat della tua applicazione Teams.

Tipi di risposta

Questi tipi di risposta sono supportati e vengono visualizzati come previsto quando l'assistente viene distribuito per i messaggi diretti, i canali o le chat di gruppo di Microsoft Teams.

date
immagine
opzione
suggerimento
text

Limitazioni

In Microsoft Teams, i pulsanti di opzione, siano essi resi da un'azione o da un nodo di dialogo, rimangono attivi dopo la loro selezione. Questi pulsanti possono essere cliccati più volte durante una conversazione e ogni ulteriore clic ripropone lo stesso payload a watsonx Assistant. Questo comportamento può comportare una duplicazione dell'elaborazione e può portare a risposte di follow-up inattese o errate.

Questa limitazione è specifica del canale Microsoft Teams. In altri canali, come la chat web e la pagina Try it Out di watsonx Assistant, i pulsanti di opzione sono disattivati dopo il primo clic e non possono essere riselezionati.