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.
Contoh-contohnya memakai automation yang dibuat Rina Wijaya, operations lead Kirana, di chat Atlas: KG-2041 delay / on-hold check, yang berjalan setiap hari kerja pukul 07.30 (Asia/Jakarta) dan mengirim ringkasan hanya bila proyek KG-2041 terlambat (delayed) atau ditahan (on hold).
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.
Sebelum memulai
- Anda bisa membuka Monitor. Lihat Memantau & Mengelola.
- Anda sudah mengenal status dan hasil run yang dijelaskan di Cara Kerja Automation.
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. Pada hari ketika KG-2041 berjalan sesuai rencana, pengecekan Rina berakhir seperti ini dan tidak membuat conversation. Lalu kolom Actions untuk action yang gagal atau di-skip. |
| "Saya menerima ringkasan padahal proyek berjalan sesuai rencana." | Condition tidak bisa dicek, misalnya karena status proyek tidak tersedia. Dalam kasus itu hasilnya tetap dikirim, seperti yang disebutkan di automation preview. Setelah tiga run seperti itu berturut-turut, user menerima notifikasi Warning. Pastikan tool atau sumber data yang dipakai agent untuk status proyek berfungsi. |
| "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 bilang email tidak tersedia." | Apakah Send email dicentang di Allowed Actions pada policy. Policy yang disimpan sebelum fitur email ada belum mencentangnya sampai Anda mencentang lalu menyimpannya. Jika sudah dicentang, pengiriman email mungkin sedang tidak tersedia di platform. |
| "Agent menolak automation email saya." | Alasan yang disebutkan agent. Paling sering alamatnya bukan satu alamat yang valid, atau automation milik user tersebut secara total bisa mengirim lebih dari 10 email per jam ke alamat itu; jadwal yang lebih jarang menyelesaikan yang kedua. |
| "Agent tidak menawarkan untuk membuatnya." | User harus sudah sign in, di luar CMS preview, dan policy harus on dengan Create automations diizinkan. CMS preview tidak pernah menawarkan automation, jadi uji di chat publik agent. |
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 | Nomor ini, atau nomor WhatsApp agent secara keseluruhan, sudah mencapai batas pesan automation per jam (10 per jam ke satu nomor, 30 per jam seluruhnya). Qlar mencoba lagi pada jam berikutnya. | Tidak ada. |
| No WhatsApp channel that can send (needs the public or private server) | Published configuration agent tidak punya channel WhatsApp di public atau private server, atau channel-nya dimatikan. Meta Cloud, Coster, dan Qontak hanya bisa memulai percakapan dengan template yang sudah disetujui. Tidak di-retry. | Hubungkan nomor di public atau private server lewat Channels > WhatsApp, Published configuration, atau nyalakan kembali channel-nya. |
| Agent's WhatsApp channel not connected | Nomor WhatsApp agent sedang tidak tertaut, misalnya karena ponselnya logout. Qlar mencoba lagi nanti. | Periksa channel di Channels > WhatsApp dan tautkan ulang bila perlu. |
| Number not allowed by the WhatsApp channel's contact rules | Channel dalam mode privat dan nomor ini tidak ada di daftarnya, atau nomor itu diblokir. Tidak di-retry. | Izinkan nomor itu di kontak channel, atau minta user memakai nomor lain. |
| No WhatsApp sender available | Hanya muncul pada run sebelum 7 Oktober 2026, saat hasil masih dikirim dari nomor bersama milik platform. | Tidak ada. |
| WhatsApp rejected the message | WhatsApp menolaknya. | Pastikan nomor tersebut bisa menerima pesan WhatsApp. |
| WhatsApp send failed | Pesan tidak bisa diserahkan ke WhatsApp. Pesan tidak di-retry, karena bisa jadi sudah terkirim. | Tanyakan kepada user apakah pesan sampai; periksa channel WhatsApp agent bila berulang. |
| WhatsApp outcome unknown | Qlar tidak bisa memastikan apakah pesan sampai. Pesan tidak di-retry, untuk menghindari duplikat. | Tanyakan kepada user apakah pesan sampai. |
Email tidak pernah di-retry otomatis, sehingga tidak mungkin sampai dua kali. Apa pun masalahnya, run terjadwal berikutnya mengirim seperti biasa.
| Kode | Artinya | Yang perlu dilakukan |
|---|---|---|
Email sending is not available (email_not_configured) | Pengiriman email sedang tidak tersedia di platform. | Tidak ada yang perlu Anda lakukan; action lain di run itu tetap berjalan. Hubungi support Qlar bila terus berlanjut. |
Daily email limit reached (email_daily_cap) | Maximum Emails per Day agent, atau batas harian platform sendiri, sudah habis. | Naikkan Maximum Emails per Day di policy. Jika batas agent belum tercapai, tunggu hari berikutnya. |
Email service busy (email_rate_limited) | Layanan email sedang kewalahan sesaat dan tidak menerima email tersebut. | Tidak ada. Run berikutnya mengirim seperti biasa. |
Email address refused (email_rejected) | Layanan email menolak alamat atau pesannya, misalnya alamat yang tidak ada. | Cek alamatnya bersama user; user memperbaikinya di halaman Automations atau dengan meminta kepada agent. |
Email could not be sent (email_failed) | Pengiriman gagal karena sebab lain, misalnya gangguan jaringan. Email tidak di-retry, karena bisa jadi sudah terkirim. | Tanyakan kepada user apakah email sampai, termasuk di folder spam. Hubungi support Qlar bila berulang. |
Invalid email address (email_recipient_invalid) | Alamat yang tersimpan bukan satu alamat email yang valid. | User memperbaikinya. |
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 atau email tidak pernah dikirim dua kali, dan run yang belum sampai ke tahap pengiriman aman untuk di-retry. Setiap action ditangani sendiri-sendiri: email tidak pernah dicoba lagi, sedangkan pesan WhatsApp di run yang sama yang harus menunggu, misalnya sampai jam berikutnya, tetap terkirim belakangan.
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. Misalnya, Rina mengatakan ia tidak menerima apa-apa pada Selasa pagi: cari KG-2041 delay / on-hold check di Monitor dan baca run pukul 07.30 hari itu. Condition not met berarti proyek berjalan sesuai rencana; kegagalan menampilkan kodenya dari tabel di atas. 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.
Periksa hasilnya
- Setelah penyebabnya diperbaiki, buka automation tersebut di Monitor (Automations → Monitor, pilih barisnya). Jika berstatus Stopped atau Paused, klik Resume. Resume memeriksa policy lagi dan ditolak bila penyebabnya masih ada.
- Minta user mengklik Run now di halaman Automations miliknya, atau tunggu run terjadwal berikutnya.
- Di Execution history, run baru menampilkan Succeeded, dengan condition Met atau Not met dan, bila terpenuhi, setiap action berstatus terkirim. Untuk pengecekan Rina, itu adalah Create conversation: Sent.
Langkah berikutnya
- Berikutnya dalam alur: Menyempurnakan Kualitas Jawaban, untuk meningkatkan jawaban yang dihasilkan agent Anda (dan automation-nya).
- Help → Monitor: setiap field halaman Monitor.