Dokumentasi

Semua yang Anda perlukan untuk mengintegrasikan KiZE Halo. Referensi teknis lengkap ada di repositori, pada docs/.

Mulai cepat

  1. Daftarkan ruang kerja di /register. Pengguna pertama menjadi pemilik ruang kerja.
  2. Pilih paket di halaman tagihan. Uji coba gratis sudah dipilih.
  3. Tambahkan akun WhatsApp. Worker akan ditetapkan otomatis.
  4. Pindai QR yang bergilir di dasbor.
  5. Kirim pesan pertama Anda melalui dasbor atau REST API.

Autentikasi

Request dasbor menggunakan cookie sesi HttpOnly. Panggilan antarmesin menggunakan API key dengan scope sebagai bearer token. Key ditampilkan sekali saat dibuat, dan hanya hash SHA-256-nya yang disimpan.

curl https://api.wazera.dev/api/whatsapp \
  -H "Authorization: Bearer waz_live_…"

Mengirim pesan

Pengiriman bersifat asinkron. API memvalidasi, menerapkan entitlement dan kuota, menyimpan pesan beserta perintah pengiriman, lalu mengembalikan HTTP 200 dengan status SUBMITTED. Gunakan Idempotency-Key yang sama saat mengulangi request yang hasilnya belum diketahui.

POST /api/whatsapp/{accountId}/messages
Authorization: Bearer <api-key>
Idempotency-Key: <unique-request-id>
Content-Type: application/json

{ "kind": "text", "to": "628123456789", "text": "Halo!" }

WebSocket realtime

// Browser memakai cookie sesi HttpOnly dari login.
const ws = new WebSocket("wss://api.wazera.dev/ws");
ws.addEventListener("open", () => {
  ws.send(JSON.stringify({ op: "subscribe", channel: "tenant:<uuid>" }));
  ws.send(JSON.stringify({ op: "subscribe", channel: "whatsapp:<accountId>" }));
});
ws.addEventListener("message", ({ data }) => {
  const message = JSON.parse(data);
  // Muat ulang snapshot setelah langganan tersambung kembali.
  // Tangani event domain dan deduplikasi menurut event.id.
});

Memverifikasi signature webhook

const expected = "v1=" + hmac_sha256(secret, timestamp + "." + rawBody);
// Bandingkan dengan X-Wazera-Signature menggunakan perbandingan waktu konstan.
// Tolak timestamp kedaluwarsa dan event_id yang sudah diproses.

KiZE Halo menggunakan implementasi WhatsApp Web tidak resmi. KiZE Halo tidak berafiliasi dengan atau didukung oleh Meta. Ketersediaan dan keamanan akun tidak dapat dijamin. Tinjau ketentuan kami sebelum penggunaan produksi.