Koneksi bot Anda ke saluran dengan Azure CLI

Artikel
10/09/2024

Saluran adalah koneksi antara aplikasi komunikasi dan bot. Bot, yang terdaftar di Azure, menggunakan saluran untuk mengaktifkan komunikasi dengan pengguna. Perintah dalam artikel ini menghubungkan bot ke berbagai saluran. Untuk informasi selengkapnya, lihat Koneksi bot ke saluran.

Prasyarat

Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.
Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.
- Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.
- Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.
- Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.

Bot yang disebarkan ke Azure. Jika Anda belum memilikinya, lihat Tutorial: Menyediakan bot di Azure dan Tutorial: Menerbitkan bot dasar.

Sampel Perintah

Bagian berikut menggunakan perintah Azure CLI untuk menyambungkan bot ke saluran. Contoh-contoh ini menggunakan bot bernama ContosoBot dalam ContosoBotRG grup sumber daya.

Beberapa saluran ini memerlukan perintah untuk terhubung dengan aplikasi untuk mengautentikasi. Jika Anda menjalankan perintah ini untuk tujuan pengujian, perintah tersebut dapat gagal jika Anda tidak menggunakan nilai nyata.

Direct Line

Direct Line mengintegrasikan bot Anda ke dalam aplikasi seluler, halaman web, atau aplikasi lainnya. Untuk informasi selengkapnya, lihat Tentang Direct Line.

Contoh perintah ini membuat koneksi ke saluran Direct Line dengan menggunakan az bot directline create. Contoh menunjukkan koneksi di konsol dan menghapus koneksi.

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

Email Office 365

Anda bisa mengaktifkan bot Anda untuk berkomunikasi dengan pengguna dengan menggunakan email Office 365. Untuk informasi selengkapnya, lihat Koneksi bot ke email Office 365.

Contoh perintah ini membuat koneksi ke saluran untuk email Office 365 dengan menggunakan az bot email create. Contoh menunjukkan koneksi di konsol dan menghapus koneksi.

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

Anda dapat menghubungkan bot Anda ke Facebook Messenger dan Facebook Workplace. Ini dapat berkomunikasi dengan pengguna di kedua platform. Untuk informasi selengkapnya, lihat Koneksi bot ke Facebook.

Contoh perintah ini membuat koneksi ke saluran untuk Facebook dengan menggunakan az bot facebook create. Contoh menunjukkan koneksi di konsol dan menghapus koneksi.

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

Anda dapat mengonfigurasi bot untuk berkomunikasi dengan Microsoft Teams. Untuk informasi selengkapnya, lihat Koneksi bot ke Microsoft Teams.

Contoh perintah ini membuat koneksi ke saluran untuk Microsoft Teams dengan menggunakan az bot msteams create. Contoh menunjukkan koneksi di konsol dan menghapus koneksi.

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

Anda dapat mengonfigurasi bot untuk berkomunikasi dengan Skype. Untuk informasi selengkapnya, lihat Koneksi bot ke Skype.

Contoh perintah ini membuat koneksi ke saluran untuk Skype dengan menggunakan az bot skype create. Contoh menunjukkan koneksi di konsol dan menghapus koneksi.

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

Anda dapat mengonfigurasi bot untuk berkomunikasi dengan pengguna melalui Slack. Untuk informasi selengkapnya, lihat Koneksi bot ke Slack.

Perintah sampel ini membuat koneksi ke saluran untuk Slack dengan menggunakan az bot slack create. Contoh menunjukkan koneksi di konsol dan menghapus koneksi.

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

Contoh perintah ini membuat koneksi ke saluran untuk SMS dengan menggunakan az bot sms create. Contoh menunjukkan koneksi di konsol dan menghapus koneksi.

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

Anda dapat mengonfigurasi bot untuk berkomunikasi dengan pengguna melalui Telegram. Untuk informasi selengkapnya, lihat Koneksi bot ke Telegram.

Contoh perintah ini membuat koneksi ke saluran untuk Telegram dengan menggunakan az bot telegram create. Contoh menunjukkan koneksi di konsol dan menghapus koneksi.

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

Bersihkan penyebaran

Jika Anda membuat grup sumber daya untuk pengujian, jalankan perintah az group delete untuk menghapus grup sumber daya dan semua yang ada di dalamnya.

az group delete --name ContosoBotRG

Untuk menghapus koneksi ke saluran, gunakan perintah hapus yang sesuai.

Perintah Azure CLI digunakan dalam artikel ini

Artikel ini menggunakan perintah Azure CLI berikut:

Bagikan melalui