Conectar um bot ao Microsoft Teams

APLICA-SE A: SDK v4

Você pode configurar seu bot para se comunicar com as pessoas por meio do Microsoft Teams. Este artigo descreve como criar um aplicativo do Teams no Teams, conectar seu bot ao aplicativo do Teams no Azure e testar seu bot no Teams.

Pré-requisitos

• Uma assinatura do Azure. Se ainda não tiver uma, crie uma conta gratuita antes de começar.
• Um bot publicado no Azure que você deseja conectar ao Teams.
• Um locatário desenvolvedor no Teams com upload ou sideload de aplicativo personalizado habilitado. Para mais informações, confira Preparar seu locatário do Microsoft 365.
• Um pacote do aplicativo do Teams válido. Para obter mais informações, confira Fazer upload do seu aplicativo no Microsoft Teams.

Configure seu bot no Azure

1. Kudu o Portal do Azure.
2. Kudu a folha do recurso de Bot do Azure para o seu bot.
3. Abra Canais e selecione Microsoft Teams:
   1. Leia e concorde com os termos de serviço.
   2. Na guia Mensagens, selecione o ambiente de nuvem para seu bot. Para obter mais informações, confira a seção Pós-compilação de Planejar seu aplicativo com recursos do Teams.
   3. Escolha Aplicar.
4. Selecione Obter código de inserção de bot, localize o código de inserção do Teams e copie a parte https do código. Por exemplo, https://teams.microsoft.com/l/chat/0/0?users=28:b8a22302e-9303-4e54-b348-343232. Você pode usar esse código para testar o bot no Teams.

Dica

• A guia Chamada oferece suporte ao recurso de chamada do Teams. Para obter mais informações, confira Registrar bot de chamadas e reuniões para o Microsoft Teams.
• A guia Publicar contém informações sobre como publicar seu aplicativo Teams na Loja do Teams.

Testar seu bot no Teams

Os bots em produção devem ser adicionados ao Teams como parte de um aplicativo Teams. Para obter mais informações, confira Testar seu aplicativo.

Importante

A adição de um bot por GUID, para qualquer outra coisa que não seja para fins de teste, não é recomendável. Fazer isso limita severamente a funcionalidade de um bot. Os bots em produção devem ser adicionados ao Teams como parte de um aplicativo.

1. No navegador, abra a URL copiada do código de inserção e escolha o aplicativo Microsoft Teams (cliente ou Web) que você usa para adicionar o bot ao Teams. Você deve poder ver o bot listado como um contato para o qual você pode enviar mensagens e do qual pode recebê-las no Microsoft Teams.
2. Interagir com o bot no Teams.

Dica

Use um registro de canal de bot por ambiente, já que seu ponto de extremidade muda quando você alterna entre ambientes de desenvolvimento, preparação e produção locais.

A exclusão do registro do canal do Teams fará com que um novo par de chaves seja gerado quando ele for reativado. Isso invalida todas as IDs 29:xxx e a:xxx que o bot pode ter armazenado para mensagens proativas.

Publicar seu bot no Teams

Para obter instruções sobre como publicar seu aplicativo, confira a visão geral do Teams sobre como distribuir seu aplicativo do Microsoft Teams. Ela e os artigos associados abordam como:

• Escolher e configurar opções de instalação para seu bot
• Criar o manifesto do aplicativo, ícone e pacote Teams
• Fazer upload de um aplicativo no Teams
• Publicar o aplicativo em sua organização ou na loja do Teams

Informações adicionais

• Para obter mais informações sobre o desenvolvimento de aplicativos do Teams, confira Criar aplicativos para o Microsoft Teams e Introdução.
• Para obter mais informações sobre como criar bots para o Teams, confira Bots no Microsoft Teams.
• Para obter mais informações sobre como publicar e testar um bot no Teams, confira Distribuir seu aplicativo do Microsoft Teams e Testar seu aplicativo.
• Para fornecer feedback e encontrar recursos adicionais, confira Canais da Developer Community do Microsoft Teams.