Saltar al contenido principal

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 o escribirnos a hola@chatnorris.ai.
  • Al menos un agente creado en ChatNorris. Si todavía no tienes uno, sigue Crear un agente.
  • 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).
  • Rol Owner o Admin en tu organización de ChatNorris.
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), 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.
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.
Si tu instancia no tiene el módulo correspondiente instalado, esa capacidad aparece deshabilitada.
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.
Una sola tienda por agente. Un agente puede tener una sola tienda activa para consultar pedidos y stock (por ejemplo Odoo o WooCommerce). 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.
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 en la conversación.
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) 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.
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.

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

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 o escríbenos a hola@chatnorris.ai.
Tu instancia no tiene instalado el módulo que esa capacidad necesita (ver la tabla de 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.
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.
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.
No. Cada proveedor admite una sola conexión por agente. Si necesitas conectar instancias distintas, usa agentes separados.