Selamat Datang di API BienTalk! 👋

Integrasikan kekuatan WhatsApp ke dalam aplikasi Anda semudah bermain balok susun Lego. Panduan lengkap tersedia di bawah ini!

🔐 Autentikasi

Semua permintaan API harus menyertakan **API Key** Anda di dalam *header* Authorization. Dapatkan API Key di menu Dashboard Anda.

Authorization: Bearer YOUR_API_KEY
📱 Cek Status Device
GET/api/v1/device/status/:device_id

Gunakan endpoint ini untuk mengecek apakah nomor WhatsApp Anda sedang aktif (CONNECTED) atau terputus (DISCONNECTED).

Contoh Response (200 OK)

{
  "status": "success",
  "data": {
    "device_id": "8a7b6c5d...",
    "state": "CONNECTED",
    "number": "6281234567890",
    "battery": 85
  }
}
✉️ Kirim Pesan Teks
POST/api/v1/messages/send

Gunakan endpoint ini untuk mengirimkan pesan teks instan ke nomor WhatsApp pelanggan Anda.

Body Parameter (JSON)

{
  "device_id": "8a7b6c5d...",
  "to": "6281234567890",
  "message": "Halo! Ini pesan super cepat dari BienTalk API 👋"
}

Contoh Response (200 OK)

{
  "status": "success",
  "message": "Hore! Pesan berhasil meluncur! 🚀",
  "data": {
    "message_id": "MSG-998877"
  }
}
🖼️ Kirim Media (Gambar/Video)
POST/api/v1/messages/send-media

Kirimkan foto brosur, video promosi, atau dokumen invoice langsung ke WhatsApp pelanggan dalam bentuk lampiran (attachment).

Body Parameter (JSON)

{
  "device_id": "8a7b6c5d...",
  "to": "6281234567890",
  "caption": "Promo Akhir Tahun! Cek katalog terlampir. 🎉",
  "media_url": "https://example.com/promo-banner.jpg",
  "media_type": "image" // image, video, document
}
🎣 Webhook Pesan Masuk

Alih-alih terus-menerus mengecek apakah ada pesan baru, BienTalk akan mengirimkan (POST) data langsung ke server Anda setiap kali ada pesan masuk. Anda cukup mendengarkan *event* ini!

Contoh Payload Webhook (Dikirim ke Server Anda)

{
  "event": "message.received",
  "device_id": "8a7b6c5d...",
  "data": {
    "from": "6289876543210",
    "name": "Budi Santoso",
    "message": "Halo Min, mau tanya harga paket Pro?",
    "timestamp": 1718900000
  }
}

Masih Bingung? 🤔

Tim superhero kami siap membantu integrasi Anda kapan saja.

Panggil Tim Bantuan 🦸‍♂️