Documentation/Automation/Recipe: API scan command
IntermediateAutomation Engine v1

Recipe: API scan command

Command yang menerima argumen langsung atau meminta input, memanggil Integration, lalu loop pada session yang sama.

Flow

js
sesi.flow({
  nama: "scan",
  trigger: { command: ["scan"], prefix: { mode: "inherit" } },
  meta: {
    nama: "Cek Data",
    kategori: "Layanan",
    deskripsi: "Pengecekan data melalui API",
    tampilDiMenu: true
  },
  mulai: "input",
  timeout: "30m",
  modeWaktu: "tetap",
  tahap: {
    input: {
      terima: {
        nama: "nomor",
        sumber: ["command.args", "message.text"],
        tipe: "text",
        wajib: true,
        pesanJikaMenunggu: "Masukkan nomor yang ingin dicek."
      },
      integration: {
        nama: "SCAN_API",
        method: "GET",
        path: "/api/scan",
        query: { nomor: "{nomor}" },
        simpanHasil: "hasil",
        gagal: { pesan: "Pengecekan gagal.", ke: "$ulang" }
      },
      kondisi: [
        {
          path: "hasil.metaData.code",
          samaDengan: 200,
          balas: "✅ Data ditemukan. Sisa sesi {sesi.sisaWaktu}",
          ke: "$ulang"
        },
        {
          selainnya: true,
          balas: "❌ Data tidak ditemukan. Kirim nomor lain.",
          ke: "$ulang"
        }
      ]
    }
  }
})

Usage

text
!scan 3273xxxxxxxx
→ langsung process

!scan
→ Bot: Masukkan nomor...
→ User: 3273xxxxxxxx
→ process
→ session tetap aktif untuk scan berikutnya

Processing Feedback

Untuk flow API yang latency-nya terasa, aktifkan Processing Feedback scope `command_session` agar command awal dan input continuation dapat memberi status `sedang memproses` tanpa menulis reply status di setiap state.