Nó: Adicionar linha no Google Sheets

O nó Adicionar linha no Google Sheets adiciona automaticamente uma linha a uma planilha do Google Sheets a partir de um workflow. É a forma mais simples de enviar dados da Omnifox (tarefas de quadros, dados de conversas, resultados de um classificador de IA etc.) para uma planilha externa sem escrever código.

Requisitos

• O workspace precisa ter uma integração do Google Sheets conectada e ativa (configurada em Integrações). Sem essa conexão, o nó é pulado com a mensagem "Não há uma integração do Google Sheets conectada neste workspace".

Quando usar

• Registrar em uma planilha toda vez que uma tarefa de quadro passa para "Concluído".
• Exportar leads capturados por um workflow de WhatsApp ou Webchat para uma planilha compartilhada com o time.
• Manter um log externo de eventos de um workflow (ex.: toda vez que uma oportunidade é criada).

Configuração

• ID da planilha (spreadsheet_id): opcional no nó se a integração já tiver uma planilha padrão configurada; se definido aqui, tem prioridade.
• Nome da aba (sheet_name): opcional; se não for definido, usa a aba padrão da integração ou "Hoja 1".
• Valores: a linha a ser adicionada. Aceita três formatos:
  • Uma lista simples de células.
  • Uma lista de objetos no formato {value: "..."} (o que o editor visual monta).
  • Um texto separado por quebras de linha ou por "|" (ex.: {{trigger.item_title}} | {{trigger.contact_name}} | Concluído). Cada célula aceita variáveis, resolvidas antes de escrever.

Exemplo

Um workflow de quadro dispara quando um cartão passa para o grupo "Concluído". Adiciona-se Adicionar linha no Google Sheets com Valores = {{trigger.item_title}} | {{trigger.assigned_user_name}} | {{trigger.completed_at}}. Cada tarefa concluída fica registrada como uma nova linha na planilha do time.

Dicas

• Experimente primeiro o formato de texto com "|" se não quiser montar a lista de valores manualmente: é o mais rápido de escrever.
• O nó atualiza automaticamente a data da última sincronização da integração, útil para conferir no painel de Integrações que ela continua funcionando.

Solução de problemas

• "Não há uma integração do Google Sheets conectada": conecte ou reconecte a integração em Integrações antes de usar este nó.
• "A linha a adicionar está vazia": verifique se o campo Valores não fica vazio depois de resolver as variáveis.
• A escrita falha mas o workflow continua: este nó nunca interrompe o workflow diante de um erro da API do Google; verifique o detalhe do erro no histórico de execução do workflow.