| Tipo | Se ejecuta cuando |
|---|---|
schedule | Coincide una expresión cron. |
heartbeat | Pasa un intervalo, opcionalmente dentro de una franja diaria. |
event | Se emite un evento con una fuente que coincide. |
watch | Un observador de plugin escribe una línea de salida. |
folder | Cambian archivos en una carpeta. |
manual | El dueño o un empleado lo ejecuta. |
call | Suena una línea telefónica. Solo en árboles de llamadas telefónicas. |
schedule
{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" } cron es una expresión cron de cinco campos: minuto, hora, día del mes, mes, día de la semana. schedule es una descripción opcional para las personas. Las programaciones se ejecutan en la zona horaria local del bot. Nebo revisa las programaciones cada cinco segundos. Una activación que se perdió mientras el bot estaba apagado se recupera una vez si lleva menos de una hora de retraso. Una activación se omite mientras la ejecución anterior sigue en curso.
heartbeat
{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" } interval es un lapso como 30m, 1h o 2h30m. window, HH:MM-HH:MM, mantiene las activaciones dentro del horario laboral. La siguiente activación es la última más el intervalo, movida dentro de la franja; la primera ocurre un intervalo después de que se carga el flujo de trabajo. Los temporizadores se conservan tras los reinicios. Una activación se omite mientras la ejecución anterior sigue en curso, y un intervalo no válido nunca se activa.
event
{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] } sources enumera nombres de eventos que deben coincidir exactamente o con un comodín .* al final. Una lista vacía es un error que rechaza todo el agent.json. La ejecución recibe _event_source, _event_payload y _event_origin. Consulta Eventos para ver cómo se forman los nombres.
watch
{ "type": "watch", "plugin": "mail", "event": "email.new" } Un watch mantiene un proceso del plugin en ejecución e inicia una ejecución por cada línea que escribe. Cada línea llega como _watch_payload. Las líneas idénticas dentro de diez minutos se descartan.
| Campo | Predeterminado | Significado |
|---|---|---|
plugin | obligatorio | Una capacidad, como mail, o el slug de un plugin. Nombra una capacidad siempre que haya una adecuada. |
event | ninguno | Un evento de la lista events del plugin. Nebo usa el comando de ese evento y también emite cada línea como <plugin>.<event>. |
command | ninguno | Argumentos que inician el observador. Se usan cuando están definidos; si no, se toman de event. |
restart_delay_secs | 5 | Espera antes de reiniciar un observador que termina. |
Una capacidad se resuelve al plugin instalado que la ofrece, con preferencia por uno en el que este empleado tenga una cuenta. Si no hay un plugin así, el flujo de trabajo se marca como degradado y se le indica al dueño qué conectar. Un observador que sigue fallando se reinicia con una demora que se duplica hasta 300 segundos y se restablece tras 30 segundos de funcionamiento.
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } {{key}} en command se completa con las respuestas del dueño a los datos de entrada del empleado. Si un marcador no tiene respuesta, la vigilancia no se inicia.
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | Campo | Predeterminado | Significado |
|---|---|---|
path | obligatorio | Ruta absoluta de la carpeta. {{key}} se completa con las entradas. |
extensions | todos los archivos | Extensiones de archivo que deben coincidir, sin el punto. |
recursive | true | Incluir subcarpetas. |
debounce_secs | 2 | Los cambios dentro de este lapso se convierten en una sola ejecución. |
La ejecución recibe las rutas modificadas en _watch_payload.files.
manual
{ "type": "manual" } Un flujo de trabajo manual solo se ejecuta cuando el dueño lo ejecuta o un empleado llama a run_workflow. Cualquier flujo de trabajo, sea cual sea su disparador, también se puede ejecutar así.
call
{"type": "call", "line": "..."} solo es válido en un flujo de trabajo de "type": "call_tree", que configura cómo un empleado contesta una línea telefónica. Un line vacío se aplica a todas las líneas que contesta el empleado que no tengan un árbol más específico. Un árbol de llamadas debe tener exactamente un saludo y al menos una intención con nombre.
Webhooks
El dueño también puede crear un webhook para un empleado. Un webhook vinculado a un flujo de trabajo ejecuta ese flujo de trabajo; uno sin flujo de trabajo entrega su carga al chat del empleado.