API Chatera
Panduan resmi REST API Chatera untuk integrator yang ingin menyambungkan sistem internal ke Chatera.
API Chatera memungkinkan kamu mengintegrasikan sistem internal (CRM, ERP, POS, custom backoffice) ke platform Chatera. Dengan API ini kamu bisa:
- Mengirim pesan WhatsApp otomatis dari sistem kamu (notifikasi order, OTP, reminder pembayaran).
- Sinkronisasi data kontak dua arah.
- Mengirim template WhatsApp untuk komunikasi di luar jendela 24 jam.
- Menerima webhook ketika ada pesan masuk, status berubah, atau percakapan baru dibuka.
API ini cocok untuk:
- Tim engineering customer yang membangun integrasi internal.
- Vendor / system integrator yang menyediakan solusi end-to-end ke perusahaan pengguna Chatera.
- Aplikasi pihak ketiga yang ingin melakukan otomatisasi komunikasi.
Bukan untuk integrasi UI
Halaman ini berisi REST API server-to-server. Untuk widget chat yang dipasang di website / aplikasi mobile, lihat panduan Web Chat Embed (akan datang).
Mulai dari mana?
Autentikasi
Buat API key dari dashboard, kelola scope, dan amankan kredensial.
Konvensi & Format
Format request/response, rate limit, format nomor telepon, naming.
Daftar Endpoint
Mulai dari kontak, lalu kirim pesan WhatsApp dan kelola webhook.
Contoh Kode
Snippet siap-pakai dalam cURL, Node.js, Python, dan PHP.
Base URL
Semua endpoint API menggunakan base URL berikut:
https://api.chatera.id/v1Versi /v1 adalah versi stable saat ini. Perubahan breaking di masa
depan akan dirilis sebagai /v2 — /v1 tetap dipertahankan minimal
12 bulan setelah versi baru rilis.
Persiapan singkat
Pastikan akun Chatera kamu aktif
Kamu harus sudah punya akun dengan role Owner atau Admin di workspace Chatera. Role Agent tidak bisa membuat API key.
Hubungkan saluran WhatsApp
API mengirim pesan melalui saluran WhatsApp yang sudah kamu hubungkan di dashboard. Pastikan minimal satu saluran berstatus Connected sebelum mulai integrasi.
Buat API key
Lihat panduan Autentikasi untuk membuat key pertama dan memilih scope yang sesuai dengan kebutuhanmu.
Coba endpoint pertama
Endpoint yang paling sederhana untuk memastikan integrasi bekerja:
curl -X GET "https://api.chatera.id/v1/contacts?per_page=1" \
-H "Authorization: Bearer chatera_sk_xxxxx"Kalau response 200 OK dengan envelope { "success": true, ... },
artinya kamu siap mulai.
Apa yang perlu kamu pahami sebelum mulai
- Jendela 24 jam WhatsApp — pesan teks/media/interaktif hanya bisa dikirim ke kontak yang menghubungi kamu dalam 24 jam terakhir. Untuk komunikasi di luar jendela ini, gunakan template.
- Rate limit — default 60 request/menit, 10.000 request/hari per API key. Lihat Konvensi untuk detail.
- Format nomor telepon — selalu pakai E.164 (kode negara +
nomor, mis.
628123456789). Format lokal08xxxditolak.
Bantuan & dukungan
- 📧 Email: support@chatera.id
- 💬 Komunitas Telegram: t.me/doyanbelajar
- 🐛 Laporan bug & feature request: hubungi tim sales kamu