Odoo Webhook

Odoo Webhook es un componente de inicio: pone en marcha el flujo cuando en tu Odoo se crea o se modifica un registro del tipo que elijas, por ejemplo un pedido de venta, una factura o un contacto. No hace falta configurar nada en Odoo: una vez suscrito, NappAI revisa tu Odoo aproximadamente cada minuto y ejecuta el flujo con los registros nuevos o cambiados desde la última revisión.

Cuándo usarlo

• Cada pedido de venta nuevo debe avisar al almacén por mensaje.
• Cuando se publica una factura quieres enviarla a otro sistema o guardar sus datos en una hoja de cálculo.
• Un contacto cambia sus datos en Odoo y quieres actualizarlo también en tu herramienta de marketing.
• Quieres que un agente de IA revise cada oportunidad nueva del CRM y prepare un primer mensaje.

Configuración

Necesitas una credencial Odoo API con la dirección de tu servidor de Odoo, el nombre de la base de datos, tu usuario y una clave de API de Odoo. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Odoo API de tu Odoo.
Odoo Model	El tipo de registro que se vigila: sale.order (pedidos de venta), account.move (facturas y asientos), stock.picking (albaranes), account.payment (pagos), product.product (productos), res.partner (contactos), crm.lead (oportunidades) o note.note (notas; desde Odoo 17, las tareas de la app To-do). Por defecto, sale.order.
Events	Qué cambios ponen en marcha el flujo: Record Created (registro creado), Record Updated (registro modificado) o los dos. Por defecto, los dos.
Data	Sirve para probar el componente: pega aquí un ejemplo de lo que llega y ejecuta el flujo para ver el resultado.

Opciones avanzadas

Campo	Qué hace
Additional Domain Filter	Una condición extra, escrita como la escribe Odoo, para vigilar solo algunos registros. Por ejemplo, [["state", "=", "sale"]] vigila solo los pedidos confirmados. Déjalo vacío para vigilar todos.

Activar la suscripción

1. Despliega una versión del flujo. La suscripción necesita una versión desplegada. Ver Versiones y publicación.
2. En el componente, debajo de sus campos, pulsa Suscribirse. Se abre la ventana Acceso a API en la pestaña Odoo Webhook.
3. Pulsa Suscribirse. La pestaña muestra si la suscripción está Sincronizado con lo que tiene configurado el componente, el modelo y los eventos suscritos y cada cuántos segundos se revisa Odoo.
4. Si cambias el modelo o los eventos del componente, la pestaña lo marca como Desincronizado: vuelve a suscribirte. Para dejar de recibir cambios, pulsa Cancelar suscripción.

Resultado

La salida Data devuelve un elemento por cada registro creado o modificado, con:

• event: created si el registro es nuevo o updated si se ha modificado.
• model: el tipo de registro, por ejemplo sale.order.
• id y name: el identificador y el nombre del registro.
• write_date: la fecha y hora de la última modificación.
• record: todos los datos del registro tal como los guarda Odoo.

Conecta Data a un agente, a un componente de mensajería o al componente Odoo para seguir trabajando con el registro.

Ejemplo

Una distribuidora quiere avisar al almacén cada vez que entra un pedido de venta.

1. Añade Odoo Webhook con la credencial de tu Odoo, Odoo Model en sale.order y Events solo con Record Created.
2. Conecta Data a un agente que redacte un aviso con el cliente y el importe del pedido, y este a un componente de mensajería.
3. Despliega el flujo y suscríbete desde el componente.

Buenas prácticas

• La primera revisión tras suscribirte recoge también los registros modificados en las últimas 24 horas. Tenlo en cuenta si el flujo envía avisos.
• En cada revisión se recogen como máximo 100 registros; el resto llega en las siguientes.
• Un registro cuenta como creado cuando su última modificación es de menos de un minuto después de crearse. Si alguien lo edita justo después de crearlo, puede llegar como creado.
• Usa Additional Domain Filter para no ejecutar el flujo con registros que no te interesan.

Componentes relacionados

• Odoo: crea, consulta y confirma registros de Odoo.