> ## 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 Odoo > Conecta Odoo con una conexión nativa de solo lectura mediante clave API, configura y previsualiza entradas, y distínguela del alias del webhook genérico. Nexor ofrece dos caminos separados para Odoo. Usan credenciales distintas y tienen propósitos diferentes: 1. La **conexión nativa de Odoo** inicia sesión en una instancia con su URL, base de datos, usuario o email y clave API de Odoo. Descubre los objetos de CRM que puede leer y ofrece un workspace de Entradas. 2. El **alias del webhook genérico de entrada** permite que una automatización externa envíe un lead a Nexor mediante `POST /api/public/leads/odoo`. No inicia sesión en Odoo ni ofrece el workspace nativo. > [!WARNING] > > La conexión nativa actual es de solo lectura. Están disponibles la conexión, el descubrimiento de capacidades, la configuración de entradas y una vista previa sin escrituras. Aplicar la importación automática y **Sincronizar ahora** está deshabilitado en la versión revisada del producto, por lo que el camino nativo no crea ni mueve personas en Nexor actualmente. ## Conexión nativa de Odoo ![Formulario nativo de Odoo con URL, base de datos, usuario o email, clave API y vencimiento opcional.](https://mintcdn.com/nexor/7_xWfOhMNwV0KbZa/images/integrations/odoo-connect-staging-2026-09-07.png?fit=max\&auto=format\&n=7_xWfOhMNwV0KbZa\&q=85\&s=b5529e18314e936fe9632ddbf2811f0c) Formulario vacío de la conexión nativa de Odoo en staging el 7 de septiembre de 2026. No se ingresó ni expuso ninguna credencial. ### Antes de conectar La cuenta de Odoo debe tener acceso a la API externa, la aplicación CRM instalada y permisos de lectura para los leads u oportunidades, contactos, equipos de venta y etapas que muestra la guía de conexión. Los repositorios de Nexor no permiten confirmar qué plan comercial de Odoo entrega ese acceso. Se deben preparar estos valores: * **URL de Odoo** * **Base de datos** * **Usuario o email de Odoo** * **Clave API** * **Fecha de vencimiento de la clave API**, si la clave tiene una La clave API se cifra antes de guardarse. La API de conexión no devuelve la clave almacenada y la interfaz no vuelve a mostrarla. ### Conectar y descubrir capacidades **1. Abrir Odoo** Ir a **Integraciones → Odoo** y confirmar los requisitos que muestra la página. **2. Ingresar los datos de conexión** Completar la URL de Odoo, base de datos, usuario o email y clave API. Agregar la fecha de vencimiento solo si se conoce. **3. Conectar** Seleccionar **Conectar**. Nexor valida la credencial y descubre las compañías, equipos, etapas, tipos de registro y campos que la cuenta puede leer. **4. Revisar el informe de capacidades** Confirmar la versión de Odoo, el transporte, los objetos legibles y la limitación actual de solo lectura antes de configurar Entradas. Nexor puede usar el transporte actual de la API de Odoo y recurrir a compatibilidad XML-RPC cuando sea necesario. No se debe asumir un único transporte o versión de Odoo a partir de esta integración. ## Configurar y previsualizar Entradas El workspace conectado permite preparar cómo se interpretarían los registros de Odoo. Guardar esta configuración no habilita la aplicación de importaciones, que está desactivada actualmente. ### Fecha de corte y rutas de entrada Se puede elegir la fecha de creación más antigua que Nexor debe leer. Una ruta de entrada puede combinar compañía, equipo de venta, etapa y tipo de registro (`lead`, `opportunity` o ambos), y luego asignar uno de estos efectos: * **Crear o continuar en Nexor**: seleccionar un Agente de Nexor que administraría a la persona. * **Solo observar**: mantener visible la oportunidad sin iniciar ni mover un Agente. * **No sincronizar**: excluir los registros que coincidan. La configuración admite hasta 200 rutas. Nexor rechaza solapamientos ambiguos. Cuando varias rutas válidas coinciden, gana la más específica. ### Entradas del ciclo de vida Los eventos `won`, `lost`, `restored` y `archived` se pueden mapear hacia una etapa de un Agente. Estos mapeos describen el comportamiento de entrada previsto, pero no se aplican mientras la importación nativa siga deshabilitada. ### Campos y transformaciones Se pueden mapear campos de `crm.lead` o `res.partner` hacia nombre, apellido, email, teléfono, empresa, cargo, ciudad, fecha de nacimiento o una clave aprobada bajo `metadata.*`. La configuración admite hasta 200 mapeos y un mapeo activo por destino. Las transformaciones disponibles incluyen recortar texto, convertir el email a minúsculas, normalizar teléfonos, convertir booleanos y números, convertir fechas y fechas con hora, mapear enums y extraer identificadores de relaciones. El lead resultante necesita un nombre y al menos un email o teléfono. ### Límites de seguridad Los valores predeterminados permiten un máximo de 200 personas nuevas por corrida y pausan el proceso si una vista previa supera 1.000. El servidor acepta un umbral configurable para pausar la vista previa de hasta **5.000**, y debe ser igual o mayor que el límite por corrida. > [!NOTE] > > La configuración nativa usa un intervalo fijo de lectura de 10 minutos. Como la aplicación de importaciones está deshabilitada actualmente, ese ajuste no hace que los registros de Odoo creen o muevan personas en Nexor. ### Vista previa Seleccionar **Vista previa** permite revisar el plan sin crear personas ni modificar Odoo. La vista previa queda ligada a la configuración exacta guardada y vence después de 30 minutos. Para pasar las validaciones normales de activación, debe estar vigente, completa, bajo el límite de seguridad y sin conflictos pendientes. La activación sigue bloqueada por la limitación actual del producto. Si las oportunidades de una persona apuntan a Agentes diferentes, el centro de conflictos permite registrar qué oportunidad se debe mantener activa o si se debe ignorar el caso. Resolver el conflicto solo guarda una decisión. No contacta a la persona, no sincroniza el registro y no escribe en Odoo. ## Alias del webhook genérico de entrada `POST /api/public/leads/odoo` es un alias de compatibilidad del webhook genérico de entrada de leads. Una automatización externa envía un payload de lead a Nexor. No usa la conexión nativa de Odoo ni su clave API. Se debe usar una clave API de intake de Nexor en el parámetro `token` de la URL. Un mapa asociado a esa clave puede traducir los nombres externos hacia los campos canónicos de lead de Nexor. Sin un mapa, el endpoint espera el payload canónico. Consultar [Webhooks de entrada de leads](/docs/es/api/webhooks/inbound-leads.md) para ver la autenticación, el payload, el enrutamiento y las respuestas. > [!WARNING] > > Nunca se debe poner la clave API de la cuenta de Odoo en la URL del webhook. La credencial nativa de Odoo y la clave de intake de Nexor son secretos distintos. ## Rotar o desconectar la credencial nativa **Rotar clave API de Odoo** valida la clave nueva y actualiza el descubrimiento de capacidades. La rotación conserva las rutas y el historial, pero exige una vista previa nueva. La clave actual no se puede ver. Si vence la fecha informada o si Odoo rechaza la credencial, las lecturas nativas se detienen hasta rotar la clave. Nexor no impone ni documenta una duración universal para las claves API de Odoo. **Desconectar** elimina la credencial activa y detiene la integración. Conserva las rutas configuradas y el historial de sincronización. Para reconectar sobre la conexión existente se deben usar la misma URL base de Odoo, base de datos y usuario. ## Cobertura de capturas El formulario vacío de conexión nativa se verificó en staging el 7 de septiembre de 2026. No se pudieron capturar los encabezados conectados ni las pantallas de Entradas, rutas, mapeos, resultados de vista previa, conflictos, historial, informe de capacidades, rotación de credencial y desconexión porque no había una conexión nativa de Odoo autorizada con datos de demostración seguros. Esas verificaciones visuales quedan pendientes y no se reemplazan con registros de ejemplo. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.