Saya ingin bot AI menjawab pelanggan di aplikasi saya sendiri

Operator AI yang menjawab percakapan di ruang percakapan WACO juga tersedia sebagai API murni: aplikasi Anda mengirim pesan pelanggan, kami mengembalikan jawaban dari pengetahuan yang Anda ajarkan, atau berkata jujur bahwa ia tidak tahu. Kanalnya (WhatsApp Anda sendiri, live chat website, Telegram, apa pun) tetap sepenuhnya milik Anda.

Minta balasan

POST https://waco.id/api/v1/asisten/balas
Authorization: Bearer waco_xxxx

{ "sesi": "cust-8812", "teks": "kalau hari minggu buka nggak?" }

→ 200 { "jawab": true,  "teks": "Kami buka Senin, Sabtu 08.00–17.00, Minggu tutup." }
→ 200 { "jawab": false, "alasan": "di_luar_pengetahuan" }

sesi adalah ID percakapan versi Anda, pakai apa pun yang konsisten per pelanggan. Untuk konteks percakapan berlanjut, sertakan riwayat: larik {"peran":"pelanggan"|"bot","teks":"..."} (maksimal 10 terakhir yang dipakai).

Kelola pengetahuan

GET    /api/v1/asisten/pengetahuan            → { "kartu": [...] }
POST   /api/v1/asisten/pengetahuan
       { "judul": "Jam buka", "isi": "Senin, Sabtu 08.00–17.00." }   → kartu baru (aktif)
       { "id": 12, "isi": "...", "aktif": true }                     → ubah kartu
       { "url": "https://situs-anda.com/faq" }                       → sulingkan jadi kartu draf
DELETE /api/v1/asisten/pengetahuan/:id

Kartu dari url masuk sebagai draf nonaktif: tinjau lalu aktifkan (dari portal atau POST {"id":…,"aktif":true}). Bot tidak pernah memakai pengetahuan yang belum Anda setujui.

Cek sisa kuota

GET /api/v1/asisten/pemakaian
→ { "aktif": true, "terpakaiIdr": 12500, "kuotaBulananIdr": 50000,
    "topupIdr": 0, "sisaIdr": 37500, "percakapanAktif": 1, "batasBersamaan": 5 }

Kuota bulanan sudah termasuk langganan dan direset tiap bulan; top-up berlaku 30 hari sejak dibeli. Saat kuota habis bot berhenti menjawab (jawab:false), percakapan mengalir ke tim Anda, layanan tidak pernah putus.

Contoh integrasi (Node.js), pola serah-terima yang benar

async function balasPelanggan(idPercakapan, pesanPelanggan) {
  const r = await fetch('https://waco.id/api/v1/asisten/balas', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Authorization: 'Bearer ' + process.env.WACO_API_KEY,
    },
    body: JSON.stringify({ sesi: idPercakapan, teks: pesanPelanggan }),
  });
  const j = await r.json();

  if (j.jawab) {
    await kirimKePelanggan(idPercakapan, j.teks);      // kanal Anda sendiri
  } else {
    // WAJIB: apa pun alasannya, manusia mengambil alih.
    await tandaiButuhManusia(idPercakapan);
    await beriTahuTim(idPercakapan, 'Bot menyerahkan: ' + j.alasan);
  }
}

Versi PHP/Laravel, Python, atau Go tinggal menerjemahkan pola yang sama: satu POST, satu percabangan jawab. Yang tidak boleh: menampilkan "maaf saya tidak tahu" ke pelanggan lalu berhenti. jawab:false artinya orang yang melanjutkan.