Tugas terjadwal: jalankan pekerjaan di situs Anda
Tugas terjadwal menjalankan sesuatu di situs Anda pada waktu tertentu tanpa ada yang menekan tombol: ringkasan setiap pagi, pembersihan setiap Minggu malam. Anda menemukannya di Settings proyek, bagian Scheduled tasks. Halaman ini menunjukkan cara menyiapkannya, membaca eksekusinya, dan memperbaiki tugas yang gagal.
Apa yang dilakukan tugas terjadwal
Tugas terjadwal adalah panggilan yang dilakukan Briks sesuai jadwal. Panggilan itu menuju sebuah route di situs Anda (alamat di bawah /api/ yang menjalankan kode, bukan menampilkan halaman) atau alamat https publik lain, misalnya layanan yang Anda gunakan. Alamat itulah yang mengerjakan tugasnya. Briks melakukan panggilan tepat waktu dan mencatat balasan yang diterima.
Jadi, sebuah tugas membutuhkan sesuatu untuk dipanggil. Jika situs Anda belum punya route untuk pekerjaan itu, mintalah satu di studio terlebih dahulu, lalu arahkan tugas ke sana. Selama belum ada tugas, halaman menampilkan No scheduled tasks dan merangkum pekerjaan yang lazim: mengirim ringkasan harian, merapikan data lama, atau menyinkronkan dengan layanan lain.
Tugas berjalan baik situs sudah dipublikasikan maupun belum, pada waktu yang Anda tetapkan, di zona waktu yang Anda pilih. Bagian ini punya tiga tampilan: Tasks, Runs dan Settings.
Batas di setiap paket
| Paket | Tugas terjadwal per proyek | Panggilan per hari untuk setiap proyek |
|---|---|---|
| Free | 1 | 2,000 |
| Starter | 5 | 5.000 |
| Pro | 10 | 10,000 |
| Studio | 25 | 50.000 |
| Agency | 50 | 100.000 |
Tampilan Tasks menunjukkan posisi Anda, misalnya 2 dari 5 pada paket Anda, dan Add task menjadi abu-abu setelah Anda mencapai batas. Tautan Get more lalu muncul di samping hitungan dan membuka jendela upgrade, yang menyebut paket terkecil dengan ruang untuk satu tugas lagi. Proses yang akan melewati batas panggilan hari itu ditandai Skipped. Paket dibandingkan di Penagihan.
Tambahkan tugas terjadwal
Tekan Add task
Di mana: Settings, Scheduled tasks
Dialog Add a scheduled task terbuka. Editor, Admin, dan Owner dapat menambahkan tugas.
Beri nama
Di mana: Add a scheduled task
Beri nama singkat yang mudah Anda kenali di daftar proses, misalnya
Daily digest. Maksimal 60 karakter.Atur jadwal
Di mana: Add a scheduled task
Ketik jadwal di Schedule atau tekan salah satu tombol di bawahnya. Bagian berikutnya menjelaskan formatnya.
Pilih zona waktu
Di mana: Add a scheduled task
Time zone dimulai dari zona waktu Anda sendiri. Kotak di bawahnya menampilkan jadwal dalam kata-kata beserta lima waktu berikutnya saat jadwal berjalan di sana, sehingga Anda bisa memeriksanya sebelum menyimpan.
Sebutkan apa yang dipanggilnya
Di mana: Add a scheduled task
Di bawah What it calls, pilih A route on this site lalu ketik path-nya (diawali
/api/), atau Another address lalu ketik alamat https lengkap. Untuk route, petunjuk di bawah kotak menampilkan alamat lengkap yang akan dipanggil.Pilih POST atau GET
Di mana: Add a scheduled task
POST mengirim pesan singkat bersama panggilan, yang diharapkan oleh sebagian besar rute yang dibuat untuk sebuah tugas. GET hanya meminta alamat. Jika ragu, biarkan POST.
Simpan
Di mana: Add a scheduled task
Tekan Add task. Tugas baru disimpan hanya setelah penjadwal menerimanya, jadi setiap tugas dalam daftar adalah tugas yang berjalan.
Menulis jadwal
Jadwal terdiri dari lima nilai yang dipisahkan spasi: menit, jam, tanggal, bulan, dan hari dalam seminggu. Tanda * berarti setiap. Jika yang Anda ketik tidak bisa dibaca, kotak akan menjelaskan apa yang salah, misalnya nilai mana yang di luar rentang.
| Anda ingin | Tipe | Pratinjau menyatakan |
|---|---|---|
| Setiap pagi pukul 7 | 0 7 * * * | Setiap hari pukul 07:00 |
| Hari kerja pukul setengah tujuh malam | 30 18 * * 1-5 | Setiap hari kerja pukul 18:30 |
| Setiap 15 menit | */15 * * * * | Setiap 15 menit |
| Setiap dua jam, tepat pada jam bulat | 0 */2 * * * | Setiap 2 jam, tepat pada jam bulat |
| Minggu malam pukul 11 | 0 23 * * 0 | Setiap Minggu pukul 23:00 |
| Setiap tanggal 1 pukul 06.00 pagi | 0 6 1 * * | Pada tanggal 1 setiap bulan pukul 06:00 |
Hari dalam seminggu berjalan dari 0 (Minggu) sampai 6 (Sabtu), dan 7 juga berarti Minggu. Anda juga bisa menulis nama seperti mon atau jan, daftar seperti 1,3,5, rentang seperti 1-5, dan langkah seperti */10. Pintasan juga bisa dipakai: @hourly, @daily, @weekly, @monthly, dan @yearly.
Tombol di bawah kotak mengisinya untuk Anda: Every 5 minutes, Every hour, Every day at 09:00, Mondays at 09:00 dan First of the month.
Apa yang dibawa setiap panggilan
Sebuah tugas menunggu jawaban hingga 30 detik. Setiap panggilan membawa user-agent berisi Briks-Cron/1.0 dan header x-briks-cron yang memuat id tugas, sehingga route dapat mengetahui dari mana panggilan datang. Panggilan POST juga mengirim pesan JSON singkat (JSON adalah format teks biasa yang dibaca program) yang menyebut nama tugas:
{"cron":{"id":"…","name":"Daily digest"},"trigger":"schedule","scheduledFor":"2026-10-09T06:00:00.000Z"}
trigger bernilai manual saat seseorang menekan Run now, dan saat itu scheduledFor bernilai null.
Briks tidak akan memanggil alamat di jaringan privat, alamat yang ditulis sebagai angka, atau salah satu alamatnya sendiri, dan tidak mengikuti pengalihan, jadi berikan alamat akhirnya. Panggilan ke sebuah rute di situs Anda diarahkan ke alamat briks.live-nya, dan jika Anda mengubah alamat itu, panggilan akan mengikutinya.
Run dan arti setiap statusnya
Runs mencantumkan setiap eksekusi dalam tiga puluh hari terakhir, terbaru di atas, baik terjadwal maupun dimulai manual. Eksekusi manual diberi tag By hand. Jika tugasnya lebih dari satu, pilih salah satu di kotak di atas daftar lalu tekan Show. Klik sebuah eksekusi untuk melihat metode dan alamat yang dipanggil, error jika ada, dan awal jawaban dari alamat itu.
| Status | Apa yang terjadi |
|---|---|
| Succeeded | Alamat itu menjawab dengan status 2xx, kode keberhasilan di web. |
| Failed | Apa pun yang lain: status berbeda (404 berarti tidak ditemukan, 500 berarti kode di baliknya gagal), tidak ada jawaban dalam 30 detik, pengalihan, atau alamat yang tidak bisa dijangkau. |
| Skipped | Panggilan proyek untuk hari ini telah habis. Proses itu menyatakan: Today's calls for this project are used up. Proses dimulai lagi setelah tengah malam (UTC). |
Tampilan Tasks menunjukkan hal yang sama sekilas: Next dan waktu eksekusi berikutnya, Last dengan status terbaru, atau Not run yet.
Saat sebuah proses gagal
Eksekusi yang gagal dicatat dan tidak diulang. Eksekusi berikutnya datang pada waktu biasanya. Eksekusi yang terlewat saat tidak ada yang bisa menjalankannya juga tidak disusulkan: tugas berjalan sekali lalu berlanjut dari sana.
Setelah Anda memperbaiki penyebabnya, buka tiga titik pada tugas dan pilih Run now. Hasilnya langsung muncul, misalnya: Daily digest ran: the address answered 200 in 312 ms. Anda dapat menjalankan tugas secara manual hingga 20 kali per jam, dan setiap proses dihitung ke dalam panggilan hari itu.
| Apa kata hasil proses | Yang perlu dilakukan |
|---|---|
| menjawab 404 | Tidak ada rute di path itu. Periksa ejaannya, dan pastikan versi yang memuat rute tersebut sudah diterbitkan. |
| menjawab 500 | Rute itu sendiri yang gagal. Buka Logs, pilih Requests, dan cari path-nya untuk membaca error. |
| Tidak ada jawaban dalam 30 detik. | Pekerjaan terlalu lama jika dilakukan sekaligus. Minta di studio rute untuk mengerjakan lebih sedikit per panggilan, lalu jalankan lebih sering. |
| Pengalihan tidak diikuti: gunakan alamat akhirnya. | Buka alamat itu di browser, salin alamat tujuan akhirnya, lalu ubah tugasnya ke alamat tersebut. |
| Alamat itu mengarah ke jaringan privat dan tidak dapat dipanggil. | Gunakan alamat publik. Briks tidak pernah memanggil ke jaringan privat. |
Jeda, ubah, atau hapus
Sakelar di samping setiap tugas menjeda tugas (tag Paused muncul) dan menjalankannya lagi. Pada tiga titiknya, Change membuka formulir yang sama, berjudul Change task, dan Delete menghentikan tugas serta menghapus riwayat eksekusinya. Semua ini memerlukan hak edit.
Tampilan Settings memiliki Download JSON, yaitu file berisi nama, jadwal, zona waktu, dan alamat yang dipanggil setiap tugas. Di zona bahayanya ada Clear history (tugas tetap berjalan) dan Delete all (Anda mengetik nama proyek untuk konfirmasi). Keduanya hanya untuk Owner dan Admin.
Contoh kasus
Tambahkan rute di /api/daily-summary yang mengirim email kepada saya berisi permintaan janji temu kemarin dalam satu pesan.
Setelah perubahan dipublikasikan, klinik menambahkan tugas terjadwal bernama Daily summary dengan jadwal 0 7 * * *, zona waktu Europe/London, yang memanggil POST /api/daily-summary. Setiap pagi pukul tujuh, ringkasannya tiba.
Ringkasan dikirim lewat email milik situs itu sendiri, yang nonaktif sampai Anda mengaktifkannya. Lihat Email situs untuk caranya dan untuk jatah bulanannya.
Tambahkan rute di /api/tidy-enquiries yang menghapus pertanyaan yang lebih lama dari 90 hari.
Tugas bernama Tidy enquiries menjalankannya dengan 0 23 * * 0, setiap hari Minggu pukul 23.00. Pada hari Senin, Runs menampilkan Succeeded, dan membuka prosesnya menunjukkan apa yang dibalas oleh route.
Sebelum pembersihan seperti ini dijalankan untuk pertama kali, simpan titik pemulihan di pengaturan tab Database. Jika route menghapus lebih dari yang seharusnya, Anda bisa kembali. Lihat Backups.