Skip to main content
Una automatización es un libro de estrategias: cuando suceda X, ejecute los pasos (enviar, esperar, IA, condición…). Un evento es el nombre del hecho. Una ejecución es cada vez que se ejecuta el libro de jugadas para una persona.

​
¿Qué son las Automatizaciones en Notifique?

El motor de viaje: creas un gráfico de pasos en el panel o mediante API. Cuando se activa el disparador, una ejecución recorre los envíos de plantillas, los retrasos, los asistentes de IA, las actualizaciones de contactos y más. Puede:
  • Activador desde tu API (order.paid, user.created)
  • Recibir webhooks HTTP de herramientas externas (Zapier, ERP)
  • Reaccionar a mensajes entrantes (WhatsApp, SMS, widget…)
  • Reaccionar a fases de llamada WhatsApp saliente (completada, colgada, sin respuesta…)
  • Inspeccionar ejecuciones y auditar lo que sucedió
Pensemos en un guión de teatro: el gatillo levanta el telón; cada paso es una escena.

​
Mapa conceptual

Campaña (pestaña Contactos) = envío masivo de una sola vez. Automatización = secuencia repetible cada vez que el gatillo se dispara nuevamente.
Webhook de automatización (inicia el flujo) ≠ Notifique webhook (estado de entrega del canal, etc.). Ver Webhooks en Guías.

​
Cuatro formas de activar

​
Gatillo whatsappCall

En el editor: Llamada WhatsApp. En el grafo:
Fases: initiated · answered · completed · hung_up · failed · no_answer · rejected.
  • completed: el audio/habla terminó (par con webhook whatsapp.call.completed).
  • hung_up: alguien colgó a mitad (par con whatsapp.call.hung_up).
El payload de la run incluye callId, to / toE164, status, hangupReason, durationSecs, type, instanceId, direction: OUTBOUND. Idempotencia por (automatización, callId, callPhase).

​
Gatillo channelInbound en el chat del sitio (WEB_WIDGET)

Para automatizaciones en el widget del sitio, use triggerKind: "channelInbound" con channel: "WEB_WIDGET". El paso sendWebWidget responde en el mismo chat y solo está permitido con este gatillo.
webWidgetId opcional: omitir o null = cualquier widget del workspace.

​
Condición de horario (schedule)

En la condición, fuente Horario comercial: zona IANA, días de la semana y ventana HH:mm. Rama true si “ahora” está dentro de la ventana; false si no (útil para inbound fuera de horario).

​
Tipos de pasos comunes

Estado de automatización: ENABLED (se activa) o DISABLED (no se activa). POST /v1/automations//stop desactiva la automatización (DISABLED) y cancela ejecuciones activas (QUEUED / RUNNING) — alcance automations:write.

​
¿Qué hay en la API v1?

Rutas con el prefijo /v1/ y autenticación Clave API (sk_live_... / sk_test_...):
  • Eventos, registro y activación (events:read, events:write)
  • Automatizaciones, gráficos, flujo de parada, ejecuciones de lista (automations:read, automations:write)
Referencia completa en la especificación Automatizaciones y eventos en la barra lateral.
Cada clave API pertenece a un espacio de trabajo. En v1 no enviar x-workspace-id. Utilice Idempotency-Key al enviar eventos.

​
Panel de control (fuera de la API v1)

Las bases de conocimiento, los asistentes y las integraciones MCP se configuran en el panel (Automatizaciones → Bases, Asistentes, MCP). No existen rutas /v1/ públicas para estos en esta documentación, utilice Asistentes, Base de conocimientos, e Integraciones MCP.

​
¿Cuándo usarlo?

Ideal para secuencias posteriores al evento, chatbots y seguimientos (espera + segundo mensaje). Para un envío único sin repetición, use templates o la API del canal.

​
Próximos pasos