Automatizaciones (Flujos)

Motor de automatización visual del CRM. Un flujo es una secuencia de pasos que se ejecuta cuando ocurre un evento del sistema (alta de cliente, movimiento, fecha programada, etc.). En cada paso podés evaluar condiciones, esperar tiempos, enviar WhatsApp / Email, llamar a un HTTP externo o actualizar datos del cliente.

Filtros

• Nombre del flujo.
• Estado: activo / inactivo. Los flujos inactivos no se ejecutan aunque ocurra su trigger.

Columnas

• Nombre y descripción.
• Trigger (CodigoTrigger): evento que dispara el flujo. Los más comunes:
  • ALTA_CLIENTE — cuando se registra un cliente nuevo.
  • MOVIMIENTO — al registrar una venta o canje.
  • FECHA_PROGRAMADA — disparo periódico por cron en una fecha calculada.
  • CAMBIO_CATEGORIA — cuando un cliente sube o baja de nivel de loyalty.
  • WEBHOOK — invocación externa por HTTP.
• Anti-spam: AntispamHoras y AntispamMaxEnvios — evita re-disparar al mismo cliente más de N veces en una ventana de horas.
• Fechas de alta y modificación, estado.

Acciones

• Nuevo flujo (modal con datos básicos).
• Editar: abre flujo_editor.php con el editor visual Drawflow para diseñar los nodos (triggers, condiciones IF/CASE, esperas, acciones).
• Simular (flujo_simular.php): ejecutá el flujo contra un cliente de prueba sin enviar mensajes reales, para validar ramas y variables.
• Activar / desactivar.
• Importar / Exportar JSON (FlujoJSON) — reutilizá flujos entre campañas.
• Ver log de ejecución (flujos_log.php): traza paso a paso de cada disparo, con cliente, timestamp, resultado y error si lo hubo.
• Subir media (flujos_upload_media.php) para imágenes / PDFs adjuntos.

Tipos de nodo

• Trigger (entrada): define cuándo arranca.
• Condición: IF / CASE sobre datos del cliente, campo personalizado, puntos, comercio, grupo de interés, etc.
• Espera: pausa el flujo X minutos / horas / días.
• Acción - Email: envía una Plantilla de email de la campaña.
• Acción - WhatsApp: usa una plantilla aprobada de Meta o una respuesta rápida de Evolution.
• Acción - HTTP: llama a un endpoint externo (webhook).
• Acción - Actualizar cliente: setea campos personalizados, agrega tags, cambia grupo de interés.

Circuitos asociados

• Plantillas de email → fuente de los textos / HTML para los nodos de Email.
• Meta Cloud API y Evolution API → canales para los nodos de WhatsApp.
• Respuestas rápidas (Evolution) → mensajes preconfigurados a usar como acción.
• Campos personalizados y Grupos de interés → variables y condiciones disponibles en los nodos IF/CASE.
• Parámetros → credenciales (webhooks, API keys) leídas por los nodos HTTP.
• Cron flujos_cron.php → motor de ejecución que avanza paso a paso los flujos pendientes.

Buenas prácticas

• Antes de activar, simulá el flujo con un cliente de prueba.
• Configurá anti-spam realistas para evitar bombardear al cliente si el trigger se repite (ej: varios movimientos en un día).
• Usá condiciones al inicio para descartar clientes que no aplican y ahorrar pasos.
• Revisá el log de ejecución después de las primeras 24-48hs para detectar ramas mal diseñadas.

El diseño del flujo se almacena en JSON (FlujoJSON) y el motor avanza por nodos según el estado de cada instancia activa, persistido en la tabla de ejecuciones.