Conectar seu bot a canais com a CLI do Azure

Artigo
12/29/2023

Canal é uma conexão entre um aplicativo de comunicação e um bot. Um bot, registrado no Azure, usa canais para habilitar a comunicação com os usuários. Os comandos neste artigo conectam um bot a vários canais. Para obter mais informações, confira Conectar um canal a canais.

Pré-requisitos

Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.
Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.
- Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.
- Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.
- Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

Um bot implantado no Azure Se você ainda não tiver um, confira Tutorial: provisionar um bot no Azure e Tutorial: publicar um bot básico.

Comandos de exemplo

As seções a seguir usam comandos da CLI do Azure para conectar um bot a um canal. Esses exemplos usam um bot nomeado ContosoBot no grupo de recursos ContosoBotRG.

Alguns desses canais exigem que o comando se conecte ao aplicativo para autenticação. Se você estiver executando esses comandos para fins de teste, eles poderão falhar se você não usar valores reais.

Direct Line

O Direct Line integra seu bot a um aplicativo móvel, página da Web ou outros aplicativos. Para obter mais informações, confira Sobre o Direct Line.

Esses comandos de exemplo criam uma conexão com o canal do Direct Line usando az bot directline create. O exemplo mostra a conexão no console e exclui a conexão.

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 do Office 365

Você pode habilitar seu bot para se comunicar com os usuários usando o email do Office 365. Para obter mais informações, confira Conectar um bot ao email do Office 365.

Esses exemplos de comandos criam uma conexão com o canal do email do Office 365 usando az bot directline create. O exemplo mostra a conexão no console e exclui a conexão.

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

Você pode conectar seu bot ao Facebook Messenger e ao Facebook Empresa. Ele pode se comunicar com os usuários em ambas as plataformas. Para mais informações, confira Conectar um bot ao Facebook.

Esses exemplos de comandos criam uma conexão com o canal do Facebook usando az bot facebook create. O exemplo mostra a conexão no console e exclui a conexão.

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

Você pode configurar seu bot para se comunicar com o Microsoft Teams. Para obter mais informações, confira Conectar um bot ao Microsoft Teams

Esses exemplos de comandos criam uma conexão com o canal do Microsoft Teams usando az bot msteams create. O exemplo mostra a conexão no console e exclui a conexão.

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

Você pode configurar seu bot para se comunicar com o Skype. Para obter mais informações, confira Conectar um bot ao Skype.

Esses exemplos de comandos criam uma conexão com o canal do Skype usando az bot skype create. O exemplo mostra a conexão no console e exclui a conexão.

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

Você pode configurar um bot para se comunicar com usuários por meio do Slack. Para obter mais informações, confira Conectar um bot ao Slack.

Esses exemplos de comandos criam uma conexão com o canal do Slack usando az bot slack create. O exemplo mostra a conexão no console e exclui a conexão.

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

Esses exemplos de comandos criam uma conexão com o canal do SMS usando az bot sms create. O exemplo mostra a conexão no console e exclui a conexão.

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

Você pode configurar um bot para se comunicar com usuários por meio do Telegram. Para obter mais informações, confira Conectar um bot ao Telegram.

Esses exemplos de comandos criam uma conexão com o canal do Telegram usando az bot telegram create. O exemplo mostra a conexão no console e exclui a conexão.

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

Limpar a implantação

Se você criou um grupo de recursos para teste, execute o comando az group delete para remover o grupo de recursos e tudo o que ele contém.

az group delete --name ContosoBotRG

Para remover uma conexão com um canal, use o comando delete apropriado.

Comandos da CLI do Azure usados neste artigo

Este artigo usa os seguintes comandos da CLI do Azure:

Compartilhar via