Troubleshooting Run
Saat sebuah automation tidak melakukan apa yang diharapkan, Qlar selalu meninggalkan alasan — pada automation itu sendiri (status reason-nya) dan pada setiap run (outcome dan error code-nya). Halaman ini menjelaskan setiap alasan dan apa yang perlu dilakukan.
Anda melihatnya di Monitor (Automations → Monitor → pilih sebuah baris), dan user melihat alasan yang sama, dengan kata-kata yang lebih ramah, di halaman Automations mereka.
Pertanyaan pertama
| Gejala | Periksa |
|---|---|
| "Tidak berjalan." | Status automation. Hanya automation Active yang berjalan. Lalu waktu Next run, dan apakah switch policy menyala. |
| "Berjalan tapi saya tidak menerima apa-apa." | Condition run tersebut — Condition not met itu normal. Lalu kolom Actions untuk action yang gagal atau di-skip. |
| "Berjalan terlambat." | Run bisa mulai semenit atau lebih setelah waktunya, dan lebih lama lagi bila banyak yang jatuh tempo bersamaan. Pertimbangkan menjadwalkannya beberapa menit lebih awal. |
| "Berhenti sendiri." | Status reason — lihat tabel pertama di bawah. |
| "Agent tidak menawarkan untuk membuatnya." | User harus sudah sign in, di luar CMS preview, dan policy harus on dengan Create automations diizinkan. |
Mengapa automation berada di statusnya
| Reason (Monitor) | Status | Artinya | Yang perlu dilakukan |
|---|---|---|---|
| Paused by its creator | Paused | User mem-pause-nya. | Tidak ada. Mereka bisa me-resume-nya. |
| Paused by a contributor | Paused | Seseorang di tim Anda mem-pause-nya di Monitor. | Resume dari Monitor bila sudah siap. |
| Disabled by a contributor | Turned off | Seseorang di tim Anda men-disable-nya. User tidak bisa me-resume atau mengeditnya. | Resume dari Monitor, atau user bisa menghapusnya. |
| Paused: more active automations than the policy allows | Paused | Anda menurunkan Maximum Active Automations. Yang terbaru di atas batas di-pause. | Naikkan batasnya, atau minta user menghapus beberapa. |
| Paused: the agent moved to another organization | Paused | Agent di-transfer. | User me-resume yang masih mereka butuhkan, setelah memeriksanya. |
| Stopped after repeated failures | Stopped | Tiga run gagal berturut-turut. | Periksa history untuk penyebabnya (di bawah), perbaiki, lalu resume. |
| Stopped: runs more often than the policy allows | Stopped | Anda menaikkan Minimum Interval di atas jadwalnya. | User mengedit jadwal, lalu resume. |
| Stopped: its trigger is no longer allowed | Stopped | Jenis trigger dihapus dari Allowed Triggers. | Izinkan kembali, atau user membuatnya ulang. |
| Stopped: none of its actions is allowed any more | Stopped | Semua action-nya dihapus dari Allowed Actions. | Izinkan kembali sebuah action, atau user mengeditnya. |
| Stopped: its creator lost access to the agent | Stopped | User keluar dari organization atau kehilangan akses ke agent. | Pulihkan aksesnya, atau hapus automation tersebut. |
| Stopped: its content could not be read | Stopped | Konten terenkripsi tidak tersedia (Privacy Mode). | Minta user membuatnya ulang. |
| Its schedule has finished | Finished | Run sekali sudah terjadi, atau end date sudah lewat. | Tidak ada. Dihapus setelah 7 hari. |
| Reached the policy's limit of runs | Finished | Maximum Runs per Automation tercapai. | Naikkan batasnya, atau user membuat yang baru. |
Setelah penyebabnya Anda perbaiki, gunakan Resume di Monitor (bila Anda boleh mengelola automation) atau minta user me-resume dari halaman mereka. Resume memeriksa policy lagi, sehingga akan ditolak bila penyebabnya masih ada.
Mengapa sebuah run gagal atau di-skip
Setiap run di history menampilkan salah satu kode berikut.
Policy dan batas
| Kode | Artinya | Yang perlu dilakukan |
|---|---|---|
| Automations are switched off in the policy | Master switch mati. Run di-skip, tidak hilang. | Nyalakan kembali. |
| Trigger not allowed by the policy / No action allowed by the policy | Policy Anda tidak lagi mengizinkannya. | Sesuaikan policy. |
| Runs more often than the policy allows | Interval di bawah Minimum Interval. | User mengedit jadwal. |
| User's daily run quota reached | Maximum Runs per User per Day sudah habis. | Naikkan, atau minta user mengurangi frekuensi run mereka. |
| Run limit reached | Maximum Runs per Automation tercapai. | Naikkan batasnya. |
Credit dan budget
| Kode | Artinya | Yang perlu dilakukan |
|---|---|---|
| Organization credit exhausted | Credit tidak cukup untuk menjalankan. | Beli credit atau atur auto top-up. |
| Member budget or agent limit reached | Budget user untuk agent ini, atau limit agent itu sendiri, sudah habis. | Naikkan budget atau limit agent. |
Run itu sendiri
| Kode | Artinya | Yang perlu dilakukan |
|---|---|---|
| Timed out | Run memakan waktu lebih lama dari Run Timeout. | Naikkan timeout, atau sederhanakan task atau condition. |
| The agent's run failed | Agent tidak bisa menyelesaikannya. Kegagalan sementara di-retry otomatis. | Periksa Monitoring Logs. Jika tool Anda sedang bermasalah, perbaiki. |
| A selected skill is no longer available | Skill yang dipakai automation dihapus. Run dilanjutkan tanpa skill itu. | Pulihkan skill-nya, atau user mengedit automation. |
| Content could not be read | Konten terenkripsi tidak tersedia. | Minta user membuatnya ulang. |
| Agent not found | Agent dihapus atau di-unpublish. | Pulihkan atau publish ulang. |
| Creator no longer has access | User kehilangan akses ke agent. | Pulihkan aksesnya. |
Waktu
| Kode | Artinya | Yang perlu dilakukan |
|---|---|---|
| Skipped: started too late | Automation memakai Skip sebagai missed-run policy dan tidak bisa mulai tepat waktu. | Ubah missed-run policy-nya, atau tunggu run berikutnya. |
| Superseded by a newer schedule | User mengeditnya dan run yang lebih baru menggantikan yang ini. | Tidak ada — ini wajar. |
| Abandoned | Run terputus sebelum selesai. | Tidak ada, kecuali berulang. |
| Paused platform-wide | Qlar mem-pause semua automation sejenak. | Tidak ada. Run berlanjut kembali. |
| Kode | Artinya | Yang perlu dilakukan |
|---|---|---|
| Invalid WhatsApp number | Nomor itu tidak mungkin nomor telepon yang valid. | User memperbaikinya. |
| Daily WhatsApp limit reached | Maximum WhatsApp Messages per Day sudah habis. | Naikkan batasnya. |
| WhatsApp rate limit reached | Terlalu banyak pesan dikirim ke nomor ini dalam satu jam. Qlar mencoba lagi nanti. | Tidak ada. |
| No WhatsApp sender available | Nomor WhatsApp platform sedang offline. | Coba lagi nanti; hubungi support bila berlanjut. |
| WhatsApp rejected the message | WhatsApp menolaknya. | Pastikan nomor tersebut bisa menerima pesan WhatsApp. |
| WhatsApp send failed | Pesan tidak bisa dikirim. | Awalnya tidak ada; pesan akan di-retry. |
| WhatsApp outcome unknown | Qlar tidak bisa memastikan apakah pesan sampai. Pesan tidak di-retry, untuk menghindari duplikat. | Tanyakan kepada user apakah pesan sampai. |
Retry
Kegagalan sementara — misalnya AI provider yang sedang sibuk — di-retry hingga Maximum Retries kali, dengan jeda Retry Interval menit di antara percobaan. Setiap percobaan adalah baris tersendiri di history, ditandai Retry. Pesan WhatsApp tidak pernah dikirim dua kali, dan run yang belum sampai ke tahap pengiriman aman untuk di-retry.
Tiga run berturut-turut yang gagal setelah semua retry menghentikan automation (Stopped after repeated failures). Satu keberhasilan mereset hitungannya.
Masih buntu?
Minta nama automation dan waktu seharusnya ia berjalan kepada user, temukan di Monitor, dan baca history-nya. Jika history tidak menunjukkan apa pun pada waktu itu, periksa apakah automation berstatus active dan policy menyala saat itu. Untuk hal di halaman ini yang tidak bisa Anda selesaikan, hubungi support Qlar dengan menyertakan nama automation dan waktu run-nya.