API do Outlook: o que dá para fazer e como usar com agentes de IA
O acesso ao Outlook é feito pelo Microsoft Graph, que reúne e-mails, calendário, contatos e tarefas das contas Microsoft 365. É usado por empresas que querem automatizar triagem de e-mails, agendas e respostas. O acesso passa pelo Microsoft Entra ID do cliente, com consentimento do administrador.
Os grandes recursos da API, em português claro.
Leitura, envio, resposta, movimentação entre pastas e categorização de mensagens.
Download e envio de arquivos anexados.
Criação, consulta e atualização de eventos e convites.
Consulta de horários livres para marcar reuniões.
Leitura e gestão dos contatos da conta.
Assinaturas que avisam quando chega um e-mail ou um evento muda.
Como se acessa a API do Outlook.
- Com credencial da sua empresaUsa OAuth 2.0 via Microsoft Entra ID, com app registrado e permissões do Microsoft Graph delegadas ou de aplicativo, que costumam exigir consentimento do administrador.
- Documentação oficiallearn.microsoft.com/graph
- Permissões de aplicativo podem dar acesso a todas as caixas: restrinja por política de acesso.
- E-mails têm dados pessoais e confidenciais; aplique a LGPD e registre tudo na auditoria.
- O Graph tem limites de requisição por caixa e por app.
- api outlook
- outlook api
- microsoft graph api outlook
- api do outlook enviar email
- outlook api calendário
- integração api outlook
- outlook rest api
O que um agente do iTeam faz com a API do Outlook.
O agente lê os e-mails da caixa de atendimento, classifica por assunto, responde os simples e encaminha o resto com resumo.
O agente identifica e-mails com notas fiscais e boletos, salva os anexos e lança no sistema para conferência.
O agente encontra horários livres dos participantes e envia o convite depois que o organizador confirma.
Para clientes importantes, o agente deixa a resposta pronta em rascunho e avisa quem deve revisar e enviar.
Da credencial ao agente trabalhando, com aprovação.
Registrar o app no Entra ID
A TI registra o aplicativo e concede só as permissões do Graph necessárias, restringindo a caixas específicas quando possível.
Guardar no cofre do iTeam
Cadastre a credencial e defina quais caixas cada agente lê e se ele pode enviar ou apenas criar rascunhos.
Enviar com aprovação no início
Comece com rascunhos e aprovação humana e libere envio automático só para respostas padronizadas.
Dúvidas sobre a API do Outlook.
A API do Outlook é gratuita?
O Microsoft Graph não cobra pelas chamadas comuns de e-mail e calendário; o que é necessário são as licenças do Microsoft 365 das contas usadas.
Preciso programar para usar a API do Outlook com o iTeam?
Não necessariamente. O Outlook está no catálogo de apps do iTeam e o time de implantação configura caixas, pastas e regras com a TI.
Funciona com Outlook.com pessoal?
O Graph também atende contas pessoais Microsoft, mas o uso corporativo com o iTeam é pensado para contas do Microsoft 365.
Como o agente de IA acessa os e-mails do Outlook de uma empresa?
Pelo Microsoft Graph, com um app registrado no Microsoft Entra ID do cliente e autenticação OAuth 2.0. As permissões podem ser delegadas, em nome de um usuário, ou de aplicativo, valendo para o ambiente. Em geral é preciso consentimento de um administrador, e o escopo deve se limitar ao que a rotina precisa, como ler uma caixa específica.
Qual a diferença entre permissão delegada e de aplicativo no Graph para o Outlook?
A delegada age como o usuário conectado; a de aplicativo age sozinha e pode alcançar todas as caixas se ninguém a restringir. Para um agente, a delegada é mais segura. Se usar a de aplicativo, restrinja as caixas por política de acesso no Exchange Online.
O agente consegue triar e responder e-mails no Outlook?
Consegue ler mensagens, classificar por assunto, mover para pastas, criar rascunhos e enviar respostas pela API. O desenho recomendado é o agente preparar o rascunho e a pessoa revisar antes de enviar, ao menos no começo. Mensagens de clientes importantes, jurídico ou financeiro ficam sempre com humano, e o agente só sinaliza a urgência.
Dá para o agente marcar reuniões usando o calendário do Outlook?
Dá: o Graph permite consultar a disponibilidade de várias pessoas e criar eventos com convidados. O agente propõe horários livres, cria o evento e inclui o link de reunião. Convém confirmar com o organizador antes de convidar clientes externos. O iTeam registra cada convite que o agente cria na trilha de auditoria.
Existe sandbox do Outlook para testar o agente antes da empresa inteira?
A Microsoft oferece o programa Microsoft 365 Developer, que fornece um ambiente de testes com contas fictícias, mas as condições de elegibilidade mudam. Confira na documentação oficial se você se qualifica. Alternativa: um tenant de teste com poucas caixas, onde o consentimento e as permissões são validados antes de chegar às caixas reais.
Como o agente fica sabendo de novos e-mails sem consultar a caixa toda hora?
Usando as notificações de mudança do Graph: o app cria uma assinatura e a Microsoft avisa quando chega uma mensagem. Essas assinaturas expiram e precisam ser renovadas, então o serviço deve cuidar disso. Evita consultas repetidas e reduz o risco de bater nos limites de requisição por caixa e por aplicativo.
Funciona com Outlook de contas pessoais ou só com Microsoft 365?
A API do Graph também atende contas Microsoft pessoais, como Outlook.com, mas com um conjunto diferente de permissões e sem o consentimento de administrador. Para uso empresarial, o caminho comum é o Microsoft 365 com o Entra ID do cliente. Confira na documentação do Graph quais recursos existem para cada tipo de conta.
E-mails lidos por um agente de IA entram na LGPD?
Entram, pois caixas de e-mail contêm dados pessoais e informação confidencial da empresa. O agente deve ter acesso só às caixas necessárias, nunca guardar o conteúdo além do preciso e deixar registro de leitura e envio. Não é parecer jurídico: a base legal e as regras de retenção devem ser definidas com o jurídico e o encarregado de dados.
