Integração: Exportar para Excel 365 (Microsoft)
O nó Exportar para Excel 365 permite que o seu workflow adicione automaticamente linhas de dados em planilhas Excel armazenadas no OneDrive. A cada execução do workflow, uma nova linha é inserida na planilha configurada, consolidando informações coletadas em formulários e outros nós anteriores.
O comportamento deste nó é idêntico ao do nó Exportar para Google Sheets, mas opera inteiramente dentro do ecossistema Microsoft: os arquivos são criados e armazenados no OneDrive, e a autenticação é feita com uma conta Microsoft 365. Se você já conhece o nó do Google Sheets, vai se sentir imediatamente à vontade com este.
O nó Exportar para Excel 365 funciona exatamente da mesma forma que o Exportar para Google Sheets. A única diferença é que utiliza sua conta Microsoft 365 e armazena os arquivos no OneDrive em vez do Google Drive. Toda a lógica de modos, mapeamento de colunas e saída é equivalente.
Este nó possui saída única: avança sempre para o próximo passo, independentemente do resultado da exportação.
Pré-requisito: Configurar Conexão Excel 365
Antes de utilizar este nó em qualquer workflow, é necessário conectar sua conta Microsoft 365 à plataforma Hashdata. Essa conexão é feita uma única vez e fica disponível para todos os workflows do seu espaço.
Como configurar a conexão:
- Acesse Configurações no menu lateral.
- Clique em Integrações.
- Clique em Nova conexão.
- Selecione Excel 365 na lista de integrações disponíveis.
- Clique em Conectar com Microsoft.
- Uma janela de autenticação OAuth da Microsoft será aberta. Faça login com a conta Microsoft 365 que possui acesso ao OneDrive onde as planilhas serão armazenadas.
- Autorize as permissões solicitadas pelo Hashdata (leitura e escrita em arquivos do OneDrive).
- Após a autorização, a conexão aparecerá na lista de integrações com o status Ativa.
A conta Microsoft utilizada na conexão precisa ter permissão de leitura e escrita no OneDrive de destino. Se a conta não tiver acesso suficiente, o nó falhará silenciosamente ou não conseguirá criar/editar a planilha.
Após configurar a conexão, você poderá selecioná-la ao configurar o nó dentro de qualquer workflow.
Modos de Operação
O nó Exportar para Excel 365 oferece dois modos de operação, adequados a diferentes cenários:
Modo: Nova Planilha
Neste modo, o Hashdata cria automaticamente uma nova planilha Excel (.xlsx) no OneDrive na primeira execução do workflow. Nas execuções seguintes, novas linhas são acrescentadas a essa mesma planilha, que vai acumulando todos os registros ao longo do tempo.
Quando usar: Ideal para quando você ainda não possui uma planilha criada e quer que o Hashdata gerencie isso para você. Basta definir o nome da planilha, o nome da aba e o mapeamento de colunas.
Modo: Planilha Existente
Neste modo, você aponta para uma planilha Excel já existente no seu OneDrive. O Hashdata adiciona uma nova linha a cada execução do workflow, sempre ao final da planilha.
Quando usar: Ideal quando você já tem uma planilha com formatação, fórmulas ou outros dados que deseja preservar, e quer que o workflow apenas insira novas linhas nela.
Configuração — Modo Nova Planilha
Ao adicionar o nó ao canvas e selecionar o modo Nova planilha, os seguintes campos de configuração estarão disponíveis:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Conexão | Sim | Selecione a conexão Microsoft 365 configurada previamente em Configurações → Integrações. |
| Nome da planilha | Sim | Nome do arquivo Excel que será criado no OneDrive na primeira execução. Por exemplo: Respostas do Formulário de Vendas. O arquivo receberá a extensão .xlsx automaticamente. |
| Nome da aba | Sim | Nome da aba (planilha interna) onde os dados serão inseridos. Por exemplo: Dados ou Respostas. |
| Pasta de destino no OneDrive | Não | Caminho da pasta no OneDrive onde o arquivo será criado. Se não informado, o arquivo será salvo na raiz do OneDrive da conta conectada. |
| Mapeamento de colunas | Sim | Define quais dados serão exportados e em qual coluna. Veja a seção Mapeamento de Colunas abaixo. |
Escolha um nome descritivo e único para a planilha, especialmente se você tiver múltiplos workflows exportando dados. Isso facilita a identificação dos arquivos no OneDrive.
Configuração — Modo Planilha Existente
Ao selecionar o modo Planilha existente, os campos de configuração são:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Conexão | Sim | Selecione a conexão Microsoft 365 configurada previamente em Configurações → Integrações. |
| Planilha | Sim | Selecione a planilha Excel já existente no OneDrive da conta conectada. A lista exibe os arquivos .xlsx disponíveis. |
| Aba | Sim | Selecione a aba (planilha interna) dentro do arquivo onde as novas linhas serão inseridas. |
| Mapeamento de colunas | Sim | Define quais dados serão exportados e em qual coluna. Veja a seção Mapeamento de Colunas abaixo. |
No modo Planilha existente, a planilha deve ter uma linha de cabeçalho na primeira linha da aba selecionada. O Hashdata usa os nomes das colunas do cabeçalho para identificar onde inserir cada dado.
Mapeamento de Colunas
O mapeamento de colunas é o coração da configuração do nó. Aqui você define a correspondência entre os cabeçalhos das colunas da planilha e as variáveis disponíveis no workflow.
Como funciona:
Cada linha do mapeamento representa uma coluna da planilha. Você define:
- Cabeçalho: O nome exato da coluna na planilha (deve coincidir com o cabeçalho já existente, ou será criado com esse nome no modo Nova planilha).
- Valor: A variável do workflow que fornecerá o dado para aquela coluna. Use a sintaxe
{{nome_do_campo}}para referenciar respostas de formulários ou outros dados disponíveis no fluxo.
Exemplo de mapeamento:
| Cabeçalho da coluna (planilha) | Valor (variável do workflow) |
|---|---|
| Nome do Cliente | {{nome_completo}} |
{{email}} | |
| Produto de Interesse | {{produto_selecionado}} |
| Data de Envio | {{data_resposta}} |
| Observações | {{campo_texto_livre}} |
As variáveis disponíveis dependem dos nós que precedem este no workflow. Formulários respondidos, dados de aprovações e outros nós anteriores alimentam o conjunto de variáveis acessíveis.
No modo Nova planilha, as colunas serão criadas na ordem em que você as definiu no mapeamento. Organize o mapeamento na ordem em que deseja que as colunas apareçam na planilha.
Diferenças em Relação ao Google Sheets
Para quem já utiliza o nó Exportar para Google Sheets, a migração para o Excel 365 é direta. As diferenças são apenas de plataforma:
| Aspecto | Google Sheets | Excel 365 |
|---|---|---|
| Conta de autenticação | Conta Google (Gmail / Google Workspace) | Conta Microsoft 365 |
| Armazenamento dos arquivos | Google Drive | OneDrive |
| Formato do arquivo | Google Sheets nativo (.gsheet) | Excel (.xlsx) |
| Configuração da conexão | OAuth com conta Google | OAuth com conta Microsoft |
| Modos de operação | Nova planilha / Planilha existente | Nova planilha / Planilha existente |
| Mapeamento de colunas | Idêntico | Idêntico |
| Saída do nó | Única (avança sempre) | Única (avança sempre) |
| Comportamento acumulativo | Sim, linhas adicionadas ao final | Sim, linhas adicionadas ao final |
A lógica de funcionamento, os modos de operação e o mapeamento de colunas são completamente equivalentes entre os dois nós. A escolha entre um e outro depende apenas de qual plataforma de produtividade sua organização utiliza.
Exemplo de Uso
Imagine um workflow de cadastro de leads em que um formulário coleta informações de potenciais clientes. Após o preenchimento, o workflow pode:
- Enviar um email de confirmação ao lead com o nó Enviar Email.
- Exportar os dados do lead para uma planilha Excel no OneDrive com o nó Exportar para Excel 365.
- Notificar a equipe de vendas via Enviar Mensagem no Teams.
Com esse fluxo, sua equipe de vendas tem acesso a uma planilha sempre atualizada no OneDrive, consolidando todos os leads capturados pelo workflow automaticamente.
Saída do Nó
O nó Exportar para Excel 365 possui saída única. Ele sempre avança para o próximo nó conectado, independentemente do resultado da exportação. Não há saída de erro separada neste nó.
Caso ocorra um problema na exportação (por exemplo, perda de conexão com a conta Microsoft ou permissões insuficientes), o erro será registrado nos detalhes da instância do workflow. Verifique a aba de histórico de execuções para diagnosticar eventuais falhas.