Reglas de automatización¶
Las reglas de automatización permiten la ejecución de una o más acciones predefinidas en respuesta a un disparador específico, por ejemplo, crear una actividad cuando un campo se establece en un valor específico, o archivar un registro 7 días después de su última actualización.
Al crear una regla de automatización, es posible añadir condiciones que deben cumplirse para que la regla de automatización se ejecute, por ejemplo, la oportunidad debe estar asignada a un vendedor específico, o el estado del registro no debe ser Draft.
Para crear una regla de automatización con Odoo Studio:
Abra Studio, haga clic en Automatizaciones y después en Nuevo.
Dale a la regla de automatización un nombre claro y significativo que identifique su propósito.
Selecciona el Trigger y, si es necesario, completa los campos que aparecen en la pantalla según el disparador elegido.
Haz clic en Añadir una acción en la pestaña Acciones por hacer.
Selecciona el Tipo de acción y completa los campos relevantes según la acción elegida.
Haz clic en Save & Close o, para definir acciones adicionales, Save & New.
Example
Para garantizar el seguimiento de clientes menos satisfechos, esta regla de automatización crea una actividad 3 meses después de que se crea un pedido de venta para clientes con un porcentaje de satisfacción inferior al 30%.
Truco
Usa la pestaña Notes para documentar el propósito y funcionamiento de las reglas de automatización. Esto hace que las reglas sean más fáciles de mantener y facilita la colaboración entre usuarios.
Para modificar el modelo objetivo de la regla de automatización, cambia de modelo antes de hacer clic en Automations en Studio, o activa el modo de desarrollador, crea o edita una regla de automatización, y selecciona el Model en el formulario Automation Rules.
Las reglas de automatización pueden crearse desde cualquier etapa kanban haciendo clic en el icono Ajustes que aparece al pasar el ratón sobre el nombre de la etapa kanban, luego seleccionando Automatizaciones. En este caso, el Disparador está configurado como La etapa se establece en por defecto, pero se puede cambiar si es necesario.
Activador¶
El Disparador se utiliza para definir qué tipo de evento debe ocurrir para que se ejecute la regla de automatización. Los disparadores disponibles dependen del modelo. Hay cinco categorías de disparadores disponibles en total:
Añadir condiciones¶
Los filtros de dominio permiten determinar los registros a los que debe dirigirse o excluir una regla de automatización. Un filtrado eficiente mejora el rendimiento general, ya que evita el procesamiento innecesario de registros que no se ven afectados por la regla.
Truco
Activa el modo de desarrollador antes de crear una regla de automatización para tener la máxima flexibilidad al añadir filtros de dominio.
Dependiendo del disparador elegido, es posible definir una o más condiciones que un registro debe cumplir antes y/o después de que ocurra un disparador.
El Dominio antes de actualizar define las condiciones que un registro debe cumplir antes de que ocurra el evento disparador, por ejemplo, el registro debe tener
Tipo = Factura de clienteyEstado = Contabilizado.Con el modo de desarrollador activado, haz clic en Editar dominio, si está disponible, luego en Nueva regla.
El dominio Aplicar en define las condiciones que un registro debe cumplir después de que ocurra el evento disparador, por ejemplo, la factura del cliente debe tener
Estado de pago = Parcialmente pagado.Con el modo de desarrollador activado, haz clic en Editar dominio y luego en Nueva regla.
Truco
Si el modo de desarrollador no está activado, para definir un dominio Aplicar en, haz clic en Añadir condición. Completa o elimina la condición sugerida. Para añadir una condición, haz clic en Nueva regla.
Cuando ocurre un disparador, por ejemplo, se actualiza el estado de pago de una factura de cliente contabilizada, la regla de automatización verifica las condiciones definidas y solo ejecuta la acción si el registro cumple esas condiciones.
Example
Si la acción automatizada debe ejecutarse cuando se establece una dirección de correo electrónico por primera vez (en contraste con modificar una dirección de correo electrónico) en un contacto existente que es un individuo en lugar de una empresa, utiliza El correo electrónico no está establecido e Es una empresa no está establecido como el Dominio antes de actualizar y El correo electrónico está establecido como el dominio Aplicar en.
Nota
El Dominio antes de actualizar no se verifica al crear un registro.
Valores actualizados¶
Dispara acciones automatizadas cuando ocurren cambios específicos en la base de datos. Los disparadores disponibles en esta categoría dependen del modelo y se basan en cambios comunes, como añadir una etiqueta específica (por ejemplo, a una tarea) o establecer el valor de un campo (por ejemplo, establecer el campo Usuario).
Selecciona el activador y luego selecciona un valor si es necesario.
Eventos de correo electrónico¶
Activación de acciones automatizadas al enviar o recibir correos electrónicos.
Condiciones de tiempo¶
Activa acciones automáticas en un momento específico relativo a un campo de fecha o a la creación o actualización de un registro. Los siguientes activadores están disponibles:
Basada en campo de fecha: La acción se activa un período de tiempo definido antes o después de la fecha del campo de fecha seleccionado, por ejemplo, 30 días antes de la fecha de finalización del contrato.
Después de crear: La acción se activa un período de tiempo definido después de que se crea y guarda un registro.
Después de la última actualización: La acción se activa un período de tiempo definido después de que se edita y guarda un registro existente.
Para configurar un activador de Condiciones de tiempo, con el modo de desarrollador activado:
Selecciona el Activador apropiado de la categoría Condiciones de tiempo. Si seleccionas el activador Basada en campo de fecha, selecciona el campo de fecha relevante.
Configura el Retraso para determinar la fecha y hora de ejecución de la acción o acciones. Para ello, ingresa el número de Minutos, Horas, Días o Meses después de los cuales debe activarse la acción. Si seleccionaste el activador Basada en campo de fecha, la acción puede activarse Después o Antes del campo de fecha seleccionado.
Opcionalmente, añade condiciones que el registro debe cumplir antes y/o después de que se active la regla.
Haz clic en Guardar manualmente.
Haz clic en Acción programada para abrir la acción programada Reglas de automatización: verificar y ejecutar.
Nota
Esta acción programada verifica las fechas y horas de ejecución que se hayan alcanzado desde su última ejecución y ejecuta las acciones relacionadas, si corresponde. Por defecto, la acción programada está configurada para Ejecutar cada 4 horas, lo cual es generalmente suficiente para retrasos como 3 meses después de la fecha del pedido o 7 días después de la última actualización.
Si alguna regla de automatización tiene un activador basado en tiempo con un retraso menor al equivalente de 40 horas, por ejemplo, 3 horas antes de la fecha y hora de inicio del evento, la frecuencia de la acción programada se aumenta automáticamente, por ejemplo, a Ejecutar cada 18 minutos. Esto permite que la acción se ejecute más cerca de su fecha y hora de ejecución programada.
Haz clic en Ejecutar manualmente en la parte superior izquierda.
Advertencia
Este paso es crucial para evitar que la regla se ejecute retroactivamente en registros históricos. Ejecutar la acción programada manualmente inicializa la marca de tiempo de su última ejecución en la regla de automatización, que es un elemento clave de la lógica de ejecución de la regla.
Haz clic en el nombre de la regla de automatización en las migas de pan para volver a la configuración de la regla de automatización.
Añade las acciones a ejecutar y luego, cuando todas las acciones hayan sido definidas, haz clic en Guardar manualmente.
La acción se ejecuta la primera vez que la acción programada Reglas de automatización: verificar y ejecutar se ejecuta después de que se alcanza la fecha y hora de ejecución, y cuando se cumplen las condiciones.
Lógica de ejecución¶
Cuando se usa un disparador basado en tiempo, una acción solo se ejecuta cuando la fecha y hora de ejecución cae entre la última ejecución de la acción programada y la ejecución actual (ya sea programada o ejecutada manualmente), es decir:
última ejecución –> fecha y hora de ejecución –> ejecución actual
Nota
Ejecutar manualmente la acción programada Reglas de automatización: verificar y ejecutar no necesariamente resulta en que se ejecute la acción de una regla. Al probar una regla de automatización con un disparador basado en tiempo, asegúrate de que esta secuencia sea verdadera, luego verifica si la acción se ha ejecutado.
Example
La mañana del 15 de octubre, creas una regla de automatización que activa el envío de un correo electrónico 30 días antes de la Fecha de finalización del contrato; los contratos finalizan a las 11:59 pm en su fecha de finalización. Durante la creación de la regla, la acción programada Reglas de automatización: verificar y ejecutar se ejecutó manualmente a las 11:00 am y está configurada para ejecutarse cada cuatro horas a partir de entonces.
Esta nueva regla de automatización se aplicará para contratos cuya fecha de finalización sea al menos 30 días después de la creación de la regla, es decir, una fecha de finalización del 14 de noviembre o posterior.
Para un contrato con fecha de finalización del 14 de noviembre, la fecha y hora de ejecución de la acción es las 11:59 pm del 15 de octubre. Por lo tanto, la acción se ejecutará la primera vez que la acción programada Reglas de automatización: verificar y ejecutar se ejecute después de que haya pasado esa fecha y hora, es decir:
última ejecución de la acción programada: 11:00 pm del 15 de octubre
fecha y hora de ejecución: 11:59 pm del 15 de octubre
ejecución actual de la acción programada: 3:00 am del 16 de octubre
Personalizado¶
Activar acciones automatizadas:
Al crear: cuando se guarda un registro por primera vez.
Al crear y editar: cuando se guarda un registro por primera vez y en cualquier momento posterior.
Al eliminar: cuando se elimina un registro.
Al cambiar en la interfaz: cuando se cambia el valor de un campo en la vista de formulario, incluso antes de que se guarde el registro.
Para los activadores Al crear y editar y Al cambiar en la interfaz, debes seleccionar el o los campos que se utilizarán para activar la regla de automatización en el campo Al actualizar.
Advertencia
Si no se selecciona ningún campo en el campo Al actualizar, es posible que la acción automatizada se ejecute varias veces por registro.
También tiene la opción de definir condiciones adicionales que se deben cumplir para activar la regla de automatización en el campo Aplicar en.
Nota
El activador Al cambiar en la interfaz solo se puede usar con la acción Ejecutar código y solo funciona cuando se realiza una modificación manualmente. La acción no se ejecuta si el campo se cambia a través de otra regla de automatización.
Externo¶
Activa acciones automáticas basadas en un evento específico en un sistema o aplicación externa usando un webhook.
Una vez configurado el webhook en Odoo, donde se genera la URL del webhook y se define el registro objetivo, debe implementarse en el sistema externo.
Advertencia
Le recomendamos consultar a un desarrollador, arquitecto de soluciones o cualquier otra persona con experiencia técnica antes de decidir si usar webhooks y durante el proceso de implementación. Si no se hace una configuración adecuada, los webhooks pueden afectar la base de datos de Odoo y puede tomar tiempo solucionar estos problemas.
Nota
También es posible configurar una acción automática que envíe datos al webhook de un sistema externo cuando ocurre un evento en tu base de datos de Odoo.
Ver también
Acciones¶
Una vez que hayas definido el activador de la regla de automatización, haz clic en Agregar una acción en la pestaña Acciones a realizar para definir las acciones que se ejecutarán.
Truco
Si no se ingresa un nombre explícito, el nombre de la acción se generará automáticamente según la acción que definas; el nombre se puede actualizar en cualquier momento.
Puedes definir múltiples acciones para la misma regla de automatización. Por defecto, las acciones se ejecutan en el orden en que fueron definidas.
Esto significa, por ejemplo, que si defines una acción Actualizar registro y luego una acción Enviar correo donde el correo hace referencia al campo que se actualizó, el correo usa los valores actualizados. Sin embargo, si la acción Enviar correo se define antes que la acción Actualizar registro, el correo usa los valores establecidos antes de que se actualice el registro.
Para cambiar el orden de las acciones definidas, haz clic en el ícono (controlador de arrastre) junto a una acción y arrástrala a la posición deseada.
Actualizar registro¶
Esta acción se usa para actualizar uno de los campos (relacionados) del registro. Las siguientes opciones están disponibles:
Actualizar: actualiza el campo seleccionado con el valor especificado.
Actualizar con IA: actualiza el campo seleccionado dinámicamente según el mensaje de IA proporcionado. Esta opción requiere que la aplicación Odoo IA esté instalada.
Secuencia: actualiza el campo seleccionado con una secuencia definida.
Calcular: actualiza el campo seleccionado dinámicamente usando código Python.
Para definir la acción:
Con la opción Actualizar, Actualizar con IA, Secuencia o Calcular seleccionada, según corresponda, selecciona o busca el campo que se actualizará o calculará. Si es necesario, haz clic en (flecha derecha) junto al nombre del campo para acceder a la lista de campos relacionados.
Proporciona la información relevante según la opción seleccionada.
Actualizar¶
Selecciona o ingresa el valor actualizado para el campo.
Si se está actualizando un campo many2many, elige si el campo debe actualizarse Agregando, Eliminando o Estableciéndolo en el valor seleccionado o Borrándolo.
Example
Si quieres que la acción automatizada elimine una etiqueta del registro del cliente, establece el campo Actualizar en Cliente > Etiquetas, selecciona por Eliminación, luego selecciona la etiqueta que se eliminará.
Actualizar con IA¶
Ingresa un mensaje para indicarle a Odoo IA cómo actualizar el campo. Escribe / para abrir las herramientas de mensaje de IA; usa Selector de campo para indicarle a Odoo IA qué campos relacionados verificar para el contexto, y Selector de registros para proporcionar valores posibles para el campo actualizado.
Example
Si quieres que la regla de automatización actualice el campo Asignados de una tarea recién creada según la experiencia de los empleados, puedes escribir un mensaje para indicarle a Odoo IA que verifique el campo Nombre para mostrar de la tarea para el contexto y luego asigne al empleado más adecuado.
Secuencia¶
Selecciona una secuencia existente o, para crear una nueva secuencia:
Haz clic en Buscar más, luego haz clic en Nuevo.
En la ventana que se abre, ingresa el Nombre de la secuencia.
En la pestaña Secuencia, configura la secuencia:
Prefijo: caracteres añadidos antes del siguiente número en la secuencia.
Sufijo: caracteres añadidos después del siguiente número en la secuencia.
Tamaño de secuencia: determina el número de dígitos en cada número de la secuencia. Si es necesario, se añaden ceros a la izquierda antes del número para alcanzar el tamaño de secuencia indicado, por ejemplo, para un tamaño de secuencia de
5, el primer número en la secuencia es00001.Paso: determina los incrementos entre los números de la secuencia.
Siguiente número: el siguiente número que se utilizará en la secuencia, sin ceros a la izquierda.
Truco
Utiliza marcadores dinámicos como
%(year)so%(month)scomo Prefijo y/o Sufijo para crear secuencias con elementos como el año actual, mes, etc. Los marcadores posibles se muestran en la parte inferior de la ventana.Para usar subsecuencias, por ejemplo, para que la secuencia se reinicie cada año o cada mes, activa Usar subsecuencias por rango de fechas, luego Añade una línea para cada rango de fechas e indica el Siguiente número para el rango.
Haga clic en Guardar.
Example
Si quieres que la acción automatizada cree una referencia de cliente secuencial cada vez que se crea un nuevo cliente, establece el campo Secuencia en Referencia, luego, en el menú desplegable, haz clic en Buscar más. Haz clic en Nuevo para crear una nueva secuencia.
En el ejemplo, cada nuevo cliente recibe una referencia secuencial con el prefijo #-REF-%(year)s-, donde %(year)s es el año actual incluyendo el siglo, y el sufijo /CL, por ejemplo, #-REF-2025-00001/CL, #-REF-2025-00002/CL, etc.
Calcular¶
Ingresa el código que se usará para calcular el valor del campo.
Example
Si quieres que la regla de automatización calcule un campo datetime personalizado, Escalado en, cuando la prioridad de una tarea se establece en Muy alta (tres estrellas), puedes definir el disparador Prioridad se establece en Muy alta y definir la acción Actualizar registro de la siguiente manera:
Crear registro y Duplicar registro¶
Estas acciones se utilizan para crear un registro nuevo o duplicado en cualquier modelo.
Para definir la acción:
Con Crear registro o Duplicar registro seleccionado como el Tipo de acción, según corresponda, selecciona el modelo requerido en el campo Registro a crear; el campo contiene el modelo actual por defecto.
Especifica un Nombre para el registro, o, si la acción duplica un registro, indica el registro que se está duplicando en el campo Duplicar de.
Si el registro nuevo o duplicado se está creando en otro modelo, selecciona un campo en el campo Campo de enlace para vincular el registro que desencadenó la creación del registro nuevo o duplicado.
Truco
El menú desplegable Campo de enlace solo contiene campos one2many existentes en el modelo actual que están vinculados a un campo many2one en el modelo de destino.
Example
Si quieres que la regla de automatización duplique un proyecto, por ejemplo, una plantilla de proyecto con tareas predefinidas, cuando una oportunidad se establece en Ganada, añade un campo many2one personalizado Oportunidad relacionada en el modelo Proyecto y un campo one2many personalizado Proyecto relacionado en el modelo Iniciativa, luego proporciona los siguientes detalles sobre el registro que se está duplicando:
Truco
Puedes crear otra regla de automatización con acciones Actualizar registro para actualizar los campos del registro nuevo o duplicado si es necesario. Por ejemplo, puedes usar una acción Crear registro para crear una nueva tarea del proyecto y luego asignarla a un usuario específico usando una acción Actualizar registro.
Crear actividad¶
Esta acción se utiliza para programar una nueva actividad vinculada al registro.
Para definir la acción:
Con Crear actividad seleccionado como el Tipo de acción, selecciona el Tipo de actividad apropiado del menú desplegable.
Ingresa un Título.
Indica cuándo debería completarse la actividad especificando un número de Días, Semanas, o Meses en el campo Fecha de vencimiento en.
Selecciona un Tipo de usuario:
Para asignar siempre la actividad al mismo usuario, selecciona Usuario específico, luego añade el usuario en el campo Responsable.
Para dirigirte a un usuario vinculado al registro de forma dinámica, selecciona Usuario dinámico (basado en registro). Si es necesario, cambia el Campo de usuario haciendo clic en el nombre del campo de marcador de posición y luego seleccionando o buscando el campo de usuario en la lista que aparece. Hacer clic en el (flecha derecha) junto al nombre del campo te permite acceder a campos relacionados si es necesario.
Opcionalmente, añade una Nota para proporcionar más información sobre la actividad.
Example
Después de que se envíe una propuesta a una oportunidad con un ingreso esperado alto, quieres crear una actividad para que el líder del equipo del vendedor llame al cliente potencial para aumentar las posibilidades de cerrar el trato.
Para hacerlo, establece el Tipo de actividad en Llamada y el Tipo de usuario en Usuario dinámico (basado en registro). Haz clic en el campo de marcador de posición y selecciona Equipo de ventas, luego haz clic en el (flecha derecha) y selecciona Líder del equipo.
Enviar correos electrónicos y enviar mensajes de texto¶
Estas acciones se utilizan para enviar un correo electrónico o un mensaje de texto a un contacto vinculado a un registro específico.
Para definir la acción:
Con Enviar correo electrónico o Enviar SMS seleccionado como el Tipo de acción, según corresponda, selecciona o crea una Plantilla de correo electrónico o Plantilla de SMS.
En el campo Enviar correo como o Enviar SMS como, elige cómo quieres enviar el correo electrónico o el mensaje de texto.
Para un correo electrónico, selecciona:
Correo electrónico: para enviar el mensaje como un correo electrónico a los destinatarios de la Plantilla de correo electrónico.
Mensaje: para publicar el mensaje en el registro y notificar a los seguidores del registro.
Nota: para enviar el mensaje como una nota interna que los usuarios internos podrán ver en el chatter.
Para un mensaje de texto, selecciona:
SMS (sin nota): para enviar el mensaje como un mensaje de texto a los destinatarios de la plantilla de SMS.
SMS (con nota): para enviar el mensaje como un mensaje de texto a los destinatarios de la plantilla de SMS y también publicarlo como una nota interna en el chatter.
Solo nota: para solo publicar el mensaje como una nota interna en el chatter.
Enviar WhatsApp¶
Importante
Para automatizar el envío de mensajes de WhatsApp debe crear una o varias plantillas de WhatsApp.
Esta acción se utiliza para enviar un mensaje de WhatsApp a un contacto vinculado a un registro específico.
Con Enviar WhatsApp seleccionado como Tipo de acción, selecciona la Plantilla de WhatsApp apropiada del menú desplegable.
Agregar o quitar seguidores¶
Esta acción se utiliza para suscribir/cancelar la suscripción de contactos existentes como seguidores del registro.
Con Añadir seguidores o Eliminar seguidores seleccionado como Tipo de acción, según corresponda, selecciona un Tipo de seguidores:
Para añadir/eliminar siempre el mismo contacto(s), selecciona Seguidores específicos y luego selecciona el contacto(s) del menú desplegable. Se pueden añadir/eliminar varios contactos.
Para añadir/eliminar un contacto vinculado al registro dinámicamente, selecciona Seguidores dinámicos. Si es necesario, cambia el Campo de seguidores haciendo clic en el nombre del campo de marcador de posición y luego seleccionando o buscando el campo de empresa en la lista que aparece. Al hacer clic en (flecha derecha) junto al nombre del campo, puedes acceder a campos relacionados si es necesario.
Example
Para mantener a los clientes informados del progreso de un proyecto, esta acción automatizada añade al cliente relevante como seguidor cuando una tarea de proyecto se establece como En progreso.
Ejecutar código¶
Importante
Para reglas de automatización que requieren la ejecución de código personalizado, ten en cuenta que el mantenimiento del código personalizado no está incluido en los planes de precios Estándar o Personalizado e incurre en tarifas adicionales.
Esta acción se usa para ejecutar código Python. Puede escribir su código en la pestaña Código con las siguientes variables:
env: entorno en el que se activa la acciónmodel: modelo del registro en el cual se activa la acción. Es un conjunto de registros vacío.record: registro en el que se activa la acción; puede estar vacío.records: conjunto de todos los registros en lo cuales la acción fue activada en modo múltiple; puede ser vacío.time,datetime,dateutil,timezone: librerías Python útilesfloat_compare: función de utilidad para comparar números basada en una precisión específica.log(message, level='info'): función de registro para registrar información de depuración en la tabla ir.logging._logger.info(message): registrador para emitir mensajes en los registros del servidor.UserError: clase de excepción para generar mensajes de advertencia dirigidos al usuario.Command: espacios de nombres de comandos x2many.action = {...}: para devolver una acción.
Truco
Las variables disponibles se describen en las pestañas Código y Ayuda.
Ver también
Enviar notificación webhook¶
Esta acción se utiliza para enviar una solicitud API POST con los valores de los Campos seleccionados a la URL del webhook especificada en el campo URL.
La Carga efectiva de ejemplo proporciona una vista previa de los datos que se incluyen en la solicitud usando los datos de un registro al azar o datos de prueba si es que no hay registros disponibles.
Nota
También es posible configurar una acción automatizada que utilice un webhook para recibir datos de un sistema externo cuando ocurre un evento predefinido en ese sistema.
Varias acciones¶
Esta acción se utiliza para activar múltiples acciones (vinculadas al modelo actual) al mismo tiempo.
Para definir las acciones:
Con Acciones múltiples seleccionado como Tipo de acción, haz clic en Añadir una acción.
En la ventana emergente Añadir: Acciones secundarias:
selecciona una o más acciones existentes y haz clic en Seleccionar; o
haz clic en Nuevo, define la acción a ejecutar y luego haz clic en Guardar y cerrar o, para crear acciones adicionales, Guardar y nuevo.
Repite tantas veces como sea necesario.
