Połączenie bota do kanałów za pomocą interfejsu wiersza polecenia platformy Azure

Artykuł
10/24/2023

Kanał to połączenie między aplikacją komunikacji a botem. Bot zarejestrowany na platformie Azure używa kanałów w celu umożliwienia komunikacji z użytkownikami. Polecenia w tym artykule łączą bota z różnymi kanałami. Aby uzyskać więcej informacji, zobacz Połączenie bota do kanałów.

Wymagania wstępne

Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący powłoki Bash w usłudze Azure Cloud Shell.
Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie interfejsu wiersza polecenia platformy Azure w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić interfejs wiersza polecenia platformy Azure w kontenerze platformy Docker.
- Jeśli korzystasz z instalacji lokalnej, zaloguj się do interfejsu wiersza polecenia platformy Azure za pomocą polecenia az login. Aby ukończyć proces uwierzytelniania, wykonaj kroki wyświetlane w terminalu. Aby uzyskać inne opcje logowania, zobacz Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure.
- Po wyświetleniu monitu zainstaluj rozszerzenie interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Korzystanie z rozszerzeń w interfejsie wiersza polecenia platformy Azure.
- Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.

Bot wdrożony na platformie Azure. Jeśli jeszcze go nie masz, zobacz Samouczek: aprowizuj bota na platformie Azure i Samouczek: publikowanie podstawowego bota.

Przykładowe polecenia

W poniższych sekcjach użyto poleceń interfejsu wiersza polecenia platformy Azure, aby połączyć bota z kanałem. W tych przykładach użyto bota o nazwie ContosoBot w ContosoBotRG grupie zasobów.

Niektóre z tych kanałów wymagają polecenia w celu nawiązania połączenia z aplikacją w celu uwierzytelnienia. Jeśli używasz tych poleceń do celów testowych, mogą one zakończyć się niepowodzeniem, jeśli nie używasz rzeczywistych wartości.

Direct Line

Direct Line integruje bota z aplikacją mobilną, stroną internetową lub innymi aplikacjami. Aby uzyskać więcej informacji, zobacz About Direct Line (Informacje o linii bezpośredniej).

Te przykładowe polecenia tworzą połączenie z kanałem Direct Line przy użyciu polecenia az bot directline create. W przykładzie pokazano połączenie w konsoli programu i usunięto połączenie.

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

Poczta e-mail usługi Office 365

Możesz zezwolić botowi na komunikowanie się z użytkownikami przy użyciu poczty e-mail usługi Office 365. Aby uzyskać więcej informacji, zobacz Połączenie bota do poczty e-mail usługi Office 365.

Te przykładowe polecenia tworzą połączenie z kanałem poczty e-mail usługi Office 365 przy użyciu polecenia az bot email create. W przykładzie pokazano połączenie w konsoli programu i usunięto połączenie.

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

Możesz połączyć bota zarówno z Facebook Messenger, jak i Facebook Workplace. Może komunikować się z użytkownikami na obu platformach. Aby uzyskać więcej informacji, zobacz Połączenie bota na Facebooku.

Te przykładowe polecenia tworzą połączenie z kanałem usługi Facebook przy użyciu polecenia az bot facebook create. W przykładzie pokazano połączenie w konsoli programu i usunięto połączenie.

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

Bot można skonfigurować tak, aby komunikował się z usługą Microsoft Teams. Aby uzyskać więcej informacji, zobacz Połączenie bota do usługi Microsoft Teams.

Te przykładowe polecenia tworzą połączenie z kanałem dla usługi Microsoft Teams przy użyciu polecenia az bot msteams create. W przykładzie pokazano połączenie w konsoli programu i usunięto połączenie.

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

Bota można skonfigurować tak, aby komunikował się ze skypem. Aby uzyskać więcej informacji, zobacz Połączenie bota do skype'a.

Te przykładowe polecenia tworzą połączenie z kanałem dla programu Skype przy użyciu polecenia az bot skype create. W przykładzie pokazano połączenie w konsoli programu i usunięto połączenie.

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

Bot można skonfigurować tak, aby komunikował się z użytkownikami za pośrednictwem usługi Slack. Aby uzyskać więcej informacji, zobacz Połączenie bota do usługi Slack.

Te przykładowe polecenia tworzą połączenie z kanałem dla usługi Slack przy użyciu polecenia az bot slack create. W przykładzie pokazano połączenie w konsoli programu i usunięto połączenie.

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

Wiadomości SMS

Te przykładowe polecenia tworzą połączenie z kanałem dla wiadomości SMS przy użyciu polecenia az bot sms create. W przykładzie pokazano połączenie w konsoli programu i usunięto połączenie.

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

Bot można skonfigurować tak, aby komunikował się z użytkownikami za pośrednictwem usługi Telegram. Aby uzyskać więcej informacji, zobacz Połączenie bota do telegramu.

Te przykładowe polecenia tworzą połączenie z kanałem usługi Telegram przy użyciu polecenia az bot telegram create. W przykładzie pokazano połączenie w konsoli programu i usunięto połączenie.

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

Czyszczenie wdrożenia

Jeśli utworzono grupę zasobów na potrzeby testowania, uruchom polecenie az group delete , aby usunąć grupę zasobów i wszystko, co zawiera.

az group delete --name ContosoBotRG

Aby usunąć połączenie z kanałem, użyj odpowiedniego polecenia delete.

Polecenia interfejsu wiersza polecenia platformy Azure używane w tym artykule

W tym artykule są używane następujące polecenia interfejsu wiersza polecenia platformy Azure: