Connessione il bot ai canali con l'interfaccia della riga di comando di Azure
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
È 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
Telegram
È 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:
- az bot directline create
- az bot directline delete
- az bot directline show
- az bot email create
- az bot email delete
- az bot email show
- az bot facebook create
- az bot facebook delete
- az bot facebook show
- az bot msteams create
- az bot msteams delete
- az bot msteams show
- az bot skype create
- az bot skype delete
- az bot skype show
- az bot slack create
- az bot slack delete
- az bot slack show
- az bot sms create
- az bot sms delete
- az bot sms show
- az bot telegram create
- az bot telegram delete
- az bot telegram show
- az group delete