ação Conectar no pacote Microsoft Teams

A ação Conectar no pacote Microsoft Teams é usada para estabelecer uma conexão segura com o Microsoft Teams. Ela utiliza a autenticação OAuth2 para autenticar e autorizar com segurança o bot, permitindo a interação segura com o Teams e executar ações como enviar mensagens, ler informações de canais ou realizar outras tarefas relacionadas ao Teams dentro da sua automação.

OAuth 2.0 é usado para conectar ao servidor Microsoft Teams. Certifique-se de configurar a conexão OAuth no Control Room.

Configure a conexão do OAuth na Control Room. Para obter mais informações, consulte Configure a conexão do OAuth 2.0 na Control Room.

Configurações

  • No campo Conexão OAuth, clique em Escolher para escolher entre as credenciais OAuth2 gerenciadas pela Control Room disponíveis.
    Nota: Certifique-se de que a conexão OAuth2 esteja válida e ativa na Control Room.
  • Clique no menu suspenso Tipo de provedor para selecionar um provedor disponível ou personalizável.

    Para obter informações sobre como criar um provedor personalizado, consulte Configure a conexão do OAuth 2.0 na Control Room.

  • No campo Nome da conexão, selecione o administrador específico da Control Room do objeto de conexão OAuth para Microsoft Teams.

    Esse campo ficará desabilitado até que um Tipo de provedor seja selecionado.

  • No campo Tipo de token, selecione uma das seguintes opções dependendo do token que será usado em tempo de execução.
    • Compartilhado: para um token global.

      Um token de acesso do tipo compartilhado é criado quando uma conexão com a Control Room for estabelecida. Esse token de acesso é armazenado como uma credencial. Quando você executa a automação, o token de acesso é referenciado na automação usando o tipo de provedor de aplicativo empresarial configurado no arquivo de Control Room.

    • Específico do usuário: para um token específico de um usuário.
      Se você selecionar essa opção, faça login em sua conta do Microsoft Teams para autenticar e gerar um token específico do usuário. Execute as seguintes etapas para usar esta opção:
      1. Faça o login na Control Room e navegue até Minhas configurações > Conexões OAuth no seu perfil.
      2. Na guia Conexões OAuth, clique em Login para autenticar.
      3. Faça login em sua conta do Microsoft 365 e selecione Continuar.
      4. Verifique os serviços aos quais você tem acesso e clique em Continuar.

        Se a conexão for concluída com sucesso, o status será exibido como Ativo na tabela Conexões OAuth > Conexões.

  • Nome de usuário: Escolha uma das guias a seguir e insira ou selecione o endereço de e-mail do usuário do Microsoft 365:
    • Credencial: permite que você use um valor disponível no cofre de credenciais. Clique no botão Escolher para selecionar uma credencial.
    • Variável: permite que você use um valor armazenado como uma variável de credencial.
    • String insegura: permite que você especifique os valores.
  • No campo Criar sessão, use uma das seguintes guias para criar uma sessão:
    • No campo Sessão local, especifique um nome de sessão que possa ser usado apenas no bot atual.
    • Sessão global: para especificar um nome de sessão que possa ser usado em vários bots, como bots principais, bots secundários e todos os outros bots secundários do bot principal.

      Recomendação: os bots principais e secundários devem ter a mesma versão do pacote.

    • Variável: para especificar uma variável de sessão.