Configura una automatización de WhatsApp en WACRM y lee su registro de ejecuciones

Una automatización en WACRM es una regla: cuando algo pasa — un pedido nuevo, un pedido marcado como completado, un carrito abandonado, un mensaje entrante o un recordatorio de reserva — ejecuta una o más acciones sobre el contacto del que trata ese evento. Este tutorial recorre la pantalla real de Automatizaciones, los 5 disparadores y las 4 acciones que existen hoy, cómo activar o desactivar una regla, cómo leer su registro de ejecuciones, y lo mismo por la API.

Qué necesitas antes de empezar

• Una cuenta de WACRM Workspace con al menos un proyecto.
• Para los disparadores Pedido nuevo, Pedido completado y Carrito abandonado: una tienda conectada — se disparan desde actividad real de la tienda, no desde una demo. Si tu plan incluye una conexión de tienda no está detallado más allá de “Store connector (early access)” en el plan Advanced; revisa tu plan en Settings si no estás seguro.
• Para la acción Enviar una plantilla: al menos una plantilla aprobada, porque la acción solo deja elegir entre plantillas aprobadas.
• Solo para los pasos de la API: curl (o cualquier cliente HTTP que pueda poner un encabezado), y una clave de API desde Developer / API & MCP.

Crea una automatización en Workspace

1. Abre Automatizaciones en Workspace.
2. Haz clic en Nueva automatización.
3. Completa un Nombre y elige un Disparador. Si eliges Recordatorio de reserva, aparece un campo Momento del recordatorio — elige 24 horas antes o 2 horas antes; la regla solo corre para ese momento, nunca para el otro.
4. En Acciones, haz clic en Agregar acción por cada acción que quieras que esta regla ejecute cuando se dispare. Elige un Tipo de acción y completa los campos de ese tipo (ve la tabla abajo). Dejar Acciones vacío igual guarda la regla — se dispara y queda registrada en el registro de ejecuciones, solo que no hace nada.
5. Haz clic en Crear automatización.

Los 5 disparadores

Pedido nuevo y Pedido completado suelen respaldar confirmaciones de pedido y envíos de actualización de estado, el tipo de mensaje que WhatsApp clasifica como conversación de Utilidad, no de Marketing.

Las 4 acciones

Una acción sin contacto con el que trabajar (ningún contacto resuelto desde el evento disparador) se omite, no falla — Agregar una etiqueta y Crear un ticket necesitan uno. Proponer una acción del agente también se omite mientras la IA del workspace está en pausa. Enviar una plantilla revisa contacto, pausa de IA, consentimiento y el estado de aprobación de la plantilla, en ese orden, antes de enviar algo — el mismo estado Approved que exige el propio flujo de creación de plantillas de Meta en WhatsApp Manager antes de poder usar una plantilla. Ve “Lee el registro de ejecuciones” abajo para ver cómo se ve cada caso cuando una regla no envía nada.

Activa o desactiva una regla

Cada fila de la lista de automatizaciones tiene un interruptor Activada, mostrado como Activado o Desactivado. Cambiarlo guarda de inmediato; si falla, el interruptor vuelve a su estado anterior y aparece un error en línea — nada cambia en silencio. Desactivar una regla hace que deje de dispararse con eventos nuevos; no toca las ejecuciones que ya registró.

Para eliminar una regla por completo, usa la acción Eliminar de la fila. Un cuadro de confirmación te pide confirmarlo: “<nombre>” se eliminará de forma permanente. Esta acción no se puede deshacer.

Lee el registro de ejecuciones

Cada fila tiene una columna Últimas ejecuciones con un interruptor Ver últimas ejecuciones. Abrirlo (solo cuando haces clic — la tabla nunca obtiene las ejecuciones de todas las reglas solo por cargar la página) trae las 5 ejecuciones más recientes de la regla y muestra el estado de cada una:

Una ejecución Omitida o Fallida también muestra un motivo, en lenguaje claro: Sin contacto en este evento, Contacto no encontrado, Etiqueta no encontrada, La IA está en pausa para este workspace, El contacto no ha dado su consentimiento, Plantilla no encontrada, Plantilla no aprobada, Falló el envío, Tipo de acción desconocido, o Error al ejecutar esta acción. Una acción Enviar una plantilla cuyo envío falla por cualquier motivo — no solo un consentimiento denegado — siempre se registra Fallida con motivo Falló el envío, nunca Omitida, así que un problema real de entrega nunca se muestra igual que una omisión esperada por “el contacto no ha dado su consentimiento”.

Una ejecución que se interrumpe

Una ejecución se reclama en el momento en que se dispara y se finaliza una vez que todas las acciones corrieron. Si el proceso muere en el medio — una caída, un reinicio — la ejecución queda Pendiente y no se reintenta de inmediato. Una revisión programada (hoy, cada 15 minutos) busca ejecuciones pendientes de más de 15 minutos y las reanuda desde donde quedaron: ninguna acción ya registrada en esa ejecución se vuelve a correr, así que una plantilla que ya se envió nunca se envía una segunda vez — la misma garantía de reintento idempotente en la que se apoya una ejecución reanudada. Una ejecución recibe hasta 3 intentos en total; una vez agotados se marca Fallida, con un motivo que el registro de ejecuciones todavía no tiene traducido — verás el valor sin traducir requeue_exhausted en vez de una frase.

Lo mismo por la API

Las automatizaciones también son un recurso de la Core API, bajo /v1/crm-projects/{project}/automations. Las lecturas usan el scope agent:propose, las escrituras usan agent:approve — marca los dos en Restrict what this key can do (advanced) → WhatsApp CRM scopes al crear una clave en Developer / API & MCP (agent:approve necesita una Secret key).

Crea una regla con una acción

curl -s -X POST "https://api.wacrm.ai/v1/crm-projects/your-project-uuid/automations" \
  -H "Authorization: Bearer sk_live_your_scoped_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Etiquetar pedidos nuevos",
    "trigger": "order_created",
    "enabled": true,
    "config": { "actions": [{ "type": "add_label", "label_id": "your-label-uuid" }] }
  }'

{
  "data": {
    "id": "0e2b1c9a-...-automation-uuid",
    "name": "Etiquetar pedidos nuevos",
    "trigger": "order_created",
    "config": { "actions": [{ "type": "add_label", "label_id": "your-label-uuid" }] },
    "enabled": true,
    "created_at": "2026-11-08T09:00:00+00:00",
    "updated_at": "2026-11-08T09:00:00+00:00"
  }
}

Un trigger no reconocido responde 422 invalid_trigger; un config que no cumple lo que ese disparador (o ese tipo de acción) requiere responde 422 invalid_config — por ejemplo, booking_reminder sin un kind de 24h/2h, o una acción add_label cuyo label_id no es una etiqueta de tu propio proyecto.

Lista las ejecuciones de una regla

curl -s "https://api.wacrm.ai/v1/crm-projects/your-project-uuid/automations/your-automation-uuid/runs?limit=5" \
  -H "Authorization: Bearer sk_live_your_scoped_key"

{
  "data": [
    { "event_key": "order:9f2a...", "status": "ok", "reason": null },
    { "event_key": "order:7c10...", "status": "skipped", "reason": "no_contact" }
  ]
}

Las más nuevas primero, con los mismos campos que lee el propio panel de Últimas ejecuciones, limit de 1 a 100 (por defecto 20). Un id de proyecto que tu clave no posee, o un id de automatización de otro proyecto, ambos responden 404 not_found — nunca 403, así que no puedes distinguir los dos casos desde la respuesta. Una clave sin el scope necesario responde 403 insufficient_scope.

Qué funciona hoy y qué todavía no

¿Listo para ponerlo en práctica? Solicita acceso anticipado para tener un Workspace, o deja que el equipo de WACRM configure tu proyecto con Quick Setup.