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 subscrição 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 o carregamento ou sideload de aplicativos personalizados habilitado. Para obter mais informações, consulte Preparar seu locatário do Microsoft 365.
  • Um pacote válido do aplicativo Teams. Para obter mais informações, consulte Carregar seu aplicativo no Microsoft Teams.

Configurar seu bot no Azure

  1. Abra o portal do Azure.
  2. Abra a folha de recursos do Bot do Azure para 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, consulte a seção Publicar compilação de Planejar seu aplicativo com recursos do Teams.
    3. Selecione Aplicar.
  4. Selecione Obter código de incorporação do bot, localize o código de incorporaçã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.

Gorjeta

Teste seu bot no Teams

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

Importante

Adicionar um bot por GUID, para qualquer outra coisa que não seja para fins de teste, não é recomendado. 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 incorporação e escolha o aplicativo Microsoft Teams (cliente ou Web) que você usa para adicionar o bot ao Teams. Você deve ser capaz de ver o bot listado como um contato para o qual você pode enviar e receber mensagens no Microsoft Teams.
  2. Interaja com seu bot no Teams.

Gorjeta

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

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 todos os IDs 29:xxx e a:xxx que o bot pode ter armazenado para mensagens proativas.

Publique seu bot no Teams

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

  • Escolha e configure as opções de instalação para seu bot
  • Crie o manifesto, o ícone e o pacote do aplicativo Teams
  • Carregue a sua aplicação para o Teams
  • Publique seu aplicativo em sua organização ou na loja do Teams

Informações adicionais