Saltar al contenido principal
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.
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.

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.
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 para ver la autenticación, el payload, el enrutamiento y las respuestas.
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.
Última modificación el 8 de septiembre de 2026