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 por XML-RPC, con una clave API. 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 toma prestada la identidad de un miembro: cuenta el token de ese miembro

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.

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.

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.

Producción y pruebas

Aidoo gestiona dos entornos: production y 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 pruebas 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 XML-RPC

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

Al guardar, Aidoo introspecciona tu base 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).

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 bloqueado, véase más abajo

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