> ## 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.

# CRM y entrada de leads: diagnóstico

> Por qué los leads no llegan o no se sincronizan: conexión, configuración y ejecución, token vencido, puerta de entrada en pausa, reglas de enrutamiento, agente en pausa, URL o token del webhook, mapeo de campos a Variables y la etapa que dispara la salida en HubSpot, Zoho, GoHighLevel, Odoo, Google Sheets y webhooks propios.

Cómo averiguar por qué los leads de un CRM, un formulario o la API no llegan, llegan al lugar equivocado o no actualizan el CRM.

Verificado el 25 de septiembre de 2026.

## Tres revisiones distintas

Un CRM puede fallar en tres niveles distintos. Revísalos en este orden y no tomes uno como prueba del siguiente:

| Revisión          | La pregunta                                                                                             | Dónde mirar                                                                                                           |
| ----------------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Conexión**      | ¿Nexor puede entrar a la cuenta del CRM?                                                                | **Integraciones** → el CRM. Las **Fuentes de datos** del agente también muestran un estado por fuente.                |
| **Configuración** | ¿El enrutamiento, el mapeo de campos y las salidas están definidos para el agente y la tarea correctos? | **Fuentes de datos** del agente → la fila del CRM, que abre su configuración para ese agente.                         |
| **Ejecución**     | ¿Una importación o sincronización concreta corrió de verdad y dio el resultado?                         | El historial de importaciones o la última ejecución de la puerta de entrada o la ruta, y la línea de tiempo del lead. |

Que la cuenta esté conectada no prueba que los leads se sincronicen. Un trabajo en cola o una vista previa no son una importación terminada.

<Warning>
  Conecta y autoriza un CRM solo desde su pantalla de conexión. Nunca pegues claves API, contraseñas, tokens ni URLs privadas de recepción en una conversación de soporte.
</Warning>

## Por síntoma

| Síntoma                                                      | Revisa primero                                                                                                                                        | Qué hacer                                                                                                                                                      |
| ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Los leads no llegan                                          | La puerta de entrada o la ruta está activa y no en pausa; apunta a una tarea; esa tarea está en vivo; la última ejecución coincide con la frecuencia. | Vuelve a activar la puerta o la ruta, elige la tarea y usa **Poner en vivo** en la tarea. Un lead en una tarea pausada espera hasta que la tarea esté en vivo. |
| Los leads llegan a la tarea equivocada                       | La tarea destino de la ruta o de la puerta, y la ruta de respaldo que se usa cuando ninguna otra coincide.                                            | Cambia la tarea destino en la configuración de la fuente.                                                                                                      |
| Los campos quedan vacíos                                     | El campo del CRM está mapeado a los datos del lead, y esos datos están mapeados a las **Variables** de la tarea.                                      | Mapea el campo. Un valor que el lead entrega en la conversación tiene prioridad sobre el dato que viene del CRM.                                               |
| El CRM no se actualiza cuando un lead llega a una etapa      | La salida está configurada para esa tarea y esa etapa. En Zoho, la condición de etapas.                                                               | Configura la salida para esa etapa. Consulta la guía del CRM.                                                                                                  |
| La fuente muestra que necesita atención o la conexión venció | La credencial se revocó o venció en el CRM.                                                                                                           | Vuelve a conectar desde **Integraciones**.                                                                                                                     |
| No llegan los leads de tu propio formulario o sistema        | La solicitud llega a la URL o clave API correcta, con el token y los campos correctos.                                                                | Revisa la puerta de entrada en **Conexión personalizada**, o la solicitud a la API.                                                                            |

## Por CRM

| CRM                        | Cómo entran los leads                                                                                                        | Con qué frecuencia                                                                                                                                 | Qué devuelve Nexor                                              |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| **HubSpot**                | Puertas de entrada: listas, contactos en tiempo real, o una importación única del portal o de contactos específicos.         | Cada puerta de lista revisa cada 30 minutos a 2 días (por defecto, 1 hora). Los contactos nuevos de una lista conectada pueden llegar en segundos. | Los resultados que configures como salidas en cada tarea.       |
| **GoHighLevel**            | Rutas por pipeline o por workflow de GoHighLevel, con una ruta de respaldo. Webhook en tiempo real y **Auto-sync** opcional. | **Auto-sync** revisa las oportunidades abiertas cada 10 minutos.                                                                                   | Resultados finales mapeados a un estado o etapa de GoHighLevel. |
| **Zoho CRM**               | Zoho funciona principalmente como salida.                                                                                    | Cuando el lead llega al punto configurado.                                                                                                         | Leads y, en cada tarea, organizaciones existentes (Accounts).   |
| **Kommo**                  | Rutas desde los pipelines y etapas que elijas hacia una tarea.                                                               | A medida que Kommo los envía.                                                                                                                      | Consulta la guía de Kommo.                                      |
| **Odoo**                   | Importaciones de los equipos, etapas y tipos de registro que elijas.                                                         | Importaciones manuales o periódicas, con historial.                                                                                                | Nada: la conexión es de solo lectura.                           |
| **Google Sheets**          | Las automatizaciones de **Importar** leen una pestaña de una planilla.                                                       | Se revisan aproximadamente cada 5 minutos.                                                                                                         | Consulta la guía de Google Sheets.                              |
| **Conexión personalizada** | Puertas de entrada: un webhook entrante (una tarea fija) o una clave API.                                                    | A medida que tu sistema los envía.                                                                                                                 | Webhooks de salida, Cloud Functions y herramientas.             |
| **API**                    | Un `POST` del lead con el id de la tarea.                                                                                    | De inmediato.                                                                                                                                      | Webhooks para los eventos a los que te suscribas.               |

## Detalles de HubSpot

* Cada puerta de lista se puede desactivar sin borrar su configuración. **Pausar cuando el contacto sale de la lista** es una opción aparte.
* Mapea las propiedades de HubSpot en **Cómo aterrizan tus datos** antes de importar, y otra vez cuando cambien las propiedades en HubSpot.
* Una conexión no se puede cambiar a otro portal de HubSpot: desconecta primero.
* Los workflows de HubSpot que llaman a Nexor deben enviar el token en el encabezado `x-nexor-hubspot-token`. Un token en la URL ya no se acepta.

## Zoho: crear leads solo desde ciertas etapas

Sí, se puede. En la salida de Zoho de la tarea, activa **Crear el lead en Zoho solo cuando llegue a ciertas etapas** y elige las etapas. Sin esa opción, la salida sigue su disparador por defecto.

## Detalles de GoHighLevel

* **Auto-sync** cubre los pipelines que elijas y que ya enrutan a una tarea en vivo.
* Una ruta se puede pausar y reanudar sin borrarla. Cada importación guarda un historial de ejecuciones.

## Pídele a Nexor AI que lo revise

En el chat del agente puedes pedir una revisión de solo lectura antes de cambiar algo:

* "Muéstrame la conexión de HubSpot y el enrutamiento de entrada de esta tarea. No cambies nada."
* "¿Qué campos del CRM llenan las Variables de esta tarea?"
* "Revisa la última importación y explícame por qué este lead no se sincronizó."

## Guías relacionadas

* [Integraciones](/docs/es/guides/integrations/overview)
* [HubSpot](/docs/es/guides/agents/leads/hubspot), [Kommo](/docs/es/guides/agents/leads/kommo), [GoHighLevel](/docs/es/guides/integrations/gohighlevel), [Zoho](/docs/es/guides/integrations/zoho), [Odoo](/docs/es/guides/integrations/odoo), [Google Sheets](/docs/es/guides/integrations/google-sheets), [Conexión personalizada](/docs/es/guides/integrations/custom-connection)
* [Agrega leads por API](/docs/es/guides/agents/leads/api)
* [Alcance de la configuración: cuenta, agente y tarea](/docs/es/support/settings-scope)
