Connessione il bot ai canali con l'interfaccia della riga di comando di Azure

Articolo
10/09/2024

Un canale è una connessione tra un'applicazione di comunicazione e un bot. Un bot registrato in Azure usa canali per abilitare la comunicazione con gli utenti. I comandi di questo articolo connettono un bot a vari canali. Per altre informazioni, vedere Connessione un bot ai canali.

Prerequisiti

Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per Bash in Azure Cloud Shell.
Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.
- Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere con l'interfaccia della riga di comando di Azure.
- Quando richiesto, installare l'estensione dell'interfaccia della riga di comando di Azure al primo uso. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.
- Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.

Un bot distribuito in Azure. Se non è ancora disponibile, vedere Esercitazione: Effettuare il provisioning di un bot in Azure ed Esercitazione: Pubblicare un bot di base.

Comandi di esempio

Le sezioni seguenti usano i comandi dell'interfaccia della riga di comando di Azure per connettere un bot a un canale. Questi esempi usano un bot denominato ContosoBot nel ContosoBotRG gruppo di risorse.

Alcuni di questi canali richiedono il comando per connettersi all'applicazione per l'autenticazione. Se si eseguono questi comandi a scopo di test, possono non riuscire se non si usano valori reali.

Direct Line

Direct Line integra il bot in un'app per dispositivi mobili, in una pagina Web o in altre applicazioni. Per altre informazioni, vedere Informazioni su Direct Line.

Questi comandi di esempio creano una connessione al canale Direct Line usando az bot directline create. L'esempio mostra la connessione nella console ed elimina la connessione.

az bot directline create --resource-group ContosoBotRG --name ContosoBot --disablev1
az bot directline show --resource-group ContosoBotRG --name ContosoBot
az bot directline delete --resource-group ContosoBotRG --name ContosoBot

Posta elettronica di Office 365

È possibile abilitare il bot per comunicare con gli utenti usando la posta elettronica di Office 365. Per altre informazioni, vedere Connessione un bot alla posta elettronica di Office 365.

Questi comandi di esempio creano una connessione al canale per la posta elettronica di Office 365 usando az bot email create. L'esempio mostra la connessione nella console ed elimina la connessione.

az bot email create --resource-group ContosoBotRG --name ContosoBot \
   --email-address ContosoBot@outlook.com --password <password>
az bot email show --resource-group ContosoBotRG --name ContosoBot
az bot email delete --resource-group ContosoBotRG --name ContosoBot

Facebook

È possibile connettere il bot sia a Facebook Messenger che a Facebook Workplace. Può comunicare con gli utenti su entrambe le piattaforme. Per altre informazioni, vedere Connessione un bot su Facebook.

Questi comandi di esempio creano una connessione al canale per Facebook usando az bot facebook create. L'esempio mostra la connessione nella console ed elimina la connessione.

az bot facebook create --resource-group ContosoBotRG --name ContosoBot --appid <myAppId> \
   --page-id <myPageId> --secret <secret> --token <token>
az bot facebook show --resource-group ContosoBotRG --name ContosoBot
az bot facebook delete --resource-group ContosoBotRG --name ContosoBot

Microsoft Teams

È possibile configurare il bot per comunicare con Microsoft Teams. Per altre informazioni, vedere Connessione un bot in Microsoft Teams.

Questi comandi di esempio creano una connessione al canale per Microsoft Teams usando az bot msteams create. L'esempio mostra la connessione nella console ed elimina la connessione.

az bot msteams create --resource-group ContosoBotRG --name ContosoBot --calling-web-hook https://www.contosoapp.com/ \
   --enable-calling 
az bot msteams show --resource-group ContosoBotRG --name ContosoBot 
az bot msteams delete --resource-group ContosoBotRG --name ContosoBot

Skype

È possibile configurare il bot per comunicare con Skype. Per altre informazioni, vedere Connessione un bot in Skype.

Questi comandi di esempio creano una connessione al canale per Skype usando az bot skype create. L'esempio mostra la connessione nella console ed elimina la connessione.

az bot skype create --resource-group ContosoBotRG --name ContosoBot --enable-messaging --enable-screen-sharing
az bot skype show --resource-group ContosoBotRG --name ContosoBot 
az bot skype delete --resource-group ContosoBotRG --name ContosoBot

Slack

È possibile configurare il bot per comunicare con gli utenti tramite Slack. Per altre informazioni, vedere Connessione un bot in Slack.

Questi comandi di esempio creano una connessione al canale per Slack usando az bot slack create. L'esempio mostra la connessione nella console ed elimina la connessione.

az bot slack create --resource-group ContosoBotRG --name ContosoBot --client-id <clientid> \
   --client-secret <secret> --verification-token <token>
az bot slack show --resource-group ContosoBotRG --name ContosoBot
az bot slack delete --resource-group ContosoBotRG --name ContosoBot

SMS

Questi comandi di esempio creano una connessione al canale per SMS usando az bot sms create. L'esempio mostra la connessione nella console ed elimina la connessione.

az bot sms create --resource-group ContosoBotRG --name ContosoBot --account-sid <sid> --auth-token <token> \
   --phone <smsphonenumber> --is-validated
az bot sms show --resource-group BotRG
az bot sms delete --resource-group BotRG

È possibile configurare il bot per comunicare con gli utenti tramite Telegram. Per altre informazioni, vedere Connessione un bot a Telegram.

Questi comandi di esempio creano una connessione al canale per Telegram usando az bot telegram create. L'esempio mostra la connessione nella console ed elimina la connessione.

az bot telegram create --resource-group ContosoBotRG --name ContosoBot --access-token <token> --is-validated
az bot telegram show --resource-group ContosoBotRG --name ContosoBot 
az bot telegram delete --resource-group ContosoBotRG --name ContosoBot

Pulire la distribuzione

Se è stato creato un gruppo di risorse per il test, eseguire il comando az group delete per rimuovere il gruppo di risorse e tutto ciò che contiene.

az group delete --name ContosoBotRG

Per rimuovere una connessione a un canale, usare il comando delete appropriato.

Comandi dell'interfaccia della riga di comando di Azure usati in questo articolo

Questo articolo usa i comandi seguenti dell'interfaccia della riga di comando di Azure:

Condividi tramite