Este artigo descreve, passo a passo, como integrar um Agente de IA para operar dentro do Microsoft Teams, utilizando o Azure Active Directory, o Azure Bot Service e um backend próprio para processamento de mensagens.
Pré-requisitos
Antes de iniciar, é necessário:
-
Conta corporativa Microsoft (Microsoft 365)
-
Permissão para criar recursos no Azure
-
Acesso ao Microsoft Teams
-
Permissão para upload de aplicativos customizados no Teams (ou acesso ao Admin Center)
-
Um Agente de IA ja contratado
Visão geral do funcionamento
A integração do agente de IA com o Microsoft Teams funciona por meio do Azure Bot Service, que atua como intermediário entre o Teams e o backend do agente.
Fluxo de comunicação:
Usuário no Microsoft Teams
→ Microsoft Teams
→ Azure Bot Service
→ Backend do agente de IA
O Azure Bot é responsável apenas pelo transporte das mensagens. Toda a lógica de IA, regras de negócio e integrações externas devem ser executadas no backend.
Criar a Application no Azure Active Directory
A Application representa a identidade do agente de IA dentro do ambiente Microsoft.
Acesso
Procedimento
-
Acesse o Azure Portal
-
Entre em Azure Active Directory
-
Selecione App registrations
-
Clique em New registration
Configuração
-
Name: nome identificador do agente (exemplo: IA-Teams)
-
Supported account types: Accounts in this organizational directory only
-
Redirect URI: não configurar
Após a criação, anote as seguintes informações:
-
Application (client) ID
-
Directory (tenant) ID
Esses dados serão utilizados nas etapas seguintes.
Criar o Client Secret da Application
O Client Secret será utilizado para autenticar o Azure Bot como essa Application.
Caminho
Azure Active Directory
→ App registrations
→ [Application criada]
→ Certificates & secrets
Procedimento
-
Clique em New client secret
-
Defina uma descrição
-
Escolha o prazo de validade
-
Clique em Add
Anote o valor do secret em local seguro. Esse valor não poderá ser recuperado posteriormente.
Criar o Azure Bot
O Azure Bot é o recurso responsável por conectar o Microsoft Teams ao backend do agente de IA.
Acesso
https://portal.azure.com/#create/Microsoft.AzureBot
Procedimento
-
No Azure Portal, clique em Create a resource
-
Pesquise por Azure Bot
-
Clique em Create
Configuração
-
Bot handle: nome interno do bot
-
Subscription: assinatura Azure
-
Resource Group: grupo de recursos desejado
-
Pricing tier:
-
Type of App: Existing Microsoft App
-
Microsoft App ID: Application (client) ID
-
Microsoft App Password: Client Secret
Finalize a criação do recurso.
Habilitar o canal Microsoft Teams
Após a criação do Azure Bot, é necessário habilitar o canal do Microsoft Teams.
Caminho
Azure Bot
→ Channels
Procedimento
-
Acesse o recurso do Azure Bot
-
Clique em Channels
-
Selecione Microsoft Teams
-
Salve a configuração
A partir desse momento, o bot passa a aceitar mensagens originadas do Teams.
Configurar o endpoint do agente de IA
O Azure Bot apenas encaminha mensagens para um endpoint configurado.
- Solicite o endpoint para nosso time!
Configuração no Azure Bot
Caminho:
Azure Bot
→ Settings
Procedimento:
-
Informar o endereço no campo Messaging endpoint
-
Salvar as alterações
Criar o aplicativo do Microsoft Teams (manifest)
Para que o agente apareça no Microsoft Teams, é necessário criar um aplicativo do Teams.
Documentação oficial
https://learn.microsoft.com/microsoftteams/platform/concepts/build-and-test/apps-package
Estrutura mínima do pacote
teams-app/
├─ manifest.json
├─ color.png (192x192)
└─ outline.png (32x32)
O arquivo manifest.json define:
-
Identidade do aplicativo
-
Bot associado
-
Escopos de uso (chat privado, grupo e canal)
-
Permissões necessárias
Publicar o aplicativo no Microsoft Teams
Publicação em produção
-
Via Teams Admin Center
https://dev.teams.microsoft.com/apps -
Ou submissão para a Microsoft Teams Store
-
Disponibilidade do endpoint HTTPS
Considerações finais
Seguindo este procedimento, o agente de IA passa a operar integrado ao Microsoft Teams, utilizando identidade corporativa, canal oficial de comunicação e backend próprio para processamento inteligente das mensagens.