REST & TypeScript SDK
Untuk notifikasi transaksi dari sistemmu. SDK menyediakan builder pesan, retry, dan pagination.
Satu pesan, lima cara mengirimnya. Pilih yang cocok dengan stack-mu.
Kirim notifikasi pesanan dari backend dengan REST atau TypeScript SDK, coba dulu dari terminal dengan CLI, sambungkan ke Claude atau Cursor lewat MCP, atau rangkai tanpa kode di n8n. Hasilnya kembali ke servermu lewat webhook.
“Script notifikasi kami retry saat timeout, akhirnya pelanggan dapat pesan “pesanan dikirim” tiga kali.”
WKirim dengan Idempotency-Key. Request yang diulang dengan key sama tidak membuat pesan baru. SDK membuatnya otomatis.
5 cara integrasi: REST, TypeScript SDK, CLI, MCP, dan n8n
28 jenis event webhook: pesan, CRM, dan commerce
8 tool MCP untuk Claude, Cursor, dan assistant lain
180/menit batas panggilan MCP per organisasi
01Coba sendiri
Kirim satu pesan, lalu ikuti event yang kembali.
Ganti tab untuk melihat aksi yang sama di setiap cara integrasi. Tekan Jalankan, lalu klik tiap event webhook untuk melihat header dan isinya. Tekan sekali lagi untuk melihat cara kerja idempotency.
kirim.ts
import { WazapinClient, textMessage } from "@wazapin/sdk";
const wazapin = new WazapinClient({
apiKey: process.env.WAZAPIN_API_KEY!,
});
// Idempotency-Key dibuat otomatis, jadi retry tidak dobel kirim.
await wazapin.messages.send(
textMessage({
channel_id: "ch_01h2",
to: "6281234567890",
body: "Pesanan #1042 sudah dikirim 🚚",
}),
);Webhook ke server kamu0 event
Tekan Jalankan untuk melihat event yang dikirim balik setelah pesan terkirim.
Struktur request dan contoh payload diambil dari kontrak API. ID-nya contoh.
02Lima menit pertama
Dari API key sampai pesan pertama.
- 01
Buat API key
Di Pengaturan → API key. Key diawali wzp_ dan dikirim lewat header X-Api-Key atau Authorization: Bearer.
- 02
Pasang SDK atau CLI
@wazapin/sdk untuk backend, atau @wazapin/cli untuk mencoba dari terminal. CLI login lewat OAuth device flow, tanpa menyalin key.
- 03
Kirim dengan dry-run dulu
CLI menampilkan request tanpa mengirim. Setelah yakin, hapus --dry-run.
- 04
Daftarkan webhook
Pilih event yang dibutuhkan, rotasi secret kapan saja, kirim event uji, dan lihat daftar pengiriman beserta tombol kirim ulang.
03Referensi singkat
Yang biasanya ditanyakan developer.
- Base URL
- https://api.wazapin.com
- Autentikasi
- API key (wzp_…), personal token, atau OAuth untuk aplikasi pihak ketiga.
- Kirim pesan
- POST /v1/messages dengan channel_id, to, type, dan content. Tipe: teks, template, gambar, video, audio, dokumen, lokasi, tombol, dan list.
- Idempotency
- Header Idempotency-Key. SDK hanya me-retry POST yang punya key, jadi retry tidak dobel kirim.
- Webhook
- Dikirim lewat Svix. Jenis event ada di header svix-event-type, body datar. Verifikasi dengan verifyWebhook() dari @wazapin/sdk/webhooks.
- MCP
- https://api.wazapin.com/mcp dengan scope mcp:read, mcp:write, dan mcp:destructive. Batas 180 panggilan per menit per organisasi.
04Pilih jalurmu
Tiap cara punya tempatnya.
CLI
Kelola channel, pesan, kontak, dan template dari terminal dengan output JSON. Bisa dijalankan sebagai server MCP.
MCP
Claude atau Cursor bisa membaca percakapan, mengirim pesan, menandai dibaca, dan mengelola webhook.
n8n
Node aksi untuk mengirim teks, media, template, tombol, list, CTA, lokasi, dan polling, serta node trigger yang menyaring event webhook.
Webhook
Pesan masuk, status terkirim dan dibaca, percakapan, kontak, status template, 20 event CRM, dan perubahan order.
Scope MCP
Pisahkan akses baca, tulis, dan aksi yang menghapus untuk setiap token yang dipakai AI.
Bab 1 dari 8 · Cerita Toko Rina
Semua dimulai dari iklan Rina di Instagram.
Ayu menekan Kirim Pesan. Sejak detik itu, Wazapin tahu dari iklan mana dia datang, dan tetap ingat saat dia membayar.
ChatOrderTagih
3 langkah biar chat beres sampai lunas
Lihat gimana Wazapin beresin chat sampai duit masuk.
Ikutin chat asli: dari sapa pertama sampai bayar dan kamu ingetin lagi.