Integração: Exportar para Google Sheets
O nó Exportar para Google Sheets permite adicionar automaticamente os dados coletados em seus formulários diretamente em planilhas do Google Sheets, sem nenhuma intervenção manual. Toda vez que uma instância do workflow passa por esse nó, uma nova linha é inserida na planilha configurada com as informações que você escolher mapear.
Essa integração é ideal para equipes que precisam acumular um histórico de respostas ao longo do tempo, consolidar dados de múltiplos formulários em uma única planilha de acompanhamento, ou alimentar dashboards e relatórios que já existem no Google Sheets.
Por ser um nó do tipo SINGLE_OUTCOME, o workflow avança automaticamente após a exportação, independentemente do resultado. Não há ramificação de sucesso ou erro: o fluxo continua sempre para o próximo nó conectado.
Pré-requisito: Configurar Conexão Google Sheets
Antes de utilizar este nó, é necessário configurar uma conexão OAuth com o Google na plataforma Hashdata. Essa conexão autoriza o Hashdata a criar e editar planilhas em nome da sua conta Google.
Para configurar a conexão:
- Acesse o menu Configurações no painel lateral.
- Navegue até a seção Integrações.
- Clique em Nova Conexão e selecione Google Sheets.
- Siga o fluxo de autenticação OAuth do Google: faça login com sua conta Google e conceda as permissões solicitadas.
- Após a autorização, a conexão aparecerá na lista de integrações disponíveis e estará pronta para ser usada em qualquer nó do tipo Exportar para Google Sheets.
Durante o fluxo OAuth, o Google solicitará permissão para criar e editar planilhas. Essas permissões são necessárias para que o nó funcione nos dois modos de operação disponíveis.
Modos de Operação
O nó Exportar para Google Sheets oferece dois modos de operação, cada um adequado a um cenário diferente:
Modo "Nova Planilha"
Neste modo, o Hashdata cria automaticamente uma planilha no Google Drive na primeira execução do workflow. A partir da segunda execução em diante, as novas linhas são inseridas na mesma planilha criada anteriormente, acumulando os dados de todas as instâncias.
Este modo é especialmente útil quando você quer que o Hashdata gerencie todo o ciclo de vida da planilha: criação, estruturação das colunas e inserção contínua de dados ao longo do tempo.
Modo "Planilha Existente"
Neste modo, você seleciona uma planilha que já existe no seu Google Drive. A cada execução, o Hashdata insere uma nova linha na aba configurada. A planilha deve existir previamente e a aba informada também deve estar criada.
Este modo é indicado quando você já tem uma planilha estruturada e deseja apenas alimentá-la com os dados do workflow, sem criar novas planilhas.
Se o seu objetivo é construir um histórico de todas as respostas recebidas ao longo do tempo, o modo Nova Planilha é a escolha mais prática. Você não precisa criar nem configurar nada no Google Drive antecipadamente: o Hashdata cuida de tudo na primeira execução do workflow.
Configuração — Modo Nova Planilha
Ao selecionar o modo Nova Planilha, os seguintes campos de configuração estão disponíveis:
| Campo | Descrição | Obrigatório |
|---|---|---|
| Conexão Google Sheets | Selecione a conexão OAuth Google configurada nas integrações do Space. Esta conexão determina em qual conta Google a planilha será criada. | Sim |
| Nome da nova planilha | Nome que será atribuído à planilha criada na primeira execução. Suporta texto fixo. Exemplos: "Respostas do Formulário de Onboarding" ou "Pedidos 2025". | Sim |
| Pasta de destino | Pasta no Google Drive onde a planilha será criada. Se não informada, a planilha será salva na raiz do Drive da conta conectada. | Não |
| Nome da aba | Nome da aba (guia) dentro da planilha onde os dados serão inseridos. Exemplos: "Respostas", "Sheet1", "Dados". | Sim |
| Mapeamento de colunas | Lista de pares Cabeçalho → Valor. O cabeçalho é o nome exato da coluna na planilha. O valor pode ser uma variável do workflow ({{nome_do_campo}}) ou um texto fixo. | Sim |
No modo Nova Planilha, a planilha é criada apenas uma única vez, na primeira execução do workflow. Todas as execuções seguintes adicionam novas linhas nessa mesma planilha. Isso garante que todos os dados fiquem centralizados em um único arquivo, sem criar planilhas duplicadas a cada nova instância.
Configuração — Modo Planilha Existente
Ao selecionar o modo Planilha Existente, os seguintes campos de configuração estão disponíveis:
| Campo | Descrição | Obrigatório |
|---|---|---|
| Conexão Google Sheets | Selecione a conexão OAuth Google configurada nas integrações do Space. Deve ser a mesma conta que tem acesso à planilha que deseja usar. | Sim |
| Planilha existente | Selecione a planilha de destino a partir de uma lista das planilhas disponíveis na conta Google conectada. A planilha deve existir antes de configurar o nó. | Sim |
| Aba | Nome da aba (guia) dentro da planilha selecionada onde os dados serão inseridos. A aba deve existir previamente na planilha. | Sim |
| Mapeamento de colunas | Lista de pares Cabeçalho → Valor. O cabeçalho deve corresponder exatamente ao nome da coluna já existente na planilha. O valor pode ser uma variável ({{nome_do_campo}}) ou texto fixo. | Sim |
No modo Planilha Existente, tanto a planilha quanto a aba informada precisam existir no Google Drive antes da primeira execução do workflow. Se a aba não for encontrada, a exportação poderá falhar silenciosamente ou inserir os dados em local inesperado.
Mapeamento de Colunas
O mapeamento de colunas é o coração da configuração do nó. Ele define quais dados serão exportados e em quais colunas da planilha.
Cada entrada do mapeamento é composta por dois campos:
- Cabeçalho: o nome exato da coluna na planilha do Google Sheets. Este valor deve corresponder precisamente ao cabeçalho da coluna, incluindo maiúsculas, minúsculas e espaços.
- Valor: o conteúdo que será inserido naquela coluna. Pode ser:
- Uma variável do workflow, no formato
{{nome_do_campo}}, referenciando respostas de formulários ancestrais. - Um texto fixo, como o nome de um departamento, um identificador estático ou qualquer outro valor constante.
- Uma variável do workflow, no formato
Comportamento de tipos nativos
- Campos numéricos são enviados como número, permitindo que o Google Sheets realize cálculos diretamente sobre eles.
- Campos de data são enviados como data, preservando a formatação e possibilitando filtros por período.
- Campos de resposta sim/não são enviados como booleano (verdadeiro/falso).
Exemplos de mapeamento
| Cabeçalho | Valor | Resultado na planilha |
|---|---|---|
| Nome | {{nome_completo}} | Texto com o nome respondido no formulário |
| Data de envio | {{data_envio}} | Data formatada no tipo nativo do Google Sheets |
| Valor da proposta | {{valor_proposta}} | Número pronto para cálculos e somatórios |
| Aprovado | {{aprovado}} | Booleano (VERDADEIRO / FALSO) |
| Origem | Portal de Vendas | Texto fixo em todas as linhas |
| Identificação | Pedido #{{numero_pedido}} | Texto combinado, ex: "Pedido #1042" |
Posicionamento no Workflow
O nó Exportar para Google Sheets pode ser posicionado em qualquer ponto do fluxo onde haja dados relevantes disponíveis para exportar. Algumas sugestões comuns de uso:
- Após um formulário de coleta: exporte imediatamente os dados recém-coletados para uma planilha de controle.
- Após uma aprovação: registre o resultado da aprovação junto com os dados do formulário original.
- Ao final do workflow: consolide todos os dados processados ao longo do fluxo em um relatório final no Google Sheets.
- Em workflows com gatilho agendado: combine com o nó Gatilho Agendado para exportações periódicas e automáticas.
Dicas e Boas Práticas
- Nomeie suas colunas com clareza: use nomes descritivos nos cabeçalhos para que a planilha gerada seja compreensível para qualquer pessoa da equipe, mesmo sem conhecimento técnico do workflow.
- Prefira variáveis isoladas para campos numéricos e de data: isso preserva o tipo nativo e permite que o Google Sheets processe corretamente os dados em fórmulas, gráficos e filtros.
- Mantenha uma conexão por conta Google: se você tiver múltiplos workflows exportando para planilhas da mesma conta, utilize a mesma conexão OAuth para facilitar o gerenciamento.
- Combine com outros nós de exportação: use o nó Exportar para Google Sheets em paralelo com o nó Enviar Email para notificar a equipe enquanto os dados são registrados automaticamente na planilha.