Panduan Memulai Kirem (Quickstart)

Selamat datang di Kirem Developer Platform! Panduan ini dirancang untuk membantu Anda melakukan integrasi awal secara cepat, mulai dari persiapan nomor WhatsApp Business, pembuatan proyek di Kirem, hingga pengaturan pembayaran di Meta agar API Anda siap digunakan untuk lingkungan produksi (production-ready).

🛠️ Langkah 1: Persiapan & Pendaftaran Nomor WhatsApp Business

Sebelum menghubungkan nomor ke Kirem, pastikan nomor Anda memenuhi persyaratan teknis dari Meta:

1. Persyaratan Nomor: Nomor harus dapat menerima SMS atau Panggilan Suara untuk proses verifikasi kode OTP dari Meta.
2. Penghapusan Akun WhatsApp Ponsel (Penting):
   • Jika nomor tersebut saat ini terdaftar di aplikasi WhatsApp Messenger (Personal) atau WhatsApp Business di ponsel pintar Anda, Anda wajib menghapus akun tersebut terlebih dahulu.
   • Cara Menghapus: Buka aplikasi WhatsApp di ponsel > Pengaturan (Settings) > Akun (Account) > Hapus Akun Saya (Delete My Account).
   • Catatan: Proses ini akan menghapus riwayat pesan lama Anda. Satu nomor tidak bisa aktif di aplikasi ponsel biasa dan WhatsApp Cloud API secara bersamaan.

📁 Langkah 2: Membuat Proyek Pertama di Kirem

1. Masuk ke Dasbor Pengembang Kirem.
2. Klik tombol Buat Proyek Baru (Create New Project).
3. Isi nama proyek Anda (misalnya: Notifikasi Transaksi e-Commerce).
4. Proyek baru Anda akan otomatis menghasilkan Project ID yang unik. Proyek ini akan menjadi wadah isolasi data tenant Anda.

🔗 Langkah 3: Menghubungkan Nomor WhatsApp via Onboarding

Setelah proyek siap, saatnya menghubungkan nomor WhatsApp Anda ke Kirem menggunakan proses Meta Embedded Signup:

1. Di dasbor Kirem, masuk ke menu Channels (Saluran) dan klik Hubungkan Nomor Baru.
2. Jendela pop-up integrasi Meta resmi akan muncul. Silakan login menggunakan akun Facebook pribadi Anda yang memiliki hak akses Admin pada Meta Business Manager Anda.
3. Pilih Portofolio Bisnis Meta: Pilih akun Business Manager Anda yang sudah ada, atau buat baru di tempat jika belum memiliki.
4. Isi Profil WhatsApp Business:
   • Nama Tampilan (Display Name): Nama yang akan terlihat oleh pelanggan Anda di WhatsApp (harus sesuai dengan nama merek bisnis resmi Anda).
   • Kategori & Deskripsi Bisnis: Pilih industri bisnis Anda dan tulis deskripsi singkat.
5. Verifikasi Nomor:
   • Masukkan nomor telepon bisnis Anda (pilih kode negara Indonesia +62 dan masukkan nomor tanpa angka 0 di depan).
   • Pilih metode verifikasi (SMS atau Panggilan Suara).
   • Masukkan 6 digit kode OTP yang dikirimkan oleh Meta.
6. Klik Selesai. Status nomor Anda di dasbor Kirem akan langsung berubah menjadi Connected.

💳 Langkah 4: Mengatur Metode Pembayaran di Meta (Billing)

Secara default, Meta memberikan kuota 1.000 percakapan pelayanan pelanggan (Service Conversations) gratis setiap bulan untuk setiap nomor. Namun, jika Anda ingin mengirim pesan bertipe promosi (Marketing) atau kuota gratis Anda habis, Meta akan memblokir pengiriman pesan Anda sampai Anda menambahkan kartu pembayaran.

Cara Menambahkan Metode Pembayaran di Facebook Business Manager:

1. Masuk ke dasbor Meta Business Manager Anda.
2. Buka menu Setelan Bisnis (Business Settings) > Akun WhatsApp (WhatsApp Accounts).
3. Pilih nama Akun WhatsApp Business Anda dari daftar.
4. Buka tab Pengaturan Pembayaran (Payment Settings), lalu klik Buka Pengaturan Pembayaran (Open Payment Settings).
5. Klik Tambahkan Metode Pembayaran (Add Payment Method).
6. Masukkan kartu Kredit atau Debit (pastikan kartu Anda mendukung transaksi online internasional dan memiliki saldo yang cukup untuk proses otorisasi nominal kecil oleh Meta).
7. Simpan. Tagihan pemakaian WhatsApp API Anda kini akan didebit langsung dari kartu tersebut secara berkala oleh Meta.

🔑 Langkah 5: Membuat API Key Pertama Anda

1. Di dasbor Kirem, buka menu Settings > API Keys.
2. Klik tombol Generate Key.
3. Berikan nama penanda (misal: Server Notifikasi Utama).
4. (Rekomendasi Keamanan): Masukkan IP address server Anda di kolom IP Whitelist agar API Key ini hanya bisa digunakan dari server Anda sendiri.
5. Klik Simpan dan salin API Key yang dihasilkan (diawali dengan kd_live_).

🛜 Langkah 6: Mengonfigurasi Webhook

Webhook digunakan untuk mendengarkan aktivitas pengiriman secara real-time (seperti laporan pesan terkirim, dibaca, atau pesan masuk baru dari pelanggan).

1. Buka menu Settings > Webhooks di dasbor Kirem.
2. Klik Tambah Webhook.
3. Isi URL Penerima (misalnya: https://api.domainanda.com/webhooks/kirem).
4. Pilih event yang ingin dipantau, contoh: messages.received (pesan masuk) dan messages.status (status centang abu-abu/biru).
5. Kirem akan men-generate Secret Key untuk verifikasi HMAC. Salin kunci rahasia ini untuk memvalidasi tanda tangan header X-Signature di server Anda.

🚀 Langkah 7: Mengirim Pesan Pertama (API Call)

Setelah seluruh konfigurasi di atas selesai, Anda dapat langsung melakukan pengujian pengiriman pesan pertama menggunakan cURL dari terminal Anda:

curl -X POST https://api.kirem.id/v1/messages \
  -H "Authorization: Bearer kd_live_your_actual_key" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "62812345678",
    "type": "text",
    "text": {
      "body": "Halo! Ini adalah pesan uji coba pertama saya menggunakan Kirem API."
    }
  }'

Jika respons mengembalikan status 201 Created, selamat! Integrasi awal Kirem Anda telah berhasil.