> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Conectar Google Sheets
> Importa leads desde una pestaña de Google Sheets a un agente de Nexor, con el mapeo, la sincronización y los límites actuales verificados.
Google Sheets puede enviar filas a un agente de Nexor como leads. Cada automatización conecta una pestaña de una hoja con un agente activo y mapea sus columnas a campos del lead.
Usa **Importar leads** para automatizaciones nuevas. La opción **Escribir** aparece en el dashboard, pero su contrato actual de mapeo de columnas no está verificado de punta a punta y puede agregar una fila vacía. No habilites Escribir sin ayuda de Nexor.
Este recorrido se verificó en el dashboard de staging el 7 de septiembre de 2026. Las capturas muestran una configuración de demostración vacía y no contienen la dirección de la cuenta de servicio ni datos de una hoja.
## Antes de empezar
Ten a mano lo siguiente:
* Una cuenta owner o admin en Nexor.
* Una hoja de Google cuyo primer renglón contenga los encabezados de las columnas.
* Una columna con número de teléfono para cada lead. Después de eliminar el formato, un valor válido necesita al menos ocho dígitos.
* El agente activo que debe recibir los leads importados.
No incluyas columnas sensibles en la hoja de origen, salvo que deban almacenarse en Nexor. La selección **Ignorar** actual no está verificada de punta a punta, por lo que una columna sin mapear todavía puede llegar como metadata del lead.
## Configurar una importación
Ve a **Configuración → Integraciones → Google Sheets**. La pantalla de administración sigue disponible aunque no exista una automatización. Selecciona **Nueva automatización**.
Mantén **Tipo** en **Importar leads** y pega la URL de Google Sheets. Nexor lee el título, las pestañas y la fila de encabezados mediante su cuenta de servicio.
Si la hoja es privada, copia la dirección de la cuenta de servicio que muestra el dashboard y comparte la hoja con esa dirección como **Editor**. Usa siempre la dirección de este entorno; no reutilices una de otra cuenta o de un documento.
Elige una pestaña de la hoja y un agente activo. El drawer de Integraciones crea una automatización por pestaña, así que repite la configuración si necesitas otra.
Mapea cada campo de forma explícita. Nexor no infiere el mapeo a partir de los nombres de los encabezados. Exactamente un encabezado debe apuntar a **Teléfono**.
Los destinos estándar son **Teléfono**, **Nombre completo**, **Nombre**, **Apellido**, **Email** y **Ciudad**. Un destino personalizado se almacena en la metadata del lead. **Nombre completo** no puede combinarse con **Nombre** o **Apellido**, y dos encabezados no pueden apuntar al mismo destino.
Revisa la pestaña, el agente y el mapeo seleccionados. Luego elige **Crear automatización**. Mantén la automatización activa para que el importador la incluya en sus revisiones programadas.
## Qué hace la importación
* El importador intenta revisar las automatizaciones activas de tipo Importar cada cinco minutos. Esta es la programación del worker, no un tiempo de entrega garantizado. Las cuotas de Google, el worker y el tiempo de procesamiento pueden agregar demora.
* En la primera revisión, una automatización nueva procesa las filas de datos que ya existen en la pestaña, comenzando después del encabezado. Las envía a Nexor en lotes de 50.
* Después de esa primera revisión, solo se consideran las filas agregadas después de la posición procesada. Editar una fila anterior no actualiza su lead. Agrega filas nuevas al final y evita insertar, borrar o reordenar filas sobre el rango ya importado.
* Una fila sin un teléfono válido se omite. Como la posición procesada avanza de todas formas, corregir la misma fila no la reintenta automáticamente. Agrega una fila corregida al final.
No se encontró en el código actual un contrato de producto para un máximo de filas, columnas o pestañas. Por eso, esta guía no describe la conexión como ilimitada.
## Pestañas creadas desde el onboarding
El drawer actual de Integraciones selecciona una pestaña por automatización. Un flujo de onboarding existente también puede crear conexiones para varias pestañas seleccionadas o expandirse automáticamente a pestañas nuevas. La expansión automática crea una posición separada por pestaña y solo agrega una cuando contiene el mismo encabezado de teléfono usado por la conexión original.
La misma hoja y pestaña puede tener una automatización Importar o una automatización Escribir para una cuenta de Nexor, pero no ambas al mismo tiempo. Las demás pestañas de la hoja son independientes.
## Escribir no está listo para self-service
El dashboard también muestra el tipo **Escribir** y una instrucción **Cuándo escribir**. Esa instrucción orienta al agente; no es un trigger determinista. Cuando su mapeo de ejecución se configura correctamente, cada uso agrega una fila nueva en vez de editar una existente.
No crees todavía una automatización Escribir por self-service. El drawer nuevo guarda nombres de campos simples, mientras que el runtime de escritura espera un mapeo basado en fuentes. Ninguna prueba en staging confirmó el recorrido completo desde este drawer hasta una fila con valores. Contacta a Nexor antes de usar este modo.