> ## Documentation Index > Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt > Use this file to discover all available pages before exploring further. # Odoo > Cómo conectar tu ERP Odoo a un agente de ChatNorris para sincronizar leads con el CRM, consultar pedidos verificados, responder precio y stock en vivo, armar la compra con links de tu tienda y crear y consultar tickets del Helpdesk. # Odoo Con la integración de Odoo, tu agente de ChatNorris trabaja con los datos reales de tu ERP **Odoo** (self-hosted, Odoo.sh u Online). Según lo que actives y los módulos que tenga tu instancia, el agente: * crea un contacto y una oportunidad en tu CRM de Odoo por cada lead nuevo que confirma; * informa el estado de un pedido de venta, solo después de verificar que es del visitante; * busca productos y variantes y responde el precio de venta y el stock del momento; * arma con el visitante una lista de compra y le manda el link de cada producto en tu tienda; * crea tickets en tu Helpdesk de Odoo, con confirmación del visitante, y consulta su estado de forma verificada. Funciona en el widget web, WhatsApp, Instagram, Messenger, Telegram, Email y la API. ## Requisitos * Una cuenta de ChatNorris con plan **Premium**. Odoo es exclusivo de Premium: en Free o Standard no aparece como conectable y la Acción aparece bloqueada como "Próximamente" en el selector. Puedes ver los planes en [chatnorris.ai/pricing](https://chatnorris.ai/pricing) o escribirnos a [**hola@chatnorris.ai**](mailto:hola@chatnorris.ai). * Al menos un agente creado en ChatNorris. Si todavía no tienes uno, sigue [Crear un agente](https://docs.chatnorris.ai/guias/crear-agente-wizard.md). * Una instancia de Odoo (self-hosted, Odoo.sh u Online), un usuario de Odoo y una API key de ese usuario. * Los módulos de Odoo que necesite cada capacidad (ver [Configurar la Acción](#configurar-la-acción)). * Rol **Owner** o **Admin** en tu organización de ChatNorris. > [!TIP] > > Si tu Odoo no tiene API disponible (por ejemplo, Odoo Online en su plan Standard), todavía puedes importar los productos y precios desde el sitio público de tu tienda con la fuente [Tienda online (sitio público)](https://docs.chatnorris.ai/guias/knowledge-base.md#tienda-online-sitio-público), sin conectar ninguna API. ## Conectar Odoo Cada agente se conecta a una instancia de Odoo. La conexión se hace una sola vez en **Integraciones** y la usa la Acción Odoo. **1. Genera una API key en Odoo** En Odoo, con el usuario que va a usar ChatNorris, abre **Preferencias → Seguridad de la cuenta → Nueva clave API** y copia la clave. **2. Abre el hub de Integraciones del agente** En ChatNorris, entra a `Agentes → [tu agente] → Integraciones` y elige **Odoo**. **3. Completa los datos y conecta** Ingresa la **URL de la instancia** (por ejemplo `https://tu-empresa.odoo.com`), la **Base de datos** (opcional: se autodetecta si tu servidor solo tiene una), el **Usuario** y la **API key**, y haz clic en **Conectar**. **4. Prueba la conexión** Usa **Probar conexión** para confirmar que las credenciales funcionan. En el detalle de la integración, **Detectado en la última conexión/prueba** muestra la edición (Enterprise o Community), la versión y los módulos relevantes instalados en tu Odoo. La API key se guarda cifrada: en el hub solo se ven sus últimos 4 caracteres. Si la rotas en Odoo, usa **Reemplazar clave** en el menú **···** de la fila; la conexión sigue siendo la misma, así que la Acción no se toca. > [!TIP] > > Si instalas un módulo en Odoo después de conectar, vuelve a hacer clic en **Probar conexión** para que ChatNorris lo detecte y habilite la capacidad que lo necesita. ## Configurar la Acción Conectar Odoo no activa nada todavía. Para elegir qué hace el agente: **1. Crea la Acción Odoo** Entra a `Agentes → [tu agente] → Acciones`, haz clic en **Nueva acción** y elige **Odoo**. **2. Activa las capacidades disponibles** Las capacidades que puedes habilitar dependen de qué módulos de Odoo tiene instalados tu instancia (detectado automáticamente al conectar). Ver la tabla de abajo. **3. Habilita la Acción y guarda** Activa **Acción habilitada**: mientras esté desactivada, ninguna capacidad tiene efecto. Guarda los cambios. | Capacidad | Qué hace | Requiere en Odoo | | - | - | - | | **Sincronizar leads con Odoo CRM** | Cada vez que un visitante confirma sus datos de contacto por primera vez, se crea automáticamente un contacto y una oportunidad en tu CRM de Odoo. | Módulo CRM | | **Consultar estado de pedido** | El visitante consulta el estado de un pedido de venta dando el número de pedido y su email o teléfono de la compra. En el widget web lo hace con el mismo formulario embebido que WooCommerce. | Módulo de Ventas | | **Consultar stock y precio** | El agente busca productos y variantes en tu Odoo y responde con el precio de venta y el stock del momento, nunca con datos de la base de conocimiento. | Módulo de Ventas (`sale`) | | **Armar compra** | El agente arma con el visitante una lista de productos de tu tienda y, cuando quiere comprar, le manda el link de cada producto. No crea pedidos ni cobra: el total final, el envío y el pago los hace tu tienda. Requiere activar primero **Consultar stock y precio**. | Módulo de tienda online (`website_sale`) | | **Crear ticket de soporte** | El agente puede crear un ticket de soporte en tu Helpdesk de Odoo, solo después de que el visitante confirme explícitamente. | Módulo Helpdesk (Enterprise o la versión de la comunidad, `helpdesk_mgmt`) | | **Consultar estado de ticket** | El agente puede informar el estado de un ticket ya creado por él mismo, después de verificar la identidad del solicitante. | Módulo Helpdesk | Si tu instancia no tiene el módulo correspondiente instalado, esa capacidad aparece deshabilitada. > [!WARNING] > > **Se recomienda Claude Sonnet o superior** como modelo principal del agente (**Configuración → IA**) si activas la consulta de pedidos o los tickets. Estas capacidades piden confirmación explícita antes de crear un ticket o revelar datos de un pedido o ticket verificado. En pruebas, Haiku a veces ignora la confirmación y responde como si el ticket ya se hubiera creado. El formulario de la acción muestra este aviso con un enlace a la configuración de IA. > [!NOTE] > > **Una sola tienda por agente.** Un agente puede tener una sola tienda activa para consultar pedidos y stock (por ejemplo Odoo o [WooCommerce](https://docs.chatnorris.ai/guias/woocommerce.md)). Si intentas habilitar una segunda, ChatNorris te pide apagar primero la consulta de pedidos y de stock de la otra. Odoo puede seguir activo para leads y tickets junto a una tienda WooCommerce. ### Sincronizar leads con Odoo CRM Cuando el agente confirma un lead nuevo en la conversación, se crea también un contacto y una oportunidad en tu CRM de Odoo (`crm.lead`). Es automático: no depende de lo que diga el visitante. > [!NOTE] > > La sincronización de leads ocurre una sola vez, en el momento en que el visitante confirma sus datos por primera vez — si más adelante completa datos adicionales (por ejemplo, agrega el teléfono), esos datos no se vuelven a sincronizar automáticamente. ### Consultar estado de pedido El visitante consulta el estado de un pedido de venta dando el número de pedido y el email o el teléfono que usó en la compra. El agente responde con el estado del pedido, el total y los productos. En el **widget web**, cuando el agente detecta que el visitante quiere el estado de un pedido, le muestra un **formulario embebido** dentro del chat con dos campos — **Número de orden** y **Email o teléfono de la compra**. El formulario y la respuesta se muestran en el idioma del widget (español, inglés o portugués), y es el mismo para WooCommerce y Odoo. Mientras el formulario está pendiente, el visitante no puede escribir otro mensaje hasta completarlo o cancelarlo. En **WhatsApp** e **Instagram** (donde no hay formularios embebidos), el agente pide estos mismos datos de forma conversacional. Para proteger los datos de tus clientes: * si los datos no coinciden, el agente indica que no pudo verificar el pedido y pide revisar el número y el dato de contacto — nunca muestra información sin verificar; * un pedido que no existe y un dato que no coincide reciben la misma respuesta, para que nadie pueda adivinar números de pedido; * tras 5 intentos fallidos en la misma conversación, la consulta de pedidos se bloquea. ### Consultar stock y precio El agente busca productos y variantes en tu Odoo y responde con el precio de venta y el stock del momento. Consulta Odoo cada vez que va a hablar del precio o el stock de un producto, aunque ya lo haya consultado antes en la conversación: nunca responde con datos de la base de conocimiento. Si el visitante pide una recomendación sin nombrar un producto ("¿qué me recomiendas para 5 personas?"), el agente consulta el catálogo en vivo y le propone una o dos opciones concretas con su precio, evitando las que están agotadas. Con esta capacidad activa, la lista de fuentes de **Conocimiento** muestra además la fila informativa **Catálogo de Odoo en vivo**, con la etiqueta **En vivo** y el link **Ver acción**. No es una fuente: indica que el agente consulta precio y stock directo en tu Odoo en cada conversación, así que no ocupa caracteres ni necesita sincronizarse. ### Armar compra Con **Armar compra** activo, cuando el visitante quiere comprar recibe un bloque 🛒 con cada línea (cantidad × producto = monto), un 🔗 link a la página de cada producto en tu tienda y un **Total ≈** de referencia, sin envío. Antes de enviarlo, el agente revisa la lista: quita los productos que ya no se venden, actualiza los precios y avisa los que están sin stock. Si un producto no tiene página en tu tienda, el agente le indica al visitante que lo busque por su nombre. ChatNorris no crea pedidos ni cobra: el total final, el envío y el pago los hace tu tienda. Los cambios del carrito quedan registrados como [notas internas](https://docs.chatnorris.ai/guias/conversaciones.md#notas-internas-del-carrito) en la conversación. > [!NOTE] > > Un agente usa una tienda por API o por sitio público, no las dos. Si ya tiene la Acción Odoo con consulta de pedidos, stock o compra activa, el panel de la fuente [Tienda online (sitio público)](https://docs.chatnorris.ai/guias/knowledge-base.md#tienda-online-sitio-público) te avisa y te lleva a **Acciones**. ### Crear ticket de soporte El visitante puede pedir ayuda y, tras confirmar, se crea un ticket en el Helpdesk de Odoo (el oficial de Enterprise o el de la comunidad OCA, según lo que tenga instalado tu instancia). Antes de crearlo, el agente reúne el asunto, la descripción, el nombre y el email del visitante, le muestra un resumen y espera un "sí" explícito. * **Equipo de destino:** elige a qué equipo del Helpdesk se asignan los tickets nuevos. Con **Automático (primer equipo disponible)** se usa el primer equipo que devuelva tu Odoo. * **Cuándo crear un ticket:** instrucciones para el agente sobre cuándo ofrecer soporte vía ticket. Viene con un texto por defecto que puedes editar; **Restaurar texto por defecto** lo recupera. Las acciones de tickets (Odoo, Zendesk y Freshdesk) siguen una regla fija, por encima de lo que escribas en **Cuándo crear un ticket**: * Si el visitante describe un problema o hace una pregunta **sin pedir un ticket**, el agente responde con la base de conocimiento. Si no logra resolverlo, o el visitante dice que la respuesta no le sirvió, ofrece crear el ticket. * Si el visitante **pide un ticket directamente**, el agente primero le ofrece ayuda (con la respuesta, si la tiene, o preguntando qué le pasa) y le pregunta si igual prefiere el ticket. * El ticket se inicia si el visitante insiste, si el agente ya intentó y no tenía la información, o si la respuesta no le sirvió. Durante un flujo de ticket, el agente no ofrece el Lead Form ni transferir a una persona, para no confundir al visitante. Y si el visitante pide abrir un ticket o un caso de soporte, el agente usa esta acción en vez de transferir a una persona con [Human Handoff](https://docs.chatnorris.ai/guias/chat-en-vivo-handoff.md). > [!WARNING] > > Los tickets se crean de verdad en tu Odoo, también desde el Playground. Si el agente tiene esta capacidad activa, antes del primer mensaje del Playground verás el aviso **Esta prueba puede crear datos reales** con **Continuar** y **Cancelar**. ### Consultar estado de ticket El visitante puede consultar el estado de un ticket ya creado por este agente, dando el número de ticket y el email que usó al crearlo. El agente solo informa tickets que él mismo creó, no cualquier ticket de tu Helpdesk. Consultar el estado de un ticket existente no pasa por la regla de "primero resolver". ## Créditos Conectar y probar Odoo no consume créditos. Cada respuesta del agente que consulta tu Odoo en vivo (pedidos, o precio y stock) suma **0,5 crédito de IA** al costo normal de la respuesta, una sola vez por respuesta. Las pruebas en el Playground no suman este cargo. Ver [Modelos de IA y créditos](https://docs.chatnorris.ai/guias/modelos-ia-creditos.md). ## Pausar o desconectar * **Pausar:** apaga el interruptor **Activa** de la fila de Odoo en **Integraciones**. La API key se conserva, pero la Acción no puede llamar a tu Odoo hasta que la reactives. * **Desconectar:** desde el menú **···** o el detalle de Odoo, haz clic en **Desconectar**. La Acción Odoo se apaga, pero su configuración se conserva, y la API key se borra de ChatNorris. Para volver a usar la Acción, conecta Odoo de nuevo y reactívala. Lo que ya se creó en Odoo (contactos, oportunidades y tickets) se queda en tu instancia. Si ya no vas a usar la API key, bórrala en **Preferencias → Seguridad de la cuenta** de tu usuario de Odoo. > [!NOTE] > > Eliminar la Acción Odoo (botón **Eliminar acción**) deja de sincronizar leads, consultar pedidos y gestionar tickets con Odoo, y no se puede deshacer. ## Preguntas frecuentes > [accordion] ¿Por qué no veo Odoo como opción? > > Odoo es exclusivo del plan Premium — si tu organización está en Free o Standard, no va a aparecer como conectable ni como acción creable. Revisa los [planes](https://docs.chatnorris.ai/guias/modelos-ia-creditos.md) o escríbenos a [**hola@chatnorris.ai**](mailto:hola@chatnorris.ai). > [accordion] Una capacidad aparece deshabilitada > > Tu instancia no tiene instalado el módulo que esa capacidad necesita (ver la tabla de [Configurar la Acción](#configurar-la-acción)). Si acabas de instalarlo, vuelve a probar la conexión desde **Integraciones** para que ChatNorris lo detecte. **Armar compra**, además, necesita **Consultar stock y precio** activo. > [accordion] El visitante completó su teléfono después y no llegó a Odoo > > La sincronización de leads ocurre una sola vez, cuando el visitante confirma sus datos por primera vez. Los datos que agregue después no se vuelven a sincronizar automáticamente. > [accordion] ¿Puedo usar Odoo y WooCommerce en el mismo agente? > > Sí, pero solo una de las dos puede consultar pedidos y stock. Lo habitual es dejar en Odoo los leads y los tickets, y en WooCommerce la consulta de pedidos y stock. Ver [WooCommerce](https://docs.chatnorris.ai/guias/woocommerce.md). > [accordion] ¿Puedo conectar dos instancias de Odoo en el mismo agente? > > No. Cada proveedor admite una sola conexión por agente. Si necesitas conectar instancias distintas, usa agentes separados. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.