Conectar seu bot a canais com a CLI do Azure

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, consulte Conectar um bot aos canais.

Pré-requisitos

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.

  

• Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Se você estiver executando 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 em seu terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando 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 e gerenciar extensões com a CLI do Azure.

  • Execute o comando az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.

• Um bot implantado no Azure. Se você ainda não tiver um, consulte 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 ContosoBotRG grupo de recursos.

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

Linha Direta

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

Esses comandos de exemplo criam uma conexão com o canal 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, consulte Conectar um bot ao email do Office 365.

Esses comandos de exemplo criam uma conexão com o canal para email do Office 365 usando az bot email 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 Workplace. Ele pode se comunicar com usuários em ambas as plataformas. Para obter mais informações, consulte Conectar um bot ao Facebook.

Esses comandos de exemplo 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 

Equipes da Microsoft

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

Esses comandos de exemplo 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 o bot para se comunicar com o Skype. Para obter mais informações, consulte Conectar um bot ao Skype.

Esses comandos de exemplo 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

Folga

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

Esses comandos de exemplo 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 comandos de exemplo criam uma conexão com o canal para 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

Telegrama

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

Esses comandos de exemplo 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 de exclusão apropriado.

Comandos da CLI do Azure usados neste artigo

Este artigo usa os seguintes comandos do CLI do 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 criar
• az bot facebook delete
• az bot facebook mostrar
• az bot msteams create
• az bot msteams delete
• az bot msteams show
• az bot skype create
• az bot skype delete
• az bot skype mostrar
• az bot slack create
• az bot slack delete
• az bot slack show
• az bot sms criar
• az bot sms delete
• az bot sms mostrar
• az bot telegram create
• az bot telegram delete
• az bot telegram mostrar
• az group delete - comando para excluir um grupo no Azure.

Próximas etapas

• Conectar um bot aos canais
• Gerenciar um bot