Lewati ke isi
CSWA.AIDocs

API & Webhook: membuat kunci API

Buat kunci API di Integrasi › API & Webhook, salin sekali, lalu kirim pesan WhatsApp pertama dari sistem Anda.

± 4 menit

Kunci API membuat sistem Anda (CRM, toko, server) bisa mengirim & membaca pesan WhatsApp CSWA.AI lewat REST API. Alamat dasar API: https://api.cswa.ai/v1.

Sebelum mulai

  • Izin peran: Integrasi › Kelola (pemilik & admin otomatis punya).
  • Minimal satu nomor WhatsApp terhubung di Profil (WA Device atau WhatsApp API Official).
  • Paket All Access aktif. Selama masa coba hanya kunci test (simulasi) yang bisa dibuat.

Langkah#

  1. Langkah 1: Buka API & Webhook

    Buka API & Webhook (kelompok Developer). Kartu Mulai dalam 3 langkah menampilkan alamat dasar API dan tombol salinnya.

    ① Mulai dalam 3 langkah. ② Tab Kunci API. ③ Buat kunci.

    API & Webhook: kartu Mulai dalam 3 langkah, tab Kunci API, dan tombol Buat kunci

  2. Langkah 2: Buat kunci

    Tab Kunci API › Buat kunci. Isi Nama (mis. CRM Kopi Senja), pilih Mode (Produksi (kirim sungguhan) atau Test (simulasi)), dan centang Izin yang diperlukan saja.

  3. Langkah 3: Atur pengaman (opsional)

    Isi Batasi IP (satu IP/CIDR per baris), pilih Masa berlaku (Tanpa batas, 30 hari, 90 hari, 1 tahun), dan centang AI Agent tetap aktif bila kunci hanya mengirim notifikasi. Klik Buat kunci.

  4. Langkah 4: Salin kunci sekarang

    Kunci (berawalan cswa_live_ atau cswa_test_) hanya tampil sekali. Salin dan simpan di variabel lingkungan server Anda — jangan di kode sisi browser.

  5. Langkah 5: Kirim pesan pertama

    Salin contoh curl di kartu Mulai dalam 3 langkah, ganti kunci & nomor tujuan, lalu jalankan. Kunci selalu dikirim di header Authorization: Bearer ….

    Kirim pesan pertama (curl)

    curl -X POST "https://api.cswa.ai/v1/messages" \ -H "Authorization: Bearer cswa_live_KUNCI_ANDA" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{"to":"6281234567890","type":"text","text":{"body":"Halo! Pesan pertama dari API 👋"}}'

Hasilnya#

Kunci tampil di daftar Kunci API dengan label Produksi/Test, status Aktif, kapan terakhir dipakai, dan masa berlakunya. Pesan dari API muncul di Chat seperti pesan tim.

Terhubung dengan fitur lain#

  • Bawaan: AI Agent berhenti di percakapan yang dikirimi pesan lewat kunci (seperti saat CS membalas), kecuali “AI Agent tetap aktif” dicentang.
  • Terima pesan masuk & status secara langsung — API & Webhook: mengatur webhook.
  • Referensi semua rute & jenis pesan — Panduan API dan Referensi API.
  • Maks. 20 kunci aktif per Profil.

Masalah umum#

Lupa menyalin kunci
Kunci tidak bisa ditampilkan lagi. Pakai Rotasi (kunci baru, izin sama, kunci lama langsung mati) atau buat kunci baru.
Pilihan Produksi tidak bisa dipilih
Profil masih masa coba: tertulis “Produksi (setelah berlangganan)”. Berlangganan All Access untuk kunci produksi.
Izin abu-abu
“Tidak termasuk paket Profil ini” — fiturnya (mis. WhatsApp API Official untuk Template) belum tersedia di Profil.
Galat 401
Kunci tidak ada, salah, dicabut, atau kedaluwarsa. Kunci yang ditaruh di URL ditolak (400) — kirim hanya di header Authorization. Daftar kode: Galat API.

Terkait#