Conecte seu bot a canais com a CLI do Azure

Um canal é uma conexão entre um aplicativo de comunicação e um bot. Um bot, registrado no Azure, usa canais para permitir 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 a canais.

Pré-requisitos

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

  • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando 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 com o aplicativo para autenticar. 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 em 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

E-mail 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 os 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 

Microsoft Teams

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 para o 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, 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

Slack

Você pode configurar seu 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 para o 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

Telegram

Você pode configurar seu bot para se comunicar com os usuários através 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 implementaçã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:

• az bot directline criar
• az bot directline excluir
• az bot show directline
• az bot email criar
• az bot e-mail excluir
• az bot show de e-mail
• az bot facebook criar
• az bot facebook excluir
• az bot facebook show
• az bot msteams criar
• az bot msteams excluir
• az bot msteams show
• az bot skype criar
• az bot skype excluir
• az bot skype show
• az bot slack criar
• az bot slack excluir
• az bot slack show
• az bot sms criar
• az bot sms excluir
• az bot sms show
• az bot telegrama criar
• az bot telegram excluir
• az bot telegram show
• az group delete

Próximos passos

• Connect a bot to channels (Ligar um bot a canais)
• Manage a bot (Gerir um bot)