Registrar leads de prueba en Google Sheets con n8n

Una hoja bien estructurada es suficiente para empezar a centralizar solicitudes sin contratar una base de datos. En este tutorial crearás una hoja de leads y un workflow de n8n que agrega exactamente dos filas de prueba con columnas predecibles. Después podrás reemplazar el origen de prueba por un Webhook, un formulario o cualquier nodo que entregue los mismos campos.

Estado de verificación: prueba real completada el 13 de septiembre de 2026 en n8n 2.22.5 con OAuth de Google Sheets y una hoja privada de demostración. Una ejecución agregó exactamente dos filas con las seis columnas esperadas. El workflow quedó sin publicar y el nodo de escritura volvió a desactivarse al terminar. Cada lector debe comprobar sus propios permisos y documento antes de ejecutar.

Resultado que obtendrás

  • Una pestaña Leads con encabezados estables: lead_id, nombre, email, tema, estado y recibido_en.
  • Un workflow Manual Trigger → Code → Google Sheets que prepara exactamente dos registros de prueba.
  • Un contrato de datos que permite conectar después un Webhook sin cambiar el nodo de Sheets.

Antes de comenzar

  • Una instancia de n8n Cloud o self-hosted.

  • Una cuenta de Google y una hoja de cálculo de prueba. La escritura en Google Sheets requiere autorizar una credencial de Google dentro de tu instancia; el flujo no incluye ninguna credencial.

  • Permiso de edición sobre el documento de prueba. No uses una hoja con datos de clientes.

  • Crea un documento con una pestaña llamada Leads y escribe estos encabezados en la primera fila, en este orden:

    lead_id | nombre | email | tema | estado | recibido_en

  • El ejemplo usa demo-001, ana@example.com, demo-002 y carlos@example.com, datos reservados para documentación.

Flujo completo

Manual Trigger
      |
      v
Code: crear dos leads de muestra
      |
      v
Google Sheets: Append Row en Leads

Append Row agrega una nueva fila al final de la tabla. No lo presentes como deduplicación: si ejecutas el mismo ejemplo dos veces, la segunda ejecución agregará otras dos filas y terminarás con cuatro. La deduplicación es otro requisito y se trata en el artículo de Gmail.

Paso 1: preparar la hoja

  1. En Google Sheets, crea un archivo de prueba y una pestaña Leads.
  2. Coloca los seis encabezados en la fila 1, sin celdas combinadas y sin espacios adicionales.
  3. Deja las filas siguientes vacías.
  4. Copia solo el ID del documento o usa el selector de documentos de n8n. Si lo escribes manualmente, reemplaza el texto REEMPLAZAR_DOCUMENTO por un ID de prueba, nunca por el de un lector.

El nodo de Google Sheets usa la primera fila como encabezado para mapear columnas. Cambiar email por correo en la hoja sin cambiar el objeto de entrada rompe el mapeo automático.

Paso 2: crear un dato controlado

Añade un Manual Trigger. Conecta un nodo Code, selecciona Run Once for All Items y usa estos dos elementos:

return [
  { json: { lead_id: 'demo-001', nombre: 'Ana López', email: 'ana@example.com', tema: 'Webhook seguro', estado: 'nuevo', recibido_en: '2026-08-27T15:00:00Z' } },
  { json: { lead_id: 'demo-002', nombre: 'Carlos Méndez', email: 'carlos@example.com', tema: 'Google Sheets', estado: 'nuevo', recibido_en: '2026-08-27T15:01:00Z' } },
];

Los identificadores y las fechas son constantes para que puedas reconocer las dos filas de prueba. En un flujo real, genera lead_id en el origen o con un nodo de transformación y genera recibido_en en el momento de recepción. No utilices las fechas fijas como reloj de producción.

Paso 3: configurar Google Sheets

Conecta un nodo Google Sheets al Code y configúralo así. El workflow descargable entrega este nodo desactivado para impedir una escritura accidental; mantenlo así mientras sustituyes el ID y eliges tu credencial, y habilítalo solo para la prueba controlada.

  1. Selecciona o crea una credencial de Google en n8n. La autorización sucede en la interfaz de n8n; nunca pegues un token en este artículo ni en una expresión.
  2. En Resource, selecciona Sheet Within Document si tu interfaz lo muestra.
  3. En Operation, selecciona Append Row.
  4. En Document, selecciona el documento de prueba o usa su ID marcado como reemplazable.
  5. En Sheet, selecciona Leads.
  6. En el modo de mapeo, selecciona Map Automatically para que las claves del JSON coincidan con los encabezados.
  7. Si tu versión muestra el mapeo manual, asigna cada campo a la columna con el mismo nombre. No dejes que el nodo adivine columnas cuando existan nombres parecidos.

Guarda el workflow, pero no lo programes todavía. Un Manual Trigger permite inspeccionar los dos elementos antes de automatizar la entrada.

Paso 4: conectar un origen real más adelante

Cuando las dos filas de prueba sean correctas, reemplaza Manual Trigger y Code por un Webhook u otro nodo de entrada que produzca las mismas seis claves. Conserva el nodo de Google Sheets. Si el formulario usa correo, transforma ese campo a email antes de Append Row. Si recibes más elementos, ejecuta primero con el lote mínimo y comprueba que la correspondencia de columnas no se desplace.

Para muchos registros o una operación crítica, considera un almacenamiento con controles de acceso, validación de esquema y copias de seguridad. Google Sheets es una tabla colaborativa, no una cola transaccional ni un sistema de deduplicación por sí mismo.

Cómo comprobar que funciona

La prueba del 13 de septiembre de 2026 partió de una pestaña con solo encabezados. n8n confirmó una ejecución satisfactoria y la lectura posterior de Sheets mostró exactamente demo-001 y demo-002, con las seis columnas correctas. Para reproducirla, configura la credencial y habilita el nodo de escritura solo para esta prueba; ejecuta manualmente una vez con tu documento autorizado. Debes observar:

  • Dos elementos de entrada con las seis claves en Code.
  • Una ejecución satisfactoria en Google Sheets.
  • Exactamente dos filas nuevas en Leads, debajo de los encabezados: demo-001 con ana@example.com y demo-002 con carlos@example.com.
  • Ninguna credencial, token o URL privada dentro de los datos de la fila.

Ejecuta el workflow una segunda vez solo si necesitas comprobar el comportamiento de Append Row; el resultado esperado serán otras dos filas (cuatro filas de prueba en total), porque esa operación no impide duplicados. Borra las filas de prueba manualmente en la hoja antes de conectar datos reales.

Errores habituales

The resource you are requesting could not be found

  • Causa probable: el documento, la pestaña o el ID indicado no existe o la credencial no tiene acceso.
  • Comprobación: abre el documento con la misma cuenta que autorizaste en n8n y confirma que la pestaña se llama exactamente Leads.
  • Corrección mínima: selecciona de nuevo el documento y la pestaña desde el selector; no pegues un ID perteneciente a otra cuenta.

Las columnas quedan vacías o desordenadas

  • Causa probable: los encabezados no coinciden con las claves JSON, la primera fila está vacía o se usó mapeo manual incorrecto.
  • Comprobación: compara lead_id, nombre, email, tema, estado y recibido_en letra por letra.
  • Corrección mínima: restaura la fila de encabezados y vuelve a seleccionar Map Automatically o asigna cada columna de forma explícita.

La autorización falla o devuelve 403

  • Causa probable: la cuenta canceló el consentimiento, el documento pertenece a otra cuenta o la instancia necesita una configuración OAuth propia.
  • Comprobación: abre la configuración de credenciales de Google en n8n y revisa el mensaje que aparece, sin copiar tokens al chat o a un issue.
  • Corrección mínima: vuelve a autorizar con una cuenta de prueba que tenga permiso de edición y revisa la guía de credenciales de n8n para tu modalidad Cloud o self-hosted.

Se insertan duplicados

  • Causa probable: Append Row siempre agrega al final; además, una ejecución manual repetida vuelve a enviar el mismo elemento.
  • Comprobación: busca el mismo lead_id en la hoja.
  • Corrección mínima: usa una operación de búsqueda y actualización por una clave única, o implementa la estrategia de Append or Update Row cuando el caso lo requiera. No describas Append Row como idempotente.

La fecha aparece con otro formato

  • Causa probable: la configuración regional de la hoja interpreta el texto de fecha de otra forma.
  • Comprobación: observa el valor recibido y la configuración regional del documento.
  • Corrección mínima: guarda fechas en ISO 8601, define el formato de la columna en la hoja y verifica las dos filas de muestra antes de importar un lote.

Seguridad y privacidad

  • Usa un documento separado para pruebas y limita el uso compartido a las personas que realmente necesitan editarlo.
  • example.com es un dominio de ejemplo; reemplázalo por datos ficticios, no por correos de clientes, mientras validas el flujo.
  • No incluyas credenciales, tokens OAuth, enlaces de documentos privados ni IDs reales en el artículo, capturas o exportaciones.
  • Mantén en la hoja solo los campos necesarios para la finalidad del lead y define retención y borrado. Un enlace compartido puede exponer todas las filas.
  • Revisa el alcance que solicita la credencial de Google. drive.file puede ser preferible cuando sea suficiente; los alcances sensibles de Sheets deben evaluarse antes de distribuir una integración.
  • La escritura en Sheets es una mutación externa. Confirma el resultado de las dos filas de muestra antes de activar un origen que pueda entregar muchos elementos.

Fuentes oficiales