Outlook 365 (Microsoft Graph)

Ler, enviar e organizar e-mails do Microsoft 365 (sem Outlook instalado)

Conectar ao Outlook 365

outlook365.connect

Autentica no Microsoft Entra ID e seleciona a caixa de correio

Como usar

Autentica no Microsoft 365 (Entra ID) pelo Microsoft Graph e escolhe a caixa de correio (de um usuário ou compartilhada). Não precisa do Outlook instalado. Use um aplicativo registrado (tenant, client ID e secret no cofre) ou um refresh token.

Exemplo: Conecte com o aplicativo do robô à caixa compartilhada notas@empresa.com.br, em {outlook}.

Campos

Campo	Tipo	Padrão	Detalhes
Autenticação *	Opção	`Aplicativo (client credentials, sem usuário)`	Registre um aplicativo no Microsoft Entra ID com as permissões do Microsoft GraphOpções: Aplicativo (client credentials, sem usuário), Usuário delegado (refresh token)
Tenant ID *	Texto		Ex.: `empresa.onmicrosoft.com ou GUID`
ID do aplicativo (client ID) *	Texto
Client secret (cofre) *	Credencial do cofre		Só quando «Autenticação» = «Aplicativo (client credentials, sem usuário)»
Refresh token (cofre) *	Credencial do cofre		Só quando «Autenticação» = «Usuário delegado (refresh token)»
Caixa de correio (UPN ou caixa compartilhada)	Texto		Obrigatório na autenticação de aplicativo; vazio = usuário autenticadoEx.: `financeiro@empresa.com`
Salvar conexão na variável *	Variável de saída	`outlook`

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Client secret para apps confidenciais (cofre)	Credencial do cofre		Só quando «Autenticação» = «Usuário delegado (refresh token)»

Resultado: guardado na variável outlook (Objeto).

Enviar E-mail

outlook365.send_email

Envia uma mensagem com anexos opcionais

Como usar

Envia um e-mail pela caixa conectada, com Cc, Cco, corpo HTML ou texto, anexos, importância e endereço de resposta.

Exemplo: Envie para {email_cliente} o assunto "Pedido {numero} confirmado" com importância alta.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do Outlook 365 *	Variável	`outlook`
Para *	Texto		Separe endereços com ;
Cc	Texto
Cco	Texto
Assunto *	Texto
Corpo *	Texto (várias linhas)
Formato do corpo	Opção	`HTML`	Opções: HTML, Texto simples
Anexos (caminhos dos arquivos)	Lista

+ Avançado (3)

Campo	Tipo	Padrão	Detalhes
Importância	Opção	`Normal`	Opções: Baixa, Normal, Alta
Salvar em Itens Enviados	Sim/Não	`Sim`
Responder para	Texto

Ler E-mails

outlook365.read_emails

Lista mensagens de uma pasta com filtros

Como usar

Lista as mensagens de uma pasta (inbox por padrão ou o nome da pasta) com filtros de não lidos, remetente, assunto, data e anexos. Cada e-mail traz id, assunto, remetente, data e corpo; use o id nos demais comandos.

Exemplo: Leia os não lidos com anexos de inbox e baixe os anexos de cada {item.id}.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do Outlook 365 *	Variável	`outlook`
Pasta	Texto	`inbox`	Nome conhecido (inbox, sentitems, drafts, archive…), nome da pasta ou ID
Somente não lidos	Sim/Não	`Sim`
Remetente contém	Texto
Assunto contém	Texto
Máximo de resultados	Número	`50`
Marcar como lidos	Sim/Não	`Não`
Salvar resultado na variável *	Variável de saída	`emails`

+ Avançado (3)

Campo	Tipo	Padrão	Detalhes
Recebidos depois de	Texto		Ex.: `2026-10-01 ou {variavel_data}`
Somente com anexos	Sim/Não	`Não`
Incluir corpo completo	Sim/Não	`Sim`

Resultado: guardado na variável emails (Lista).

Buscar E-mails

outlook365.search_emails

Busca de texto na caixa de correio (KQL)

Como usar

Busca texto na caixa toda com a sintaxe de pesquisa do Outlook (KQL), como from:fornecedor subject:nota.

Exemplo: Busque "from:nfe@fornecedor.com subject:nota" em {emails}.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do Outlook 365 *	Variável	`outlook`
Busca *	Texto		Ex.: `subject:nota from:cobranca@empresa.com`
Máximo de resultados	Número	`50`
Salvar resultado na variável *	Variável de saída	`emails`

Resultado: guardado na variável emails (Lista).

Obter E-mail

outlook365.get_email

Obtém uma mensagem com corpo e lista de anexos

Como usar

Obtém uma mensagem completa pelo ID, com corpo e lista de anexos.

Exemplo: Obtenha {message_id} e leia {email.body}.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do Outlook 365 *	Variável	`outlook`
ID da mensagem *	Texto		Geralmente vem de "Ler e-mails" ({email["id"]})
Salvar resultado na variável *	Variável de saída	`email`

Resultado: guardado na variável email (Dicionário).

Baixar Anexos

outlook365.download_attachments

Salva os anexos de uma mensagem

Como usar

Salva os anexos de uma mensagem numa pasta, opcionalmente só algumas extensões, ignorando as imagens do corpo (assinaturas) a menos que marcado.

Exemplo: Baixe os xml de {item.id} para C:\Robos\entrada\nfe.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do Outlook 365 *	Variável	`outlook`
ID da mensagem *	Texto		Geralmente vem de "Ler e-mails" ({email["id"]})
Salvar na pasta *	Pasta
Somente extensões	Texto		Ex.: `.pdf;.xlsx`
Salvar caminhos na variável *	Variável de saída	`attachments`

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Incluir imagens do corpo	Sim/Não	`Não`

Resultado: guardado na variável attachments (Lista).

Responder E-mail

outlook365.reply_email

Responde mantendo a conversa

Como usar

Responde a uma mensagem mantendo a conversa, ao remetente ou a todos, com anexos opcionais.

Exemplo: Responda {item.id} com "Recebido, obrigado."

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do Outlook 365 *	Variável	`outlook`
ID da mensagem *	Texto		Geralmente vem de "Ler e-mails" ({email["id"]})
Corpo *	Texto (várias linhas)
Responder a todos	Sim/Não	`Não`
Anexos (caminhos dos arquivos)	Lista

Encaminhar E-mail

outlook365.forward_email

Encaminha uma mensagem com os anexos

Como usar

Encaminha uma mensagem com os anexos para outro endereço, com um comentário.

Exemplo: Encaminhe {item.id} para compras@empresa.com.br com "Fornecedor sem cadastro".

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do Outlook 365 *	Variável	`outlook`
ID da mensagem *	Texto		Geralmente vem de "Ler e-mails" ({email["id"]})
Para *	Texto		Separe endereços com ;
Comentário	Texto (várias linhas)

Mover E-mail

outlook365.move_email

Move uma mensagem para outra pasta

Como usar

Move uma mensagem para outra pasta (pelo nome ou caminho, como Caixa de Entrada/Processados).

Exemplo: Mova {item.id} para Processados depois de baixar os anexos.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do Outlook 365 *	Variável	`outlook`
ID da mensagem *	Texto		Geralmente vem de "Ler e-mails" ({email["id"]})
Pasta de destino *	Texto		Nome, nome conhecido (archive, deleteditems…) ou ID

Marcar como Lido/Não Lido

outlook365.mark_as_read

Altera o estado de leitura

Como usar

Marca a mensagem como lida ou não lida.

Exemplo: Marque {item.id} como lida.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do Outlook 365 *	Variável	`outlook`
ID da mensagem *	Texto		Geralmente vem de "Ler e-mails" ({email["id"]})
Lido	Sim/Não	`Sim`

Definir Categorias / Sinalizador

outlook365.set_category

Aplica categorias e sinalizador de acompanhamento

Como usar

Aplica categorias (as cores do Outlook) e o sinalizador de acompanhamento a uma mensagem.

Exemplo: Aplique a categoria "Robô - erro" e sinalize {item.id} para alguém revisar.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do Outlook 365 *	Variável	`outlook`
ID da mensagem *	Texto		Geralmente vem de "Ler e-mails" ({email["id"]})
Categorias	Lista
Sinalizador	Opção	`Manter`	Opções: Manter, Sinalizado, Concluído, Limpar

Excluir E-mail

outlook365.delete_email

Move para Itens Excluídos ou exclui definitivamente

Como usar

Move a mensagem para Itens Excluídos ou a exclui de vez.

Exemplo: Exclua os avisos automáticos já tratados.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão do Outlook 365 *	Variável	`outlook`
ID da mensagem *	Texto		Geralmente vem de "Ler e-mails" ({email["id"]})
Excluir definitivamente	Sim/Não	`Não`

Listar Pastas

outlook365.list_folders

Lista as pastas de e-mail

Como usar

Lista as pastas de e-mail da caixa (com subpastas), com nome, ID e contagens.

Exemplo: Liste as pastas em {folders} para conferir o nome exato da pasta de destino.

Campos

Campo	Tipo	Padrão
Conexão do Outlook 365 *	Variável	`outlook`
Incluir subpastas	Sim/Não	`Sim`
Salvar resultado na variável *	Variável de saída	`folders`

Resultado: guardado na variável folders (Lista).

Criar Pasta

outlook365.create_folder

Cria uma pasta de e-mail

Como usar

Cria uma pasta de e-mail, na raiz ou dentro de outra, e guarda o ID.

Exemplo: Crie a pasta Processados dentro da Caixa de Entrada no primeiro uso.

Campos

Campo	Tipo	Padrão
Conexão do Outlook 365 *	Variável	`outlook`
Nome da pasta *	Texto
Pasta pai (vazio = raiz)	Texto
Salvar resultado na variável *	Variável de saída	`folder_id`

Resultado: guardado na variável folder_id (Texto).