Documentation/Automation/Troubleshooting
All levelsAutomation Engine v1

Troubleshooting

Checklist cepat ketika command tidak match, session tidak lanjut, menu salah prefix, plugin gagal, media tidak terbaca, atau publish ditolak.

Command tidak berjalan

  1. 01

    Periksa automation Published + Enabled.

  2. 02

    Periksa device scope automation.

  3. 03

    Periksa Bot Command Settings dan trigger prefix inherit/override.

  4. 04

    Untuk all-symbol, pastikan prefix hanya karakter simbol yang valid; emoji tidak dianggap all-symbol prefix.

  5. 05

    Pastikan command tidak collision/reserved Auto Menu.

  6. 06

    Gunakan Test Bench untuk melihat parsed command dan trigger flowName.

Session tidak lanjut

  1. 01

    Periksa SESSION RESULT di Test Bench.

  2. 02

    Pastikan session belum expired.

  3. 03

    Pastikan flow name sama dengan owner session.

  4. 04

    Pastikan input invalid tidak sengaja dikira valid.

  5. 05

    Gunakan `sesi.reset()` untuk mengulang progress tanpa menutup session, atau `sesi.selesai()` untuk benar-benar menutup.

Capability/plugin gagal

  1. 01

    Buka Capabilities dan cek plugin health.

  2. 02

    Pastikan module plugin tersedia di runtime gateway.

  3. 03

    Pastikan `AUTOMATION_PLUGIN_MODULES` benar dan service sudah restart.

  4. 04

    Pastikan capability ID sama persis.

  5. 05

    Jika credential required, cek alias/type/required fields.

  6. 06

    Untuk media, pastikan plugin punya permission media.read/media.write yang sesuai.

Media tidak terbaca

  1. 01

    Periksa sumber `message.media` dan/atau `message.quoted.media`.

  2. 02

    Pastikan tipe receive sesuai: gambar/video/media/file.

  3. 03

    Pastikan inbound ref belum expired dan device socket yang berwenang tersedia.

  4. 04

    Plugin harus memakai media.read(), bukan menganggap ref sebagai filesystem path.

  5. 05

    Plugin output binary harus media.save() sebelum dikembalikan.

Publish ditolak

Baca code diagnostic pertama, lalu cek Flow Inspector/dependency. Error yang umum: target state hilang, command conflict, capability missing, credential missing/type mismatch, integration disabled/missing, invalid receive/input schema, atau loop otomatis.