Microsoft 365

Oito nós levam o fluxo para dentro do seu Microsoft 365: enviar e ler e-mail no Outlook, publicar no Teams, ler e escrever planilhas do Excel, mexer em arquivos do OneDrive e do SharePoint, manter tarefas no To Do, administrar contas no Entra ID e consultar registros do Dynamics 365.

Eles não ficam todos no mesmo lugar da paleta — cada um mora no grupo do assunto de que trata:

Nesta página: antes de começar · por que o e-mail da conta é sempre pedido · o que vale para todos · Outlook · Teams · Excel · OneDrive · SharePoint · To Do · Entra ID · Dynamics 365

Antes de começar

Cadastre uma credencial do tipo Microsoft 365 (Graph). Ela é usada pelos oito nós.

Esses três valores vêm de um aplicativo registrado no seu Microsoft 365, criado e autorizado pelo administrador da organização. Ou seja: a credencial representa o aplicativo, e não a conta de uma pessoa. Peça ao seu administrador o registro do aplicativo, a liberação das permissões correspondentes ao que o fluxo vai fazer (e-mail, arquivos, contas…) e os três valores acima.

Ao salvar, o sistema confere se o aplicativo consegue se autenticar. Essa conferência não avalia as permissões — se uma delas faltar, a recusa aparece só quando o nó rodar, com a mensagem que a Microsoft devolveu.

Informe sempre a conta

Como a credencial é do aplicativo, não existe "eu" para a Microsoft resolver: ela não tem caixa de e-mail, agenda, OneDrive nem lista de tarefas próprias. Por isso os nós que trabalham sobre o material de uma pessoa pedem o campo Usuário (e-mail ou ID) — é ele que diz de qual caixa, drive ou lista o nó está falando.

O campo é obrigatório no Outlook, no Teams, no Excel, no OneDrive e no To Do. Deixá-lo em branco interrompe o nó com o aviso de informar o usuário — essa é, de longe, a causa mais comum de falha nesta família. O Entra ID pede o mesmo endereço no campo Conta (e-mail ou ID) nas operações que agem sobre uma conta específica. SharePoint e Dynamics 365 não pedem: eles trabalham sobre o site e sobre a organização, não sobre a conta de alguém.

O campo aceita {{ … }}, então dá para percorrer uma lista de pessoas e agir na caixa de cada uma.

O que vale para todos

• Escolha a Credencial Microsoft 365 no topo do nó.
• Operação define o que o nó faz; os campos abaixo mudam conforme a operação — só aparece o que aquela operação precisa.
• Todos os campos aceitam {{ … }} com dados do item.
• Operações que devolvem lista emitem um item por registro; as demais emitem um item. Lista vazia segue com o item de entrada intacto.
• Máximo de itens limita quantos registros vêm de uma vez. O nó busca o conteúdo em blocos e vai somando até chegar ao número pedido, então um valor alto significa uma espera maior — comece pelo padrão e suba só se faltar registro.
• Na aba Config ficam Timeout (segundos) (padrão 60) e Saída do nó (Mesclar item, o padrão, ou Substituir item) — veja Ajustes do nó.
• Cada nó tem uma saída (main).

Outlook — E-mail

Grupo Comunicação. Lê, envia, move e marca mensagens de uma caixa de e-mail.

Listar mensagens começa na Pasta inbox; você pode trocar por outro nome conhecido (sentitems, drafts, archive) ou pelo ID da pasta, e deixar em branco para varrer a caixa inteira. Filtro aceita uma expressão de consulta da Microsoft (por exemplo isRead eq false) e Buscar por procura no remetente, no assunto e no corpo. Os dois não convivem: quando você preenche a busca, o filtro e a ordenação são ignorados. Ordenar por oferece recebimento (mais recente ou mais antiga primeiro), assunto ou o padrão do Outlook. Máximo de mensagens vem com 50. Sai um item por mensagem.

Enviar mensagem aceita vários endereços em Para, Cc e Cco, separados por vírgula. Marque Escrever em HTML se o corpo tiver formatação, e desmarque Guardar em Itens Enviados se a cópia não deve ficar na caixa. A Microsoft confirma o envio sem devolver a mensagem, então não há ID para o próximo nó usar: o item de saída traz apenas a confirmação, os destinatários e o assunto. Se precisar do registro do que foi enviado, guarde-o você mesmo antes.

Mover para pasta usa o nome conhecido (archive, deleteditems, junkemail) ou o ID da pasta de destino. Marcar como lida vem com a caixa marcada; desmarque-a para devolver a mensagem ao estado de não lida.

Microsoft Teams

Grupo Comunicação. Publica mensagens e descobre as equipes e os canais.

Formato escolhe entre texto simples e HTML. Em Responder à mensagem, informe o ID de uma mensagem do canal para responder dentro da conversa; em branco, publica uma mensagem nova.

Listar equipes traz as equipes da conta informada em Usuário (e-mail ou ID) — use-a para descobrir o ID que as demais operações pedem, e Listar canais de uma equipe para chegar ao ID do canal.

Publicar no Teams é, para a Microsoft, uma ação de pessoa, não de aplicativo. Se a organização não tiver concedido a permissão específica para o aplicativo publicar, a mensagem é recusada — o nó avisa isso na hora, para você não procurar o problema na credencial. Fale com o administrador do Microsoft 365 antes de montar o fluxo em cima do envio.

Microsoft Excel

Grupo Planilhas e documentos. Lê e escreve em planilhas guardadas no OneDrive ou no SharePoint. Além do usuário, todas as operações pedem o ID do arquivo — o mesmo identificador que os nós de arquivos devolvem.

Ler intervalo usa a aba indicada (padrão Planilha1) e o Intervalo em notação A1, como A1:D50; em branco, lê toda a área preenchida da aba. Escrito de outro jeito, o intervalo é recusado antes da consulta. Com Primeira linha é o cabeçalho ligado (o padrão), os nomes das colunas viram os campos do item; desligado, os valores saem juntos no campo valores. Sai um item por linha, e cada item traz também o número da linha na planilha.

Acrescentar linha em tabela grava no fim de uma tabela nomeada. Em Valores da linha (JSON) escreva um objeto com os nomes das colunas — a ordem não importa, o nó casa cada valor com a coluna certa — ou uma lista na ordem das colunas. Em branco, o nó usa os campos do próprio item. A saída confirma a gravação, com a tabela e os valores que entraram.

Listar tabelas ajuda quando você não sabe como a tabela se chama dentro do arquivo.

OneDrive

Grupo Planilhas e documentos. Cuida dos arquivos do drive de uma conta.

Em ID da pasta, em branco significa a raiz do drive.

Baixar arquivo traz o conteúdo pelo mesmo canal de arquivos usado por Ler CSV, Enviar e-mail e RM — Gerar Relatório: indique a Propriedade binária de saída (padrão data) e o próximo nó a encontra por esse nome. Veja Ações para o caminho completo de um arquivo entre nós.

Enviar arquivo manda o conteúdo que veio no item; deixe o Nome do arquivo em branco para reaproveitar o nome original. Se a propriedade binária escolhida estiver sem conteúdo, o nó avisa — costuma ser o caso quando a tela mostra uma saída fixada em vez do resultado de uma execução de verdade. Execute o fluxo e tente de novo. O envio é feito de uma vez só, o que atende bem arquivos pequenos e médios; arquivos muito grandes podem ser recusados pela Microsoft.

Excluir manda o arquivo embora do drive. Confirme o ID antes de ligar o fluxo.

SharePoint

Grupo Planilhas e documentos. Lê e mantém itens de uma lista, e descobre os sites. Este nó não pede usuário — ele age sobre o site.

O campo Site aceita o endereço que você usa no navegador (https://empresa.sharepoint.com/sites/equipe) ou o ID do site; Lista aceita o nome ou o ID. Em Colunas (JSON) escreva um objeto com uma chave por coluna interna da lista, como {"Title": "{{ nome }}", "Status": "Aberto"} — precisa ser um objeto, não uma lista de valores.

Filtro (OData) só funciona sobre colunas indexadas da lista; se um filtro for recusado, peça ao responsável pelo site que indexe a coluna.

Ao ler, criar ou atualizar, o item de saída já vem com as colunas da lista no primeiro nível — você escreve {{ Title }}, e não um caminho aninhado. Os dados próprios do SharePoint (endereço do item, autor, datas) ficam guardados à parte, em _sharepoint, para quem precisar deles.

Listar sites com o campo de busca em branco traz todos os sites que o aplicativo enxerga — é o caminho para descobrir o endereço ou o ID que as demais operações pedem.

Microsoft To Do

Grupo Agenda e pessoas. Mantém as tarefas de uma conta.

Comece por Listar listas: é ela que dá o ID da lista que todas as outras operações pedem.

Em Criar tarefa, o Prazo aceita data ou data e hora escritas de forma simples (2026-08-15 ou 2026-08-15 17:00) e é interpretado no horário de Brasília; se o texto não for entendido, o nó recusa dizendo o formato esperado. Importância vai de Baixa a Normal e Alta.

Trazer só as não concluídas filtra a listagem; vem desligado.

Microsoft Entra ID

Grupo Agenda e pessoas. Administra as contas e os grupos da organização — é o nó para admitir, atualizar, bloquear e agrupar pessoas a partir do que chegou do RM ou de um formulário.

Criar conta exige o conjunto completo: nome de exibição, e-mail de acesso e senha inicial. Faltando qualquer um, o nó recusa dizendo qual é. O Apelido de e-mail é só a parte antes do arroba — em branco, o nó usa a do próprio e-mail de acesso. Pedir troca de senha no primeiro acesso vem marcado. Em Campos (JSON) você acrescenta dados como cargo, departamento e telefone, usando os nomes de campo do Entra (jobTitle, department, mobilePhone).

Atualizar conta grava as alterações e devolve a conta como ficou, não apenas o que você enviou.

Habilitar / desabilitar conta é o desligamento e a readmissão: desabilitada, a pessoa não consegue mais entrar, e a conta continua existindo com o conteúdo dela.

Adicionar pessoa a um grupo aceita o e-mail ou o ID da conta; com o e-mail, o nó localiza a pessoa antes de vinculá-la. Use Listar grupos para descobrir o ID do grupo.

As listagens trazem os dados usuais de cada registro (nome, e-mail, cargo, situação nas contas; nome, descrição e tipo nos grupos), e Filtro (OData) aceita expressões como startswith(displayName, 'Ana').

Microsoft Dynamics 365

Grupo Agenda e pessoas. Lê, cria e atualiza registros do Dynamics — contas, contatos, oportunidades ou qualquer outra entidade da sua organização.

Duas informações são pedidas em todas as operações:

• Endereço da organização — o mesmo endereço com que você abre o Dynamics no navegador (https://suaempresa.crm.dynamics.com). Ele é necessário porque cada organização tem o seu, ao contrário dos demais nós desta família.
• Entidade — o nome no plural usado pela API: accounts, contacts, opportunities. Escrito de outra forma, o nó recusa e lembra o formato.

Colunas a trazer recebe os nomes separados por vírgula (name,telephone1,emailaddress1); em branco, traz todas — o que costuma render itens bem maiores do que o fluxo precisa. Ordenar por aceita algo como createdon desc e Filtro (OData), expressões como statecode eq 0 and contains(name, 'LBHM').

Em Campos (JSON) escreva um objeto com os nomes lógicos das colunas da entidade, como {"name": "{{ razao_social }}", "telephone1": "{{ telefone }}"}. Precisa ser um objeto, não uma lista de valores.

A credencial é a mesma Microsoft 365 (Graph) dos demais nós; o aplicativo é que precisa ter acesso ao Dynamics concedido pelo administrador.

Veja também: Credenciais, Ações e Ajustes do nó.