Tareas programadas: ejecuta trabajos a horas fijas
Una tarea programada ejecuta algo en tu sitio a horas fijas sin que nadie pulse un botón: un resumen cada mañana, una limpieza cada domingo por la noche. Las encuentras en Settings del proyecto, en Scheduled tasks. Esta página muestra cómo configurar una, leer sus ejecuciones y arreglar una que falla.
Qué hace una tarea programada
Una tarea programada es una llamada que Briks hace según un horario. Llama a una ruta de tu sitio (una dirección bajo /api/ que ejecuta código en lugar de mostrar una página) o a otra dirección https pública, como un servicio que usas. La dirección hace el trabajo. Briks hace la llamada a su hora y registra lo que responde.
Así que una tarea necesita algo a lo que llamar. Si tu sitio aún no tiene una ruta para ese trabajo, pídela primero en el estudio y luego apunta una tarea hacia ella. Si todavía no hay tareas, la página dice No scheduled tasks y resume los trabajos habituales: enviar un resumen diario, limpiar registros antiguos o sincronizar con otro servicio.
Las tareas se ejecutan estén o no publicados los sitios, a las horas que fijes, en la zona horaria que elijas. La sección tiene tres vistas: Tasks, Runs y Settings.
Límites de cada plan
| Plan | Tareas programadas por proyecto | Llamadas al día por proyecto |
|---|---|---|
| Free | 1 | 2,000 |
| Starter | 5 | 5,000 |
| Pro | 10 | 10,000 |
| Studio | 25 | 50.000 |
| Agency | 50 | 100.000 |
La vista Tasks muestra en qué punto estás, por ejemplo 2 de 5 en tu plan, y Add task aparece en gris cuando llegas al límite. Entonces aparece un enlace Get more junto al contador que abre la ventana de mejora de plan, donde se nombra el plan más pequeño con espacio para otra tarea. Una ejecución que superaría las llamadas del día se marca como Skipped. Los planes se comparan en Facturación.
Añadir una tarea programada
Pulsa Add task
Dónde: Settings, Scheduled tasks
Se abre el diálogo Add a scheduled task. Editors, Admins y Owners pueden añadir tareas.
Ponle nombre
Dónde: Add a scheduled task
Ponle un nombre corto que reconozcas en la lista de ejecuciones, como
Daily digest. Hasta 60 caracteres.Fija la programación
Dónde: Add a scheduled task
Escribe una programación en Schedule o pulsa uno de los botones que hay debajo. La siguiente sección explica el formato.
Elige la zona horaria
Dónde: Add a scheduled task
Time zone empieza con la tuya. Un cuadro debajo muestra la programación con palabras y las próximas cinco veces que se ejecutará allí, para que la compruebes antes de guardar.
Di lo que pide
Dónde: Add a scheduled task
En What it calls, elige A route on this site y escribe su ruta (empieza por
/api/), o Another address y escribe una dirección https completa. Si es una ruta, la pista bajo el cuadro muestra la dirección completa a la que se llamará.Elige POST o GET
Dónde: Add a scheduled task
POST envía un mensaje corto con la llamada, que es lo que esperan la mayoría de las rutas creadas para una tarea. GET solo pide la dirección. Si no estás seguro, deja POST.
Guardar
Dónde: Add a scheduled task
Pulsa Add task. Solo se guarda cuando el programador la ha aceptado, así que todas las tareas de la lista son tareas que se ejecutan.
Escribir un horario
Una programación son cinco valores separados por espacios: minuto, hora, día del mes, mes y día de la semana. Un * significa cada uno. Si lo que escribes no se puede leer, el cuadro indica qué falla, por ejemplo qué valor está fuera de rango.
| Quieres | Tipo | La vista previa dice |
|---|---|---|
| Cada mañana a las 7 | 0 7 * * * | Todos los días a las 07:00 |
| De lunes a viernes a las seis y media de la tarde | 30 18 * * 1-5 | Cada día laborable a las 18:30 |
| Cada 15 minutos | */15 * * * * | Cada 15 minutos |
| Cada dos horas, en punto | 0 */2 * * * | Cada 2 horas, en punto |
| Los domingos a las 11 de la noche | 0 23 * * 0 | Todos los domingos a las 23:00 |
| El día 1 de cada mes a las 6 de la mañana | 0 6 1 * * | El día 1 de cada mes a las 06:00 |
Los días de la semana van de 0 (domingo) a 6 (sábado), y 7 también es domingo. También puedes escribir nombres como mon o jan, listas como 1,3,5, rangos como 1-5 y intervalos como */10. También funcionan los atajos: @hourly, @daily, @weekly, @monthly y @yearly.
Los botones bajo el cuadro lo rellenan por ti: Every 5 minutes, Every hour, Every day at 09:00, Mondays at 09:00 y First of the month.
Qué incluye cada llamada
Una tarea espera hasta 30 segundos una respuesta. Cada llamada lleva un user-agent de Briks-Cron/1.0 y una cabecera x-briks-cron con el id de la tarea, para que la ruta sepa de dónde viene la llamada. Una llamada POST también envía un breve mensaje JSON (JSON es un formato de texto plano que leen los programas) que nombra la tarea:
{"cron":{"id":"…","name":"Daily digest"},"trigger":"schedule","scheduledFor":"2026-10-09T06:00:00.000Z"}
trigger es manual cuando alguien pulsó Run now, y entonces scheduledFor es null.
Briks no llamará a una dirección de una red privada, a una dirección escrita con números ni a una de sus propias direcciones, y no sigue redirecciones, así que indica la dirección final. Las llamadas a una ruta de tu sitio van a su dirección briks.live, y si cambias esa dirección, las llamadas la siguen.
Ejecuciones y qué significa cada estado
Runs lista todas las ejecuciones de los últimos treinta días, de la más reciente a la más antigua, programadas o iniciadas a mano. Una ejecución iniciada a mano lleva una etiqueta By hand. Si tienes más de una tarea, elige una en el cuadro sobre la lista y pulsa Show. Haz clic en una ejecución para ver el método y la dirección a la que llamó, cualquier error y el comienzo de lo que respondió la dirección.
| Estado | Qué pasó |
|---|---|
| Succeeded | La dirección respondió con un estado 2xx, el código de la web para indicar éxito. |
| Failed | Cualquier otra cosa: un estado distinto (404 significa no encontrado, 500 significa que falló el código que hay detrás), ninguna respuesta en 30 segundos, una redirección o una dirección a la que no se pudo llegar. |
| Skipped | Se agotaron las llamadas del día para el proyecto. La ejecución indica: Today's calls for this project are used up. Las ejecuciones se reanudan después de medianoche (UTC). |
La vista Tasks muestra lo mismo de un vistazo: Next y la hora de la próxima ejecución, Last con el último estado, o Not run yet.
Cuando falla una ejecución
Una ejecución fallida se registra y no se repite. La siguiente llega a su hora habitual. Tampoco se recuperan las ejecuciones perdidas mientras nada podía ejecutarlas: la tarea se ejecuta una vez y sigue desde ahí.
Cuando hayas corregido la causa, abre los tres puntos de la tarea y elige Run now. El resultado aparece enseguida, por ejemplo: Daily digest ran: the address answered 200 in 312 ms. Puedes ejecutar una tarea a mano hasta 20 veces por hora, y cada ejecución cuenta para las llamadas del día.
| Lo que dice la ejecución | Qué hacer |
|---|---|
| respondió 404 | No hay ninguna ruta en esa dirección. Revisa la ortografía y que la versión con la ruta esté publicada. |
| respondió 500 | La propia ruta falló. Abre Logs, elige Requests y busca la ruta para leer el error. |
| Sin respuesta en 30 segundos. | La tarea tarda demasiado de una sola vez. Pide en el estudio la ruta para hacer menos en cada llamada, y ejecútala más a menudo. |
| No se siguen las redirecciones: usa la dirección final. | Abre la dirección en un navegador, copia la dirección en la que termina y cambia la tarea a esa. |
| Esa dirección apunta a una red privada y no se puede llamar. | Usa una dirección pública. Briks nunca se conecta a redes privadas. |
Pausar, cambiar o eliminar
El interruptor junto a cada tarea la pausa (aparece una etiqueta Paused) y la reactiva. En sus tres puntos, Change abre el mismo formulario, titulado Change task, y Delete la detiene y elimina su historial de ejecuciones. Todo esto requiere permisos de edición.
La vista Settings tiene Download JSON, un archivo con el nombre, el horario, la zona horaria y la dirección a la que llama cada tarea. Su zona de peligro incluye Clear history (las tareas siguen ejecutándose) y Delete all (escribes el nombre del proyecto para confirmar). Ambas son para Owners y Admins.
Ejemplos prácticos
Añade una ruta en /api/daily-summary que me envíe por email las solicitudes de cita de ayer en un solo mensaje.
Tras publicar el cambio, la clínica añade una tarea programada llamada Daily summary con el horario 0 7 * * *, zona horaria Europe/London, que llama a POST /api/daily-summary. Cada mañana a las siete llega el resumen.
El resumen se envía mediante el correo propio del sitio, que está desactivado hasta que lo actives. Consulta Correo del sitio para saber cómo hacerlo y cuál es el límite mensual.
Añade una ruta en /api/tidy-enquiries que borre las consultas con más de 90 días.
Una tarea llamada Tidy enquiries la ejecuta con 0 23 * * 0, cada domingo a las 23:00. El lunes, Runs muestra Succeeded, y al abrir la ejecución ves lo que respondió la ruta.
Antes de ejecutar por primera vez una limpieza como esta, guarda un punto de restauración en los ajustes de la pestaña Database. Si la ruta borra más de lo debido, puedes volver atrás. Consulta Backups.