> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Teams

> Ative e configure o canal do Microsoft Teams para conectar seu agente do Brain Studio à plataforma de colaboração da Microsoft.

## 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

<Note>
  O canal do Microsoft Teams é provisionado apenas como **single-tenant**. O tipo de app não é selecionável durante a ativação.
</Note>

<Warning>
  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.
</Warning>

## Ativar o canal

<Steps>
  <Step title="Abrir a seção Canais">
    Faça login na Jelou, acesse **Canais** e selecione a opção **Microsoft Teams**.
  </Step>

  <Step title="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.

    <Tip>
      Use um nome que identifique o ambiente além do canal, por exemplo, `Teams - RH Produção`, para distingui-lo com facilidade na listagem.
    </Tip>
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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*.

    <Note>
      Você pode encontrar essa URL novamente a qualquer momento nas propriedades do canal, portanto não é necessário guardá-la à parte.
    </Note>
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Conteúdo suportado

O Teams renderiza as mensagens como Adaptive Cards, portanto o canal aceita um subconjunto dos blocos disponíveis no WhatsApp:

| Bloco   | Disponível | Limite                        |
| ------- | ---------- | ----------------------------- |
| Texto   | Sim        | 4096 caracteres               |
| Imagem  | Sim        | JPEG e PNG, até 5 MB          |
| Botões  | Sim        | Máximo de 3 por mensagem      |
| Lista   | Sim        | Máximo de 10 opções           |
| CTA URL | Sim        | Enviado como `Action.OpenUrl` |

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

<Tip>
  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.
</Tip>