La conexión con Odoo es la base de todo lo demás: es la que da a Aidoo, y por tanto a tus asistentes, agentes y paneles, acceso a tus datos.

Aidoo se conecta a Odoo con una clave API, por XML-RPC, o mediante la API JSON en las bases Odoo 19 y posteriores que ya no exponen XML-RPC: Aidoo lo detecta por sí mismo al probar la conexión. Sin módulos de Odoo que instalar, sin webhooks que configurar.

Generar la clave API en Odoo

Una clave API, nunca una contraseña

Odoo permite autenticarse por XML-RPC con la contraseña de una cuenta. No lo hagas: una contraseña no se puede revocar sin cambiar la cuenta, no caduca y da acceso a la interfaz web. Una clave API se revoca con un clic y solo sirve para la API.

En tu Odoo:

Avatar arriba a la derecha → Mi perfil
Pestaña Seguridad de la cuenta → Nueva clave API
Ponle el nombre Aidoo y elige un periodo de validez
Copia la clave: Odoo no volverá a mostrarla

¿Qué cuenta de Odoo usar?

Esta clave sirve para establecer la conexión y leer la estructura de tu base. No ejecuta las peticiones de tus equipos.

Cada miembro actúa con sus propios permisos de Odoo

Una vez establecida la conexión, cada persona registra su clave API de Odoo en Equipo → Token de Odoo. Sus peticiones salen entonces con su identidad y sus permisos: un contable ve la contabilidad, un comercial ve su cartera. La clave de conexión nunca se usa para actuar en su lugar, y un miembro que aún no haya vinculado su cuenta recibe un mensaje pidiéndoselo.

Puedes por tanto dar a ciertos miembros permisos de Odoo más amplios que los de la cuenta de conexión: decide su propio token.

Contexto	Cuenta recomendada para la conexión
Descubrimiento, prueba	Tu cuenta de administrador, es lo más rápido
Producción	Un usuario de Odoo dedicado, llamado `Aidoo`, con los permisos de lectura que necesita la introspección
Agentes autónomos	Cada agente actúa con la cuenta de Odoo que le asignas (idealmente un usuario dedicado): cuentan los permisos de esa cuenta

Vigila la caducidad

Una clave API de Odoo caducada corta Aidoo en seco, con un error de autenticación. Anota la fecha de caducidad al crearla y planifica la renovación: es la primera causa de incidencias en producción.

Rellenar la conexión en Aidoo

Abre Conexión Odoo en Aidoo. Esta conexión la comparte todo el equipo: solo los propietarios y administradores la configuran, los miembros solo declaran su clave personal.

Campo	Qué espera	Error frecuente
URL de Odoo	La dirección de tu Odoo	Poner la dirección de otro servicio
Nombre de la base	Se rellena automáticamente cuando es posible	Confundirlo con el nombre de la empresa
Nombre de usuario	El login de la cuenta que creó la clave	Usar el nombre mostrado en vez del login
Clave API de Odoo	La clave copiada en Odoo	Pegar la contraseña de la cuenta

Haz clic en Probar la conexión antes de guardar. Aidoo ejecuta una llamada authenticate real: la insignia Conectado significa que los cuatro campos son correctos.

Introducir las credenciales de Odoo en Aidoo y probar la conexión.

Al guardar, Aidoo te propone reutilizar estas credenciales para tu propia cuenta (Sí, configurar mi cuenta): es lo más sencillo para la primera persona que configura el espacio. Una casilla, marcada por defecto, añade además un acceso directo "Aidoo" al menú de tu Odoo (la cuenta de Odoo debe ser administradora).

Cambiar la URL o la base invalida las claves de los miembros

Modificar la URL o el nombre de la base de una conexión existente obliga a cada miembro a declarar de nuevo su clave API de Odoo e interrumpe las conexiones en curso. Aidoo te pide confirmación antes.

Encontrar el nombre de la base

En la mayoría de los casos no hay nada que buscar: en cuanto se introduce la URL, Aidoo consulta tu instancia y rellena el campo. Si encuentra varias bases, te las propone; si no encuentra ninguna, tu Odoo tiene desactivado el listado de bases y hay que escribirla a mano.

En ese último caso:

Odoo Online (.odoo.com): suele ser el subdominio. Para https://acme.odoo.com, la base se llama casi siempre acme.
Odoo.sh: el nombre aparece en la pestaña Ramas, con el formato nombre-rama-1234567.
Autoalojado: abre https://tu-odoo/web/database/selector. Si solo aparece un nombre, es ese.

Opciones avanzadas

Bajo el formulario, Opciones avanzadas → Protocolo de conexión ofrece tres modos: XML-RPC (por defecto, recomendado), JSON-RPC (sesión web, que puede requerir una contraseña en lugar de una clave API) y API JSON (Odoo 19+). Cambia este ajuste solo si tu Odoo rechaza las conexiones XML-RPC, por ejemplo por un módulo de terceros.

Producción y pre-producción

Aidoo gestiona dos entornos: Producción y Pre-producción (staging), cada uno con sus propias credenciales. Solo uno está activo en un momento dado, y esa elección es propia de cada miembro: puedes trabajar sobre la copia de pruebas mientras el resto del equipo sigue en producción. Sin elección personal, se aplica el entorno del espacio.

La ventaja: apuntar tus asistentes a una copia de pruebas mientras validas un flujo de escritura, y luego pasar a producción sin reconfigurar nada en Claude.

El cambio surte efecto de inmediato, incluso en plena conversación

Se aplica desde la siguiente llamada: no hay que reiniciar nada. Ahora bien, el asistente memorizó el entorno al inicio de la conversación y seguirá anunciando el anterior aunque ya consulte el nuevo. Dile que has cambiado, o abre una conversación nueva, para que lo que dice coincida con lo que hace.

Los permisos de la clave API se configuran por entorno: puedes permitir la escritura en pre-producción y denegarla en producción.

Cifrado y almacenamiento

Tus credenciales de Odoo se cifran con AES-256-GCM antes de escribirse en la base, con una clave de cifrado propia de la infraestructura de Aidoo que nunca se almacena junto a los datos.

En concreto:

la clave API de Odoo nunca la devuelve la API de Aidoo, ni siquiera al propietario del espacio: la interfaz muestra un campo enmascarado
no aparece en ningún registro, ninguna traza de error ni ninguna exportación
solo se descifra en memoria, durante una llamada a Odoo

Dejar el campo vacío al guardar conserva la clave ya almacenada: puedes cambiar la URL o el login sin volver a escribirla.

Lo que Aidoo lee en el primer contacto

Tras cada conexión correcta, Aidoo introspecciona tu base en segundo plano para descubrir los modelos disponibles y sus campos. Esta introspección no lee ningún dato de negocio: solo la estructura (nombres de modelos, nombres y tipos de campos, relaciones).

También se vuelve a ejecutar cada noche, para recoger los módulos instalados o los campos añadidos entretanto, y bajo demanda desde la pestaña Modelos de la página Conexión Odoo (botón Introspeccionar). Un propietario o un administrador puede desactivar la introspección lanzada en cada conexión: Ajustes → Odoo y logs → Introspección automática al conectar. La introspección nocturna y la manual siguen activas.

Es lo que permite al asistente saber que tu base tiene un campo personalizado x_codigo_cliente en res.partner, y usarlo sin que tengas que explicárselo.

Después puedes bloquear modelos o campos enteros para que nunca sean accesibles, consulta Seguridad y permisos.

Diagnóstico

«Falló la prueba de conexión»

Por orden de probabilidad:

Nombre de base incorrecto: la causa en la mayoría de los casos, cuando la detección automática no ha funcionado
Dominio erróneo: comprueba que la dirección es realmente la de tu Odoo
Login inexacto: es el identificador de acceso, a menudo un correo electrónico
Clave caducada o revocada: genera otra en Odoo
XML-RPC no disponible, véase más abajo

Odoo no responde por XML-RPC

Las bases Odoo 19 y posteriores, en particular las nuevas bases de Odoo Online, ya no siempre exponen XML-RPC. Aidoo lo detecta al probar la conexión y pasa por sí solo a la API JSON. Si la prueba sigue fallando, o si un módulo de terceros bloquea la autenticación XML-RPC, elige el protocolo adecuado en Opciones avanzadas (véase más arriba).

«Access denied» aunque las credenciales son correctas

La cuenta existe pero la clave no le corresponde, o la clave ha caducado. Genera una clave desde el perfil de esa cuenta concreta: una clave creada por otro usuario no funcionará.

Error de red o tiempo agotado

Tu Odoo no es accesible desde internet, o un cortafuegos bloquea las llamadas salientes. Aidoo llama a tu Odoo desde sus propios servidores: una instancia accesible solo en tu red interna o tras una VPN no puede funcionar.

Si tu Odoo está protegido por una lista de IP autorizadas, contáctanos para obtener las direcciones IP salientes de Aidoo.

El asistente no ve un modelo que existe

Dos causas posibles: la cuenta de Odoo no tiene permisos de acceso a ese modelo, o el modelo está bloqueado en los ajustes de Aidoo. Compruébalo primero en Odoo, iniciando sesión con esa cuenta.

Siguiente paso

Tu Odoo está conectado: solo falta enchufarle un asistente.