> For the complete documentation index, see [llms.txt](https://prometheo.gitbook.io/prometheo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prometheo.gitbook.io/prometheo/integraciones/odoo.md).
# Odoo
La integración entre Prometheo y Odoo permite conectar las conversaciones del asistente con la información comercial de tu empresa.
Con esta integración podés consultar productos almacenados en Odoo, crear leads automáticamente y relacionar la clasificación de contactos de Prometheo con las categorías utilizadas en Odoo.
### ¿Qué permite hacer la integración?
La integración con Odoo ofrece tres funciones principales:
#### Consultar productos de Odoo
Prometheo puede utilizar la información de los productos disponibles en Odoo para responder consultas dentro de una conversación.
El asistente puede acceder a datos como:
* Nombre del producto.
* Precio.
* Stock disponible.
* Descripción.
* Detalles adicionales.
* Variantes del producto.
* Enlace a la tienda.
Con esta información, el asistente puede:
* Responder preguntas sobre productos.
* Informar precios y disponibilidad.
* Recomendar productos según la necesidad del usuario.
* Compartir enlaces de compra.
* Brindar respuestas comerciales más completas.
* Acompañar al contacto durante el proceso de compra.
#### Crear leads en Odoo
Prometheo puede crear leads en Odoo utilizando la información recopilada durante una conversación.
Al crear un lead, se pueden enviar los siguientes datos:
* Nombre.
* Apellido.
* Teléfono.
* Correo electrónico.
* Tags.
* Resumen generado por inteligencia artificial.
También es posible asociar variables de Prometheo con campos personalizados de Odoo. Esto permite enviar información adicional obtenida durante la conversación.
Por ejemplo:
* Presupuesto estimado.
* Producto de interés.
* Ciudad.
* Tipo de cliente.
* Fecha preferida de contacto.
#### Asociar tags con categorías de Odoo
Los tags utilizados en Prometheo se pueden relacionar con categorías configuradas en Odoo.
Esto permite clasificar automáticamente los leads creados o actualizados.
Por ejemplo:
| Tag en Prometheo | Categoría en Odoo |
| -------------------- | --------------------- |
| Interesado | Lead caliente |
| Solicita información | Consulta comercial |
| Requiere seguimiento | Seguimiento pendiente |
| Cliente actual | Cliente existente |
### Antes de comenzar
Antes de configurar la integración, verificá que tengas acceso a:
* Una cuenta activa de Prometheo.
* Una instancia de Odoo disponible.
* Las credenciales o datos necesarios para conectar Odoo.
* Los permisos correspondientes dentro de Odoo.
* Los campos personalizados que quieras utilizar.
* Las variables de Prometheo que quieras enviar.
* Los tags de Prometheo que quieras relacionar con categorías de Odoo.
También es recomendable definir previamente qué funciones de la integración vas a utilizar:
* Consulta de productos.
* Creación de leads.
* Mapeo de variables.
* Asociación de tags y categorías.
### Configurar la integración con Odoo
#### 1. Definir el objetivo de la integración
Antes de conectar las plataformas, definí qué procesos querés implementar.
Por ejemplo:
* Permitir que el asistente consulte productos.
* Crear leads automáticamente.
* Enviar datos personalizados a Odoo.
* Clasificar los leads con categorías.
* Utilizar todas las funciones anteriores.
Tener este objetivo claro facilita la configuración posterior.
#### 2. Conectar Odoo con Prometheo
Ingresá a la sección de integraciones de Prometheo y seleccioná la integración con Odoo.
Completá los datos solicitados para establecer la conexión. Dependiendo de la configuración de tu instancia, la integración puede solicitar información como:
* Dirección de la instancia de Odoo.
* Base de datos.
* Usuario.
* Contraseña o credencial de acceso.
Una vez completados los datos, guardá la configuración y verificá que la conexión se haya realizado correctamente.
{% hint style="info" %}\
Las credenciales utilizadas deben pertenecer a un usuario con permisos suficientes para consultar productos y crear o modificar leads en Odoo.\
{% endhint %}
#### 3. Activar la consulta de productos
Dentro de la configuración de la integración, activá la opción correspondiente a la lectura o consulta de productos.
Una vez habilitada, Prometheo podrá utilizar la información disponible en Odoo para responder las consultas de los usuarios.
Antes de usar esta función, revisá que los productos tengan correctamente cargados los datos que querés mostrar, especialmente:
* Nombre.
* Precio.
* Stock.
* Descripción.
* Variantes.
* Enlace de compra.
La calidad de las respuestas del asistente dependerá de la información disponible en Odoo.
Dentro de la configuración de productos, se puede indicar si debe buscar productos sin Stock y también se puede establecer la cantidad máxima de productos a buscar
{% hint style="info" %}
A mayor cantidad de productos, será mayor el consumo de tokens.
{% endhint %}
También se puede setear el máximo de productos (links a la tienda) que puede enviar el asistente
#### 4. Activar la creación de leads
Activá la opción correspondiente a la creación de leads.
Esta configuración permite que la información recopilada en las conversaciones de Prometheo se envíe a Odoo.
Definí qué datos querés incluir en cada lead. Como configuración inicial, se recomienda enviar:
* Nombre.
* Apellido.
* Teléfono.
* Correo electrónico.
* Tags.
* Resumen de la conversación generado por IA.
El resumen de IA puede ayudar al equipo comercial a comprender rápidamente el motivo del contacto sin necesidad de leer la conversación completa.
### Mapear variables de Prometheo con campos de Odoo
El mapeo de variables permite enviar información adicional desde Prometheo hacia campos específicos de Odoo.
Para realizar el mapeo, la variable debe existir previamente en Prometheo y el campo de destino debe estar disponible en Odoo.
El orden de configuración es el siguiente:
1. Seleccioná la variable de Prometheo.
2. Seleccioná el campo correspondiente en Odoo.
3. Guardá la asociación.
#### Ejemplo de mapeo
Supongamos que el asistente consulta al usuario cuál es su presupuesto.
En Prometheo existe una variable llamada:
`presupuesto`
En Odoo existe un campo personalizado llamado:
`Presupuesto estimado`
La asociación se configuraría de la siguiente manera:
| Variable de Prometheo | Campo de Odoo |
| --------------------- | -------------------- |
| presupuesto | Presupuesto estimado |
Cuando Prometheo cree el lead, el valor almacenado en la variable se enviará al campo correspondiente de Odoo dentro de Contactos en las Categorías de Odoo, como en los Stages (u Oportunidades).
#### Recomendaciones para el mapeo
Antes de crear las asociaciones:
* Verificá que la variable exista en Prometheo.
* Verificá que el campo exista en Odoo.
* Confirmá que ambos campos utilicen un tipo de dato compatible.
* Utilizá nombres descriptivos para identificar fácilmente cada variable.
* Probá el envío con una conversación de prueba.
### Asociar tags de Prometheo con categorías y stages de Odoo
También podés asociar los tags utilizados en Prometheo con las categorías y stages disponibles en Odoo.
El orden de configuración es:
1. Seleccioná el tag de Prometheo.
2. Elegí la categoría correspondiente de Odoo.
3. Elegí el stage (u oportunidad dependiendo la versión de Odoo)
4. Guardá la asociación.
#### Ejemplo
| Tag de Prometheo | Categoría de Odoo |
| ---------------- | ----------------- |
| interesado | Lead caliente |
Cuando una conversación tenga asignado el tag `interesado`, el lead podrá crearse o actualizarse con la categoría `Lead caliente` en Odoo.
Esta configuración facilita la segmentación y priorización de oportunidades comerciales.
### Configurar el asistente para utilizar productos de Odoo
Además de activar la integración, es recomendable indicar explícitamente en las instrucciones del asistente que debe utilizar la información de productos disponible en Odoo.
Podés agregar una instrucción como la siguiente dentro del prompt:
> Usá la información de productos disponible en Odoo para responder consultas sobre nombre, precio, stock, descripción, detalles, variantes y enlace de compra. Recomendá productos únicamente cuando sean relevantes para la necesidad del usuario.
También podés agregar reglas más específicas:
> Cuando el usuario consulte por un producto, verificá la información disponible en Odoo antes de responder. No inventes precios, stock, características ni enlaces.
> Cuando existan varios productos compatibles con la consulta, presentá las opciones más relevantes y explicá brevemente sus diferencias.
> Cuando un producto no tenga stock disponible, informalo claramente y ofrecé otras alternativas disponibles.
Estas instrucciones ayudan a que el asistente utilice correctamente la integración y evite responder con información no verificada.
### Información que conviene preparar
#### Para la consulta de productos
Definí previamente:
* Si el asistente debe informar el stock.
* Si debe mencionar los precios.
* Si debe compartir enlaces de compra.
* Si puede recomendar productos.
* Qué información debe priorizar en las respuestas.
* Qué debe hacer cuando no encuentre un producto.
* Qué debe hacer cuando un producto no tenga stock.
#### Para la creación de leads
Definí:
* En qué momento debe crearse el lead.
* Qué datos mínimos debe tener el contacto.
* Qué variables querés guardar en Odoo.
* Qué tags deben enviarse.
* Qué categoría debe recibir cada tipo de lead.
* Qué campos personalizados necesitás crear en Odoo.
* Qué información debe incluir el resumen de IA.
### Flujo de funcionamiento recomendado
Un flujo habitual puede funcionar de la siguiente manera:
1. Un usuario inicia una conversación.
2. El asistente identifica su necesidad.
3. Prometheo consulta los productos disponibles en Odoo.
4. El asistente responde con información comercial relevante.
5. Durante la conversación, Prometheo recopila los datos del contacto.
6. Se almacenan las respuestas en variables.
7. Se asignan los tags correspondientes.
8. Prometheo crea el lead en Odoo.
9. Las variables se envían a los campos configurados.
10. Los tags se convierten en categorías de Odoo.
11. El equipo comercial continúa el seguimiento desde Odoo.
### Probar la integración
Después de completar la configuración, realizá una prueba completa.
#### Prueba de productos
Iniciá una conversación de prueba y consultá:
* El precio de un producto.
* La disponibilidad de stock.
* Las características principales.
* Las variantes disponibles.
* El enlace de compra.
* Una recomendación según una necesidad específica.
Verificá que las respuestas coincidan con la información cargada en Odoo.
#### Prueba de creación de leads
Durante una conversación de prueba:
1. Ingresá un nombre.
2. Ingresá un apellido.
3. Ingresá un teléfono.
4. Ingresá un correo electrónico.
5. Completá alguna variable personalizada.
6. Asigná uno de los tags configurados.
7. Finalizá el flujo que crea el lead.
Luego ingresá a Odoo y comprobá que:
* El lead se haya creado.
* Los datos personales sean correctos.
* Las variables estén en los campos correspondientes.
* Los tags se hayan asociado con las categorías correctas.
* El resumen de IA esté disponible.
{% hint style="info" %}
Realizá las primeras pruebas con contactos de prueba para evitar crear información incorrecta dentro de la base comercial.
{% endhint %}
### Buenas prácticas
* Mantené actualizada la información de los productos en Odoo.
* Evitá utilizar variables duplicadas para el mismo dato.
* Utilizá nombres claros para variables, tags y campos personalizados.
* Revisá periódicamente las asociaciones entre Prometheo y Odoo.
* Indicá en el prompt que el asistente no debe inventar información.
* Definí qué datos son obligatorios antes de crear un lead.
* Probá la integración después de modificar campos o categorías en Odoo.
* Limitá los permisos del usuario de integración a las funciones necesarias.
### Resolución de problemas frecuentes
#### El asistente no encuentra un producto
Revisá que:
* El producto exista en Odoo.
* El producto esté disponible para la integración.
* La información esté correctamente cargada.
* La consulta de productos esté activada.
* El asistente tenga instrucciones para utilizar la información de Odoo.
#### El lead no se crea
Verificá que:
* La conexión con Odoo esté activa.
* La creación de leads esté habilitada.
* El usuario de integración tenga permisos.
* Los datos obligatorios estén completos.
* Los campos asociados sigan existiendo en Odoo.
#### Una variable no aparece para mapear
Confirmá que:
* La variable haya sido creada previamente en Prometheo.
* La variable esté guardada correctamente.
* El campo de destino exista en Odoo.
* El tipo de información sea compatible con el campo de destino.
#### El lead se crea sin categoría
Revisá que:
* El tag se haya asignado a la conversación.
* El tag esté asociado con una categoría de Odoo.
* La categoría siga disponible en Odoo.
* La asociación se haya guardado correctamente.
***
## Anexo
## Cómo obtener el dominio y la API key de Odoo
Para conectar Odoo con Prometheo vas a necesitar:
* El dominio o URL de tu cuenta de Odoo.
* Una API key de Odoo.
* El correo del usuario que generó esa API key.
### Antes de comenzar
Si utilizás **Odoo Online**, el acceso a la API externa está disponible únicamente en el plan **Custom**. No está incluido en los planes One App Free ni Standard.
Podés consultar la documentación oficial de la API de Odoo acá:
***
### 1. Obtener el dominio de Odoo
1. Ingresá normalmente a tu cuenta de Odoo.
2. Mirá la dirección que aparece en la barra del navegador.
3. Copiá solamente la parte inicial de la URL.
Por ejemplo, si la dirección completa es:
```
https://miempresa.odoo.com/odoo/crm
```
El dominio que tenés que copiar es:
```
https://miempresa.odoo.com
```
No incluyas lo que aparece después del dominio, como:
```
/odoo
/web
/crm
/shop
```
Tampoco agregues una barra `/` al final.
Odoo define la URL del servidor como el dominio de la instancia. Por ejemplo, `https://mycompany.odoo.com`.
#### Si usás Odoo.sh
Ingresá al proyecto de Odoo.sh, abrí la rama de producción y presioná **Connect**. Después copiá la dirección principal que aparece en el navegador.
#### Si Odoo está instalado en un servidor propio
El dominio puede tener un formato similar a:
```
https://odoo.miempresa.com
```
En este caso, solicitale la URL al administrador o proveedor que instaló Odoo.
***
### 2. Activar el modo desarrollador
En algunas versiones de Odoo es necesario activar el modo desarrollador para visualizar la opción de generar la API key.
1. Ingresá a **Ajustes**.
2. Bajá hasta la sección **Herramientas de desarrollador**.
3. Presioná **Activar modo desarrollador**.
También podés agregar `?debug=1` al final de la URL de Odoo.
Por ejemplo:
```
https://miempresa.odoo.com/odoo?debug=1
```
Documentación oficial:
***
### 3. Generar la API key
La API key debe ser generada por el usuario que se conectará con Prometheo.
1. Ingresá a Odoo con ese usuario.
2. Hacé clic en el nombre o avatar ubicado arriba a la derecha.
3. Entrá en **Mi perfil** o **Preferencias**.
4. Abrí la pestaña **Seguridad de la cuenta**.
5. Buscá la sección **Claves API**.
6. Presioná **Nueva clave API**.
7. Si Odoo lo solicita, ingresá la contraseña del usuario.
8. Escribí una descripción, por ejemplo:
```
Integración Prometheo
```
9. Presioná **Generar clave**.
10. Copiá la clave inmediatamente y guardala en un lugar seguro.
El recorrido indicado por la documentación oficial es:
```
Preferencias → Seguridad de la cuenta → Nueva clave API
```
La clave se muestra una sola vez. Si cerrás la ventana sin copiarla, no se puede recuperar y vas a tener que generar una nueva.
Documentación oficial:
#### Importante para Odoo 19
En Odoo 19 también puede solicitarse una duración para la clave. Las claves pueden tener una vigencia máxima de tres meses, por lo que deberán renovarse antes de su vencimiento.
Documentación para Odoo 19:
***
### 4. Completar la integración en Prometheo
En la configuración de la integración ingresá:
**Dominio de Odoo**
```
https://miempresa.odoo.com
```
**Usuario**
```
integraciones@miempresa.com
```
**API key**
```
La clave generada en Odoo
```
La API key está asociada al usuario que la generó. Por este motivo, la integración solamente podrá consultar o modificar la información para la cual ese usuario tenga permisos.
***
### Recomendaciones
Lo ideal es crear un usuario exclusivo para la integración, por ejemplo:
```
Integración Prometheo
```
A ese usuario se le deben otorgar permisos para acceder a la información que Prometheo necesite utilizar, como:
* Productos.
* Inventario.
* CRM y oportunidades.
* Contactos.
No es recomendable generar la API key desde la cuenta personal del administrador.
Odoo recomienda utilizar usuarios dedicados para las integraciones automáticas y asignarles solamente los permisos necesarios.
***
### Si no aparece la opción “Nueva clave API”
Revisá lo siguiente:
1. Que el modo desarrollador esté activado.
2. Que estés ingresando con un usuario interno y no con un usuario de portal.
3. Que el usuario tenga permisos suficientes.
4. Que la versión de Odoo sea 14 o superior.
5. Si utilizás Odoo Online, que tengas contratado el plan Custom.
6. Probá cerrar sesión, volver a ingresar y repetir el procedimiento.
Si el problema continúa, consultá con el administrador de la cuenta o con el soporte de Odoo.
### Resultado final
Una vez configurada la integración, vas a poder:
* Consultar productos de Odoo desde el asistente.
* Responder preguntas comerciales con información actualizada.
* Informar precios y stock.
* Recomendar productos.
* Compartir enlaces de compra.
* Crear leads automáticamente en Odoo.
* Enviar datos recopilados durante la conversación.
* Completar campos personalizados.
* Relacionar tags de Prometheo con categorías de Odoo.
* Incorporar un resumen de IA para facilitar el seguimiento comercial.
De esta manera, Prometheo puede encargarse de la atención inicial y la recopilación de información, mientras que Odoo centraliza los productos, los leads y el seguimiento del proceso comercial.