Compartilhar via


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

Configure seu bot no Azure

  1. Abra 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.
  • O Microsoft Azure operado pela 21Vianet não dá suporte ao recurso Obter código de inserção do bot. Para testar o canal do Teams, crie o aplicativo do Teams e implante-o usando as etapas mencionadas abaixo.

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