Připojení robota do kanálů pomocí Azure CLI

Článek
10/24/2023

Kanál je propojení mezi komunikační aplikací a robotem. Robot zaregistrovaný v Azure používá kanály k povolení komunikace s uživateli. Příkazy v tomto článku připojují robota k různým kanálům. Další informace najdete v tématu Připojení robota do kanálů.

Předpoklady

Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Rychlý start pro Bash v Azure Cloud Shellu.
Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.
- Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Přihlášení pomocí Azure CLI.
- Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.
- Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

Robot nasazený do Azure. Pokud ho ještě nemáte, přečtěte si kurz : Zřízení robota v Azure a kurz: Publikování základního robota.

Ukázkové příkazy

Následující části používají příkazy Azure CLI k připojení robota k kanálu. Tyto příklady používají robota pojmenovaného ContosoBot ContosoBotRG ve skupině prostředků.

Některé z těchto kanálů vyžadují, aby se příkaz připojil k aplikaci k ověření. Pokud tyto příkazy spouštíte pro účely testování, můžou selhat, pokud nepoužíváte skutečné hodnoty.

Direct Line

Direct Line integruje robota do mobilní aplikace, webové stránky nebo jiných aplikací. Další informace naleznete v tématu O přímé lince.

Tyto ukázkové příkazy vytvoří připojení k kanálu Direct Line pomocí příkazu az bot directline create. Příklad ukazuje připojení v konzole a odstraní připojení.

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

E-mail v Office 365

Robotovi můžete povolit komunikaci s uživateli pomocí e-mailu Office 365. Další informace najdete v tématu Připojení robota k e-mailu Office 365.

Tyto ukázkové příkazy vytvoří připojení k e-mailu Office 365 pomocí příkazu az bot email create. Příklad ukazuje připojení v konzole a odstraní připojení.

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

Robota můžete připojit jak k Facebook Messengeru, tak k Facebooku Na pracovišti. Může komunikovat s uživateli na obou platformách. Další informace najdete v tématu Připojení robota na Facebooku.

Tyto ukázkové příkazy vytvoří připojení k kanálu pro Facebook pomocí příkazu az bot facebook create. Příklad ukazuje připojení v konzole a odstraní připojení.

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

Robota můžete nakonfigurovat tak, aby komunikovali s Microsoft Teams. Další informace najdete v tématu Připojení robota do Microsoft Teams.

Tyto ukázkové příkazy vytvoří připojení k kanálu pro Microsoft Teams pomocí příkazu az bot msteams create. Příklad ukazuje připojení v konzole a odstraní připojení.

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

Robota můžete nakonfigurovat tak, aby komunikovali se Skypem. Další informace najdete v tématu Připojení robota do Skypu.

Tyto ukázkové příkazy vytvoří připojení ke kanálu pro Skype pomocí příkazu az bot skype create. Příklad ukazuje připojení v konzole a odstraní připojení.

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

Robota můžete nakonfigurovat tak, aby komunikovali s uživateli přes Slack. Další informace najdete v tématu Připojení robota do Slacku.

Tyto ukázkové příkazy vytvoří připojení ke kanálu pro Slack pomocí příkazu az bot slack create. Příklad ukazuje připojení v konzole a odstraní připojení.

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

Tyto ukázkové příkazy vytvoří připojení ke kanálu sms pomocí příkazu az bot sms create. Příklad ukazuje připojení v konzole a odstraní připojení.

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

Robota můžete nakonfigurovat tak, aby komunikovali s uživateli prostřednictvím AplikaceGraf. Další informace najdete v tématu Připojení robota do AplikaceGraf.

Tyto ukázkové příkazy vytvoří připojení k kanálu Pro Aplikaci Pomocí příkazu az botgraf create. Příklad ukazuje připojení v konzole a odstraní připojení.

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

Vyčištění nasazení

Pokud jste vytvořili skupinu prostředků pro testování, spuštěním příkazu az group delete odeberte skupinu prostředků a vše, co obsahuje.

az group delete --name ContosoBotRG

Pokud chcete odebrat připojení ke kanálu, použijte příslušný příkaz pro odstranění.

Příkazy Azure CLI použité v tomto článku

Tento článek používá následující příkazy Azure CLI:

Sdílet prostřednictvím