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 Introdução ao Azure Cloud Shell.

  

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

  • Se estiver a usar uma instalação local, inicie sessão no Azure CLI utilizando 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 Autenticar no Azure usando a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre extensões, consulte Usar e gerenciar extensões com a CLI do Azure.

  • Execute az version para descobrir 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 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.

Linha Direta

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

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

Linkedin

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

Telemóvel

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

Folga

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 utilizando 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 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 

Limpeza da 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:

• 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 apresentação
• 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 eliminar
• az bot sms show
• az bot telegrama criar
• az bot excluir Telegram
• az bot telegram show
• az group delete - comando para eliminar um grupo.

Próximos passos

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