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

> [!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.

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

> [!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.

**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*.

> [!NOTE]
>
> 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:

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.