Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Importante
Este artigo baseia-se no SDK do Bot Framework v3.
- Se você quiser criar um bot de IA, consulte Criar um bot de IA.
- Se você quiser criar um bot básico, consulte introdução e, se quiser procurar a versão de documentação atual 4.6 ou posterior do SDK, consulte bots de conversa.
Crie e conecte bots inteligentes para interagir naturalmente com os usuários do Microsoft Teams por meio do chat. Ou forneça um bot baseado em comandos simples, para ser usado como sua interface de "linha de comando" para sua experiência mais ampla do aplicativo Teams. Você pode criar um bot somente notificação, que pode enviar informações relevantes para seus usuários diretamente a eles em um canal ou mensagem direta. Você pode até mesmo trazer seu bot baseado no Bot Framework existente e adicionar suporte específico do Teams para fazer sua experiência brilhar.
Importante
Os bots estão disponíveis nos ambientes Government Community Cloud (GCC), GCC High, Departamento de Defesa (DoD) e Teams operados pela 21Vianet .
O que você precisa saber: Bots
Um bot aparece como qualquer outro membro da equipe com quem você interage em uma conversa, exceto que tem um ícone de avatar hexagonal e está sempre online.
Um bot se comporta de maneira diferente dependendo do tipo de conversa em que está envolvido. Os bots no Teams dão suporte a vários tipos de conversas chamadas escopos no manifesto do aplicativo.
-
teamsTambém chamadas de conversas de canal. -
personalConversas entre um bot e um único usuário. -
groupChatUma conversa entre um bot e dois ou mais usuários.
Para obter mais informações, consulte Converse com um bot do Microsoft Teams.
Com os aplicativos do Teams, você pode tornar o bot a estrela da sua experiência ou apenas um ajudante. Os bots são publicados como parte do seu pacote de aplicativo mais amplo, que pode incluir outros recursos, como guias ou extensões de mensagem.
Bot APIs
O Teams é compatível com a maior parte do Microsoft Bot Framework. (Se você já tiver um bot baseado no Bot Framework, poderá adaptá-lo facilmente para trabalhar no Teams.) Recomendamos que você use C# ou Node.js para aproveitar nossos SDKs. Esses pacotes estendem as classes e os métodos básicos do SDK do Bot Builder:
- Usar tipos de card especializados, como o connector card para Grupos do Microsoft 365.
- Consumir e definir dados de canal específicos do Teams em atividades.
- Processando solicitações de extensão de mensagem.
As extensões do SDK instalam dependências, incluindo o SDK do Construtor de Bots.
- .NET Para usar as extensões do Microsoft Teams para o SDK do Bot Builder para .NET, instale o pacote NuGet Microsoft.Bot.Connector.Teams em seu projeto do Visual Studio. Para Node.js desenvolvimento, a funcionalidade do BotBuilder para Microsoft Teams foi incorporada ao SDK do Bot Framework a partir da v4.6.
Importante
Você pode desenvolver aplicativos do Teams em qualquer outra tecnologia de programação da Web e chamar as APIs REST do Bot Framework diretamente, mas você deve realizar todo o tratamento de token por conta própria.
O Portal do desenvolvedor do Teams ajuda você a criar e configurar o manifesto do aplicativo e pode criar o bot do Bot Framework para você. Ele também contém uma biblioteca de controle React e um construtor de card interativo.
Webhooks de saída
Os webhooks de saída permitem que você crie um bot simples para interação básica, como iniciar um fluxo de trabalho ou outros comandos simples que você possa precisar. Os webhooks de saída residem apenas na equipe na qual você os cria e são destinados a processos simples específicos do fluxo de trabalho da sua empresa. Para obter mais informações, consulte webhooks de saída.
Crie um ótimo bot do Teams
Os artigos a seguir guiam você pelo processo de criação de um ótimo bot para o Teams:
- Criar um bot: aproveite as excelentes ferramentas, documentação e comunidade fornecidas pela equipe do Bot Framework.
- Fale com seu bot: adicione fluxo de conversa básico e use a funcionalidade específica do canal. Se você desenvolve em .NET ou Node.js, use nossas extensões do SDK do Bot Builder para simplificar seu trabalho.
- Usando cartões em seu bot: Projete cartões para se comunicar e aceitar a resposta do usuário.
- Responder a eventos de bot
- Bots somente notificação: usar bots para enviar notificações para seu aplicativo.
- Obter contexto: obtenha informações sobre o usuário.
- Menus de bot: Usando menus em bots.
- Bots e arquivos: Enviar e receber arquivos de bots.
- Usando guias com bots: fazendo guias e bots trabalharem juntos.
- Teste seu bot: adicione seu bot para conversas pessoais ou de equipe para vê-lo em ação.
Bots SDK V3
Importante
Este artigo baseia-se no SDK do Bot Framework v3.
- Se você quiser criar um bot de IA, consulte Criar um bot de IA.
- Se você quiser criar um bot básico, consulte introdução e, se quiser procurar a versão de documentação atual 4.6 ou posterior do SDK, consulte bots de conversa.
O Portal do Desenvolvedor do Teams para Teams é uma ferramenta que pode ajudar a criar seu bot e um pacote de aplicativos que faz referência a ele. Ele também contém uma biblioteca de controle React e exemplos configuráveis para cartões. Para obter mais informações, consulte Introdução ao Portal do Desenvolvedor do Teams para Teams. As etapas a seguir pressupõem que você está configurando o bot manualmente e não usando o Portal do Desenvolvedor do Teams para Teams:
Crie o bot usando o Bot Framework. Certifique-se de adicionar o Microsoft Teams como um canal da lista de canais em destaque depois de criar seu bot. Sinta-se à vontade para reutilizar qualquer ID de aplicativo da Microsoft gerada se já tiver criado seu pacote/manifesto do aplicativo.
Observação
Se você não quiser criar seu bot no Azure, deverá usar este link para criar um novo bot: Bot Framework. Se você selecionar Criar um bot no portal do Bot Framework, você criará seu bot no Microsoft Azure.
Crie o bot usando o pacote NuGet Microsoft.Bot.Connector.Teams , o SDK do Bot Framework ou a API do Conector de Bot.
Teste o bot usando o Bot Framework Emulator.
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 o 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
O portal do Bot Framework é otimizado para registrar bots no Microsoft Azure. O que você deve saber:
- O canal do Microsoft Teams para bots registrados 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 do Bot Framework sem usar o Azure, você deve usar a criação de um novo bot do Bot Framework, que não é mais exposto no portal do Bot Framework.
- Quando você edita as propriedades de um bot existente na lista de seus bots no Bot Framework, como seu "ponto de extremidade de mensagens", o que é comum ao desenvolver um bot pela primeira vez, especialmente se você usar o ngrok, verá a coluna "status de migração" e um botão azul "Migrar" que o levará ao Microsoft portal do Azure. Não selecione o botão "Migrar" a menos que seja isso que você queira fazer; em vez disso, selecione o nome do bot e você poderá 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 o portal do Azure, deverá ter uma conta do Microsoft Azure. Você pode criar um gratuitamente. Para verificar sua identidade ao criar um, você deve fornecer um cartão de crédito, mas ele não será cobrado; é sempre gratuito criar e usar bots com o Teams.
- Agora você pode usar o Portal do Desenvolvedor do Teams para registrar/atualizar informações de aplicativos e bots 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.