Cómo conectar Odoo con BOTS4.me: guía de instalación del conector (Odoo 13–19)

🧭 Primero elija su vía: ¿dónde se ejecuta su Odoo?

Hay dos vías de instalación, y lo único que decide entre ellas es su tipo de alojamiento de Odoo. Ambas llevan al mismo sitio: una sola conexión sirve a todas las aplicaciones de BOTS4.me que trabajan con Odoo.

¿No sabe qué alojamiento tiene, o todavía está eligiendo? Consulte Odoo Online frente a Odoo.sh frente a on-premise: ¿cuál puede automatizar?

Nota sobre el plan: Odoo Online necesita el plan Custom de Odoo para el acceso a la API; Odoo.sh y las instalaciones locales funcionan con cualquier plan.

🔌 Vía A: Odoo.sh & on-premise — el conector de un clic

• Paso 1 — Cree su cuenta de BOTS4.me. Regístrese en bots4.me/bots, u omita este paso y cree la cuenta dentro de Odoo en el paso 3. Cada aplicación de inicio gratuito empieza después con un mes Discovery gratuito.
• Paso 2 — Instale «BOTS4.me Connect». En apps.odoo.com, abra BOTS4.me Connect, elija su versión de Odoo (13.0 a 19.0) y descargue el zip gratuito; contiene una sola carpeta, b4m_connect. On-premise: coloque esa carpeta en un directorio de su ruta de addons, reinicie el servicio de Odoo, active el modo desarrollador, abra Aplicaciones → Actualizar lista de aplicaciones, busque «BOTS4.me Connect» y haga clic en Activar (Instalar en versiones anteriores). Odoo.sh: haga commit de la carpeta en su repositorio (pruebe primero en una rama de staging) y haga push; cuando el build esté en verde, instálelo desde Aplicaciones en la base de datos de ese build. Los módulos de una sola aplicación de la tienda (por ejemplo, «Mail2ERP by BOTS4.me») se instalan igual y solo muestran su propia aplicación. El código fuente es LGPL-3, así que usted o su integrador pueden leer cada línea antes de instalarlo.
• Paso 3 — Ejecute el asistente de conexión. Como administrador de Odoo, abra BOTS4.me Connect → Configuración y haga clic en Conectar. Elija «Crear una cuenta nueva en www.bots4.me» (introduzca su correo; si un partner de BOTS4.me nos recomendó, ponga su código en Código de partner) o «Ya tengo una cuenta en www.bots4.me» (correo y contraseña). Después introduzca el código de 6 dígitos de su correo, o el de su aplicación de autenticación si usa una. El asistente habla directamente con bots4.me por HTTPS; no se teclea ninguna credencial en pantallas de terceros.
• Paso 4 — Las claves se generan por usted. Tras un inicio de sesión correcto, BOTS4.me emite una clave API y un secreto de firma HMAC para esa base de datos de Odoo concreta, y el módulo crea un usuario técnico local, «BOTS4.me Connect», para que los bots lean y escriban registros de Odoo por XML-RPC con su propia identidad, nunca con su usuario de administrador personal. Ese usuario recibe solo los permisos de Odoo de las aplicaciones que active. Como cualquier usuario interno, cuenta para una suscripción de Odoo Enterprise por usuario. En Odoo 18 y posteriores, Odoo limita cuánto tiempo son válidas las claves API: cuando el módulo muestre «La clave API caduca pronto», haga clic en Desconectar y después en Conectar, sin perder ningún ajuste de las aplicaciones.
• Paso 5 — Los formularios de configuración vienen rellenados. El conector envía los metadatos de su Odoo (URL, UUID de la base de datos, bloque de facturación de la empresa, direcciones de los servidores de correo IMAP) para rellenar previamente los formularios de configuración de BOTS4.me. Las contraseñas de correo se quedan en su Odoo hasta que entregue un buzón a una aplicación, ya sea con + Mi correo IMAP (1 clic) o haciendo clic en Iniciar el mes Discovery gratuito en una aplicación que lee correo. Se cifran antes de salir de su Odoo.
• Paso 6 — Active su primera aplicación. En Aplicaciones, cada aplicación muestra su estado (Sin activar, Necesita configuración, Activo, Configurado). Haga clic una vez en Complete primero la facturación, rellene sus datos de facturación en bots4.me y después haga clic en Iniciar el mes Discovery gratuito en la aplicación que quiera. Ese único clic activa la aplicación, conecta este Odoo como su ERP y, en las aplicaciones que leen correo, le entrega su buzón IMAP de Odoo. Todo lo que aún falte tiene su propio botón en la aplicación: + Este Odoo como ERP (1 clic), + Mi correo IMAP (1 clic), + Buzón (Gmail, Microsoft 365) o + Almacenamiento en la nube. Panel, Registros y Configuración abren bots4.me con la sesión ya iniciada.

☁️ Vía B: Odoo Online — configuración sin código con una clave API

Odoo Online (la edición SaaS de odoo.com) no permite módulos Python personalizados — es una regla de la plataforma, no una limitación de BOTS4.me. Por eso la vía Online usa un módulo asistente XML sin código más una clave API estándar de Odoo que usted mismo crea (el acceso a la API externa forma parte del plan Custom de Odoo):

• Paso 1 — Cree su cuenta de BOTS4.me en bots4.me/bots.
• Paso 2 — Cree una clave API de Odoo. En su base de datos de Odoo Online, vaya a Ajustes → Usuarios y empresas → Usuarios → su usuario → Seguridad de la cuenta (active el modo desarrollador si la pestaña está oculta) y haga clic en Nueva clave API. Llámela «BOTS4.me», elija cuánto tiempo será válida (Odoo 18 y posteriores lo preguntan) y copie la clave; Odoo solo la muestra una vez. Antes de que caduque, cree una nueva y péguela en la misma conexión de Odoo en bots4.me (Editar → Actualizar cuenta de ERP).
• Paso 3 — Inicie la aplicación y pegue la clave en bots4.me. Inicie sesión en bots4.me/bots, haga clic en Empezar el mes Discovery gratuito en la tarjeta de la aplicación y acepte las Condiciones una sola vez — sin tarjeta de crédito. Después abra Configuración (engranaje) → la aplicación → Access Manager, haga clic en Añadir destino o Añadir origen (la aplicación muestra el que necesita), elija ERP → Odoo y rellene la URL de Odoo (para https://yourcompany.odoo.com el nombre de la base de datos se rellena solo), su correo de inicio de sesión como Nombre de usuario y la clave API en Contraseña o clave API. Haga clic en Añadir cuenta de ERP.
• Paso 4 — Añada el asistente sin código (opcional). El módulo «BOTS4.me for Odoo Online» de apps.odoo.com solo contiene registros de datos, sin Python, así que Odoo Online lo acepta. Añade a su Odoo una aplicación BOTS4.me con Conectar / Panel, Guía de configuración y Cómo crear una clave API. En cualquier caso, los bots se conectan mediante la API externa estándar de Odoo.
• Paso 5 — Verifique en DEMO. En la pestaña Control de la aplicación, active Encendido del bot y deje el Modo en DEMO. Tras la primera ejecución recibe un correo de informe DEMO con lo que el bot leyó y lo que habría escrito, y la pestaña Registros muestra cada decisión; no cambia nada en Odoo. Cuando los informes DEMO le parezcan correctos, ponga Modo en LIVE en la pestaña Control — se desbloquea tras el primer correo de informe DEMO.

🧭 Pruébelo en su mes Discovery gratuito

El primer mes de cada aplicación de inicio gratuito es un mes Discovery gratuito: el volumen de uso del plan Personal con muchas funciones Family y Business desbloqueadas para probarlas, y sin tarjeta de crédito. Este es el camino más corto de «conectado» a un primer resultado en Odoo.

• 1 — Inicie la aplicación. En Odoo (Odoo.sh, on-premise): BOTS4.me Connect → Configuración, haga clic una vez en Complete primero la facturación y después en Iniciar el mes Discovery gratuito en la aplicación. En Odoo Online: inicie sesión en bots4.me/bots, haga clic en Empezar el mes Discovery gratuito en la tarjeta de la aplicación y acepte las Condiciones una sola vez — sin tarjeta de crédito. En ambos casos el panel muestra después «Mes Discovery gratuito — quedan N días».
• 2 — Conecte lo que necesita la aplicación. En Odoo, iniciar la aplicación ya conecta este Odoo y, si su Odoo tiene un servidor de correo IMAP, su buzón. Use + Este Odoo como ERP (1 clic) o + Buzón (Gmail, Microsoft 365) para lo que aún falte. En Odoo Online, añada la conexión de Odoo en el Access Manager como se describe en la vía B, y el buzón con Añadir origen.
• 3 — Ejecútela en DEMO. Abra la pestaña Control de la aplicación (o Control rápido en Odoo), active Encendido del bot y deje el Modo en DEMO. Los interruptores con la etiqueta Discovery en la pestaña Control están incluidos en su mes gratuito y empiezan desactivados — active los que quiera probar.
• 4 — Revise el resultado. Lea el correo de informe DEMO tras la primera ejecución y la pestaña Registros: cada documento que leyó el bot y lo que habría creado o cambiado en Odoo.
• 5 — Pase a LIVE. Cuando los informes DEMO le parezcan correctos, ponga Modo en LIVE en la pestaña Control — se desbloquea tras el primer correo de informe DEMO. A partir de ahí el bot escribe en Odoo mediante la conexión que configuró, con los permisos de su usuario de Odoo.
• 6 — Después del mes. Cuando termina el mes, la aplicación continúa por sí sola con el plan gratuito y una pequeña cuota mensual: cuando se agota, los elementos nuevos esperan hasta el mes siguiente o hasta que elija un plan, y un elemento ya iniciado siempre se completa. Elija un plan para conservar todas las funciones — consulte la tabla de planes en la página de producto de la aplicación.

🔒 El modelo de seguridad, explicado con honestidad

Está dando a un servicio externo acceso a su ERP, así que debería exigir detalles concretos — y no solo una insignia de “seguridad de nivel bancario”. Así está construido exactamente BOTS4.me Connect:

• Solo HTTPS, fijado en el código. El endpoint de la API está fijado a https://bots4.me en el código fuente del módulo — no es un campo de configuración editable, así que un registro de configuración comprometido no puede redirigir su tráfico de API a un servidor hostil. Cada URL que devuelve la API se verifica antes de que su navegador la abra; las respuestas que no sean HTTPS o que apunten a otro host se rechazan.
• Firma de peticiones con HMAC-SHA256. Cada llamada que el módulo hace a BOTS4.me se firma con el secreto propio de esa base de datos, de modo que las peticiones no se pueden falsificar ni manipular por el camino.
• Credenciales restringidas a los administradores. Los campos de la clave API, el secreto de firma y el usuario técnico tienen un acceso a nivel de campo limitado al grupo de administración de Odoo (base.group_system). Los usuarios internos normales ven el lanzador y el estado de las aplicaciones, pero los secretos nunca aparecen en ninguna lectura de registros que ellos puedan ejecutar — y todas las acciones de conectar, desconectar y configurar son solo para administradores.
• Código abierto, LGPL-3. El código fuente completo va dentro del zip que descarga de apps.odoo.com, para que su integrador pueda auditar exactamente lo que sale de su servidor: metadatos para rellenar formularios, una contraseña de correo solo cuando entrega ese buzón a una aplicación (cifrada antes de salir) y nunca sus documentos de negocio.
• Registro de auditoría en ambos lados. El módulo mantiene dentro de Odoo un registro local de eventos con las conexiones, los cambios de configuración y los errores; el panel de BOTS4.me conserva los registros completos de decisiones de cada ejecución.
• Refresco automático de derechos. Una tarea programada vuelve a comprobar sus suscripciones con regularidad, de modo que el estado de las aplicaciones en el lanzador se mantiene al día — y una aplicación cancelada deja de prestarse enseguida.

Más información sobre la seguridad de la plataforma y el acceso gradual: bots4.me/security y niveles de acceso. La plataforma está alojada en la UE, está diseñada para el RGPD y la 2FA está disponible en todas las cuentas.

✅ Después de conectar: una sola conexión para todas las aplicaciones de Odoo

El conector se instala una sola vez; no hay que instalar nada más por aplicación. Una sola conexión sirve a todas las aplicaciones de BOTS4.me que funcionan con Odoo: Mail2ERP, AutoERP, Pay2ERP, Supplier2ERP y AutoCASH, además de AutoSTOCK, AutoPURCHASE y ClientFACTORY. AutoSPAM, Mail2CLOUD y Mail2KNOW solo necesitan un buzón, que el conector puede transferir desde su Odoo con un clic. Cada aplicación se inicia por separado, desde su fila en Odoo o desde su tarjeta en bots4.me/bots.

Cada aplicación empieza en DEMO: lee, decide y le envía por correo un informe DEMO, pero no escribe nada. Cuando los informes DEMO le parezcan correctos, ponga Modo en LIVE en la pestaña Control — se desbloquea tras el primer correo de informe DEMO. En bots4.me, la pestaña Control de cada aplicación reúne Encendido del bot, el Modo, el Modo de IA (Desactivado, IA esencial, IA Premium o Ultra, según la aplicación), la Programación de ejecución y el Horario de funcionamiento cuando la aplicación los tiene, y sus interruptores de funciones. La pestaña Registros muestra cada decisión. En Odoo, Control rápido en la fila de la aplicación abarca Encendido del bot, Programación de ejecución, Modo demo y Modo de IA. Para saber qué automatizar primero, consulte la guía principal: Cómo automatizar Odoo de principio a fin.

📚 Guías relacionadas

• Empiece por aquí: Cómo automatizar Odoo de principio a fin: del pedido por correo a la factura cobrada
• Alojamiento: Odoo Online frente a Odoo.sh frente a on-premise: ¿cuál puede automatizar?
• Primeros bots que conectar: Importe en Odoo los pedidos del correo · Asocie automáticamente los pagos bancarios a las facturas
• Para integradores: Genere ingresos recurrentes como partner de Odoo

🔗 Fuentes y lecturas adicionales

Documentación oficial y estándares citados en esta guía. Los enlaces externos se abren en una pestaña nueva.

• Odoo 18 developer reference — External API and API keys
• BOTS4.me Connect on the Odoo Apps Store
• Odoo 18 documentation — Access rights
• Odoo — Supported versions