Skip to main content

​
Introdução

O canal Microsoft Teams conecta seu agente do Brain Studio ao Teams para que seus colaboradores e clientes obtenham respostas rápidas e personalizadas sem sair da plataforma de colaboração da Microsoft. A conexão é feita por meio de um app do Azure Bot que você registra no Azure. A Jelou recebe as mensagens do Teams, executa o fluxo publicado e devolve as respostas do agente no mesmo chat.

​
Pré-requisitos

Antes de ativar o canal, certifique-se de ter:
  • Uma conta ativa na Jelou e acesso à seção Canais
  • Um registro de aplicativo no Microsoft Entra ID (antigo Azure AD), com estes três dados em mãos:
    • App ID (client ID)
    • Senha do app (client secret)
    • Tenant ID
  • Um recurso do Azure Bot associado a esse registro, com o canal Microsoft Teams habilitado
  • Acesso ao Portal do Desenvolvedor do Teams ou ao Portal do Azure para configurar o messaging endpoint do bot
O canal do Microsoft Teams é provisionado apenas como single-tenant. O tipo de app não é selecionável durante a ativação.
Se você não vir a opção Microsoft Teams na lista de canais, seu plano não a inclui. Entre em contato com seu administrador ou com a equipe de suporte da Jelou.

​
Ativar o canal

1

Abrir a seção Canais

Faça login na Jelou, acesse Canais e selecione a opção Microsoft Teams.
2

Nomear o canal e escolher o projeto

Atribua um nome descritivo, por exemplo, Teams - Suporte interno. O nome deve ter entre 4 e 50 caracteres.Em seguida, selecione o projeto do Brain Studio ao qual o canal será conectado.
Use um nome que identifique o ambiente além do canal, por exemplo, Teams - RH Produção, para distingui-lo com facilidade na listagem.
3

Informar as credenciais do Azure Bot

Na segunda etapa do modal, preencha os três campos, todos obrigatórios:
  • App ID: o App ID (client ID) do seu Azure Bot
  • Senha do app: o client secret do app
  • Tenant ID: o tenant ID do Azure AD
Se você deixar um campo vazio, o formulário o marca em vermelho com a mensagem Este valor é obrigatório e o botão de criação permanece desabilitado.
4

Criar e conectar o canal

Clique em Criar e conectar canal. A Jelou cria o canal e exibe a URL do messaging endpoint necessária para concluir a conexão do lado da Microsoft.
5

Configurar o messaging endpoint no Teams

Copie a URL e cole no campo messaging endpoint do bot. Você pode fazer isso em qualquer um destes dois lugares:
  • Portal do Desenvolvedor do Teams: acesse Tools → Bot management, selecione seu bot e preencha Endpoint address.
  • Portal do Azure: abra o recurso Azure Bot e vá em Settings → Configuration → Messaging endpoint.
Você pode encontrar essa URL novamente a qualquer momento nas propriedades do canal, portanto não é necessário guardá-la à parte.
6

Construir a lógica no Brain Studio

Abra o projeto no Brain Studio, selecione o canal Microsoft Teams na listagem de workflows e comece a construir seu fluxo.

​
Conteúdo suportado

O Teams renderiza as mensagens como Adaptive Cards, portanto o canal aceita um subconjunto dos blocos disponíveis no WhatsApp: Outros limites aplicados pelo canal:
  • Legenda de mídia: 1024 caracteres
  • Corpo de mensagens com botões: 1024 caracteres
  • Nome de arquivo: 255 caracteres

​
Limitações do canal

No builder, alguns nós e ferramentas não estão disponíveis no canal Microsoft Teams porque dependem do WhatsApp ou de outras integrações.

​
Nós e blocos não disponíveis

  • Modelo HSM
  • WhatsApp Flows
  • Vídeo
  • Áudio
  • Documento e Arquivo
  • Sticker
  • Carrossel
  • Lista numerada
  • Webview
  • Localização
  • Contato
  • Respostas rápidas
  • Pagamentos
  • Connect (consultor)
  • Biometria
  • Transferência para humano (HubSpot, Genesys ou outros)

​
Ferramentas do Agente IA não disponíveis

  • Call to action (send_call_to_action)
  • Transferir para consultor (transfer_to_agent)
  • Jelou Shop

​
Próximos passos

Depois de conectar o canal:
  1. Envie uma mensagem direta ao bot pelo Teams para verificar a conexão
  2. Revise os logs de execução no Brain Studio para confirmar que o fluxo é executado
  3. Ajuste o fluxo com os blocos suportados pelo canal
Teste o canal com um usuário real da sua organização antes de publicar, para confirmar que o messaging endpoint ficou bem configurado no Portal do Desenvolvedor do Teams.