Criar um bot

Importante

Este artigo é baseado no SDK do Bot Framework v3. Se você estiver procurando a documentação atual versão 4.6 ou posterior do SDK, consulte a seção bots de conversação .

Todos os bots criados usando o Microsoft Bot Framework estão configurados e prontos para trabalhar no Microsoft Teams.

Para obter mais informações, consulte Documentação do Bot Framework para obter informações gerais sobre bots.

Criar um bot para o Microsoft Teams

O Portal de Desenvolvedores do Teams para Teams é uma ferramenta que pode ajudar a criar seu bot e um pacote de aplicativo que faz referência ao bot. Ele também contém uma biblioteca de controle React e amostras configuráveis para cartões. Para obter mais informações, confira Introdução ao Portal de Desenvolvedores do Teams para Teams. As etapas a seguir pressupõem que você esteja configurando manualmente seu bot e não usando o Portal de Desenvolvedores do Teams para Teams:

1. Crie o bot usando o Bot Framework. Lembre-se de adicionar o Microsoft Teams como um canal da lista de canais em destaque após criar seu bot. Sinta-se à vontade para reutilizar qualquer ID do Aplicativo Microsoft gerada se você já tiver criado seu pacote/manifesto de aplicativo.

   

Observação

Se você não quiser criar seu bot no Azure, deverá usar esse link para criar um novo bot: Bot Framework. Se você clicar no portal Criar um bot no portal do Bot Framework, criará seu bot no Microsoft Azure .

2. Crie o bot usando o pacote NuGet Microsoft.Bot.Connector.Teams , o SDK do Bot Framework ou a API do Conector de Bot.

3. Teste o bot usando o Bot Framework Emulator.

4. Implante o bot em um serviço de nuvem, como o Microsoft Azure. Como alternativa, execute seu aplicativo localmente e use um serviço de túnel como ngrok para expor um ponto de extremidade https:// para seu bot, como https://45az0eb1.ngrok-free.app/api/messages.

Observação

Bots e Microsoft Azure

A partir de dezembro de 2017, o portal do Bot Framework é otimizado para registrar bots no Microsoft Azure. Aqui estão algumas coisas que você precisa saber:

• O canal do Microsoft Teams para bots registado no Azure é gratuito. As mensagens enviadas pelo canal do Teams não contarão para as mensagens consumidas para o bot.
• Embora seja possível criar um novo bot Bot Framework sem usar o Azure, você deve usar a criação de um novo bot Bot Framework, que não está mais exposto no portal do Bot Framework.
• Quando você edita as propriedades de um bot existente na lista de bots no Bot Framework, como seu "ponto de extremidade de mensagens", que é comum ao desenvolver um bot pela primeira vez, especialmente se você usar o ngrok, você verá a coluna "Migração status" e um botão azul "Migrar" que o levará para o Microsoft portal do Azure. Não clique no botão "Migrar", a menos que seja isso que você deseja fazer; Em vez disso, clique no nome do bot e você pode editar suas propriedades:
  
• Se você registrar seu bot usando o Microsoft Azure, o código do bot não precisará ser hospedado no Microsoft Azure.
• Se você registrar um bot usando portal do Azure, deverá ter uma conta do Microsoft Azure. Você pode criar uma gratuitamente. Para verificar sua identidade ao criar uma, você deve fornecer uma cartão de crédito, mas ela não será cobrada; é sempre gratuito criar e usar bots com o Teams.
• Agora você pode usar o Portal do Desenvolvedor para o Teams para registrar/atualizar informações de aplicativo e bot diretamente no Teams. Você só precisará usar o portal do Azure para adicionar ou configurar outros canais do Bot Framework, como Direct Line, Webchat, Skype e Facebook Messenger.

Confira também

Amostras do Bot Framework.