Panduan/Untuk developer

Ingin mengirim blast, mengecek laporan, atau membalas pelanggan cukup dengan mengobrol ke asisten AI Anda sendiri (Claude, ChatGPT, Cursor), tanpa membuka portal.

WACO MCP: colokkan WACO ke agen AI Anda lewat Model Context Protocol. Agen bisa menyusun blast dari pesan biasa (WACO yang mengurus template & persetujuan Meta), menunjukkan pratinjau, dan mengirim hanya setelah Anda setuju. 8 menit baca

MCP (Model Context Protocol) adalah cara standar agen AI memakai layanan luar. WACO menyediakan server MCP di https://waco.id/mcp. Anda memasangnya sekali di aplikasi agen, lalu cukup mengobrol: "Kirim ke semua pelanggan berlabel member: Halo {Nama}, promo akhir pekan diskon 20% sampai Minggu." Agen yang mengurus sisanya — dan tidak pernah mengirim sebelum Anda melihat pratinjau dan menyetujuinya.

Yang bisa dilakukan agen

Referensi tools

ToolGunanya
kontak_ringkasJumlah kontak berizin, label beserta jumlahnya, kolom data yang bisa mengisi variabel.
kontak_imporMasukkan daftar pelanggan (nomor, nama, kolom lain) ke buku Kontak dengan satu label.
template_daftarTemplate yang sudah disetujui Meta, untuk dipakai ulang.
blast_siapkanPesan biasa dengan {Nama} → template dibuat & diajukan ke Meta; opsional gambar header lewat URL.
blast_dari_templateSiapkan blast dari template lama yang sudah disetujui.
blast_daftar / blast_statusDaftar blast dan status persetujuan; hitungan antre, terkirim, sampai, dibaca, balas, gagal.
blast_pratinjauPenerima dari label atau nomor, tiga contoh pesan terisi, token 30 menit. Wajib sebelum kirim.
blast_kirimKirim, hanya dengan token pratinjau yang Anda setujui. Maks 5 kali per menit.
blast_penerimaDaftar per orang: siapa gagal (alasan & artinya), terkirim, sampai, dibaca, membalas.
kirim_pesanBalas satu pelanggan dengan teks bebas (jendela 24 jam).
pesan_status / pesan_riwayatStatus satu message ID dari WhatsApp; log 30 hari satu nomor (masuk, status keluar, kiriman API).
Operator AI — mengajari, merapikan, dan menguji bot lewat percakapan (butuh langganan Operator AI; top-up dan otak baru tetap dari dashboard)
asisten_ringkasOtak yang ada, aktif/tidak, jumlah pengetahuan, usulan menunggu, sisa kuota beserta rincian untuk apa kuota terpakai, sakelar akun.
asisten_pengetahuan_daftar / _tambah / _ubah / _hapusKartu pengetahuan: lihat, ajari satu fakta, ubah atau aktifkan draf, hapus.
asisten_pengetahuan_dari_sumberURL website atau teks panjang disuling jadi kartu draf nonaktif — Anda aktifkan yang disetujui.
asisten_pelajari_riwayatBaca riwayat chat tim, hasilnya jadi usulan (bukan kartu langsung).
asisten_usulan_daftar / asisten_usulan_putuskanPertanyaan yang bot serahkan ke manusia beserta jawabannya; terima jadi pengetahuan atau tolak.
asisten_aturNama bot, gaya (ramah/formal/santai), panduan gaya khusus, aktif/nonaktif.
asisten_kanalKanal mana (WhatsApp, live chat, Instagram) yang dijawab bot.
asisten_sakelar_akunFollow-up lead yang diam dan peringatan chat baru ke pemilik.
asisten_ujiTanya bot seolah pelanggan, lihat jawabannya sebelum dinyalakan.

Padanan REST untuk semua tools ada di dokumentasi API (bagian Blast & kontak, Pesan).

Memasang di claude.ai, langkah demi langkah

  1. Buka Settings → Connectors, tekan Add custom connector.
  2. Isi Name: WACO. Isi Remote MCP server URL: https://waco.id/mcp. Claude langsung membaca pengaturan dari server WACO dan menandai beberapa pilihan dengan "Detected".
  3. Authentication: biarkan Always required (yang ditandai Detected). WACO memang mewajibkan login untuk semua tools.
  4. OAuth client: pilih salah satu, keduanya didukung WACO — Use Anthropic's hosted client metadata (disarankan Anthropic, tanpa pendaftaran) atau No client ID — register one automatically (yang ditandai Detected). Jangan pilih Use your own OAuth client.
  5. Additional request headers: kosongkan. Advanced: biarkan.
  6. Tekan Add. WACO muncul di daftar konektor; tekan Connect.
  7. Jendela WACO terbuka: masuk dengan akun portal, lalu tekan Izinkan. Jendela menutup sendiri dan konektor berstatus tersambung.
  8. Coba di obrolan baru: "Berapa kontak WACO saya per label?" — Claude memanggil kontak_ringkas. Di menu Developer portal kini ada kunci bernama "MCP: Claude"; cabut dari sana bila ingin memutus.

ChatGPT: Settings → Connectors (atau Apps) → tambah konektor MCP dengan URL yang sama; login WACO muncul saat pertama dipakai. Langkah lain serupa.

Tools baru tidak muncul? claude.ai menyimpan daftar tools saat konektor tersambung. Setiap kali WACO menambah tool, buka Settings → Connectors → WACO → Disconnect lalu Connect lagi (bila perlu, hapus dan tambahkan ulang), lalu mulai obrolan baru.

Memasang dengan kunci API

Untuk klien yang belum mendukung login OAuth, buat kunci API di portal → Developer. Lalu:

Claude Code (terminal):

claude mcp add --transport http waco https://waco.id/mcp   --header "Authorization: Bearer KUNCI_API_ANDA"

Cursor / Windsurf / klien yang memakai berkas JSON:

{
  "mcpServers": {
    "waco": {
      "url": "https://waco.id/mcp",
      "headers": { "Authorization": "Bearer KUNCI_API_ANDA" }
    }
  }
}

Claude Desktop (lewat jembatan mcp-remote):

{
  "mcpServers": {
    "waco": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://waco.id/mcp",
               "--header", "Authorization: Bearer KUNCI_API_ANDA"]
    }
  }
}

n8n: node MCP Client, transport HTTP Streamable, URL di atas, header Authorization.

Contoh obrolan

  1. "Berapa kontak di label pelanggan-lama?" → agen memanggil kontak_ringkas.
  2. "Kirim ke mereka: Halo {Nama}, layanan Anda diperpanjang otomatis bulan ini. Balas pesan ini bila ada pertanyaan." → agen memanggil blast_siapkan; template diajukan; agen memberi tahu menunggu Meta.
  3. Beberapa menit kemudian: "Sudah disetujui? Kalau sudah, tunjukkan pratinjaunya." → blast_status, lalu blast_pratinjau: 412 penerima, 3 contoh, perkiraan biaya.
  4. "Oke, kirim." → blast_kirim dengan token pratinjau. Selesai; laporan menyusul lewat blast_status.

Mengajari Operator AI lewat agen

Kalau Anda berlangganan Operator AI, agen yang sama bisa mengurus bot Anda tanpa membuka halaman Asisten. Yang paling terasa manfaatnya adalah rutinitas harian: pertanyaan yang bot serahkan ke manusia, beserta jawaban yang tim Anda berikan, ditunggu keputusan Anda satu per satu. Lewat agen, itu jadi obrolan lima menit.

  1. "Apa saja yang kemarin tidak bisa dijawab bot?" → agen memanggil asisten_usulan_daftar dan menunjukkan pertanyaan pelanggan beserta jawaban manusianya, satu per satu.
  2. "Yang nomor 1 dan 3 jadikan pengetahuan, yang nomor 2 buang." → asisten_usulan_putuskan tiga kali. Jawaban yang diterima langsung menjadi kartu pengetahuan aktif.
  3. "Ajari bot: kantor tutup setiap Sabtu dan Minggu, chat dibalas Senin." → asisten_pengetahuan_tambah, satu fakta satu kartu.
  4. "Baca halaman harga di website saya dan jadikan pengetahuan." → asisten_pengetahuan_dari_sumber. Kartunya lahir nonaktif; agen menunjukkan isinya dan Anda memilih mana yang diaktifkan (asisten_pengetahuan_ubah). Tidak ada yang dipelajari diam-diam.
  5. "Coba tanya bot: buka jam berapa?" → asisten_uji. Anda melihat jawaban persis seperti yang akan diterima pelanggan, atau pemberitahuan bahwa bot memilih menyerahkan ke manusia, sebelum apa pun dinyalakan.
  6. "Ubah gayanya lebih santai dan panggil pelanggan 'Kak'." → asisten_atur. Gaya dan pengetahuan sengaja dipisah: gaya adalah cara menjawab, pengetahuan adalah apa yang boleh dijawab.

Yang tetap di dashboard: menambah asisten baru dan top-up kuota, karena keduanya menyangkut tagihan. Sakelar seperti menyalakan bot, memilih kanal, atau follow-up lead diam hanya diubah agen bila Anda memintanya secara jelas.

Kunci API memberi agen hak yang sama dengan Anda di API. Simpan di aplikasi agen pribadi, jangan dibagikan. Pengiriman blast dibatasi 5 kali per menit per kunci dan selalu lewat pratinjau bertoken; tiap pesan dikenai tarif template Meta.
Login konektor memakai OAuth 2.1 dengan PKCE. Tiap aplikasi yang Anda izinkan mendapat kunci sendiri, jadi mencabut Claude tidak memutus ChatGPT. Satu nomor HP/akun bisa mengizinkan beberapa aplikasi.
Masih menemui kendala setelah mengikuti panduan ini? Hubungi kami dari dashboard — sertakan tangkapan layar bila ada, itu mempercepat semuanya.