Panduan Integrasi API
Hubungkan CRM, sistem pemesanan, atau aplikasi apa pun untuk mengirim pesan WhatsApp melalui API sederhana kami.
Mulai dalam 5 Langkah Sederhana
Unduh Aplikasi Desktop
Unduh dan instal All-in-One Messenger Hub di komputer Windows Anda.
Hubungkan WhatsApp Anda
Tambahkan akun WhatsApp Anda ke aplikasi dengan memindai kode QR.
Buat Session API
Buka tab WhatsApp dan buat Session API baru. Tautkan ke saluran WhatsApp Anda.
Salin Kunci API Anda
Salin kunci API yang dihasilkan. Simpan dengan aman - itu adalah autentikasi Anda.
Mulai Mengirim Pesan
Gunakan API dari aplikasi Anda. Jaga aplikasi desktop tetap berjalan untuk mengirim pesan.
Autentikasi
Semua endpoint API memerlukan autentikasi melalui kunci API Anda. Anda dapat memasukkan kunci dengan salah satu cara ini:
| Metode | Contoh |
|---|---|
| Header X-API-Key (Direkomendasikan) | X-API-Key: your-api-key |
| Parameter Query/Body | key=your-api-key |
| Parameter Alternatif | api_key=your-api-key |
Kirim Pesan
Kirim pesan WhatsApp ke nomor telepon atau grup. Pesan diantrekan dan dikirim saat aplikasi desktop berjalan.
POST https://onemessengerhub.com/api/whatsapp-session/send
Parameter
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
key |
string | Ya | Kunci API Anda dari aplikasi desktop |
mobile |
string | Kondisional | Nomor telepon dengan kode negara (wajib tanpa group_id) |
group_id |
string | Kondisional | ID grup WhatsApp (wajib tanpa mobile). Akhiran @g.us ditambahkan secara otomatis. |
message |
string | Ya | Teks pesan (maksimal 4096 karakter) |
Contoh Permintaan
curl -X POST https://onemessengerhub.com/api/whatsapp-session/send \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mobile": "1234567890", "message": "Hello!"}'
Permintaan GET Sederhana (Peramban atau Tautan)
https://onemessengerhub.com/api/whatsapp-session/send?key=YOUR_API_KEY&mobile=1234567890&message=Hello!
Respons Sukses (201)
{
"success": true,
"message": "Message queued successfully",
"data": {
"message_id": 123,
"recipient": "1234567890",
"status": "pending"
}
}
Simpan Kontak
Simpan atau ganti nama kontak di WhatsApp Anda. Operasi diantrekan dan diproses oleh aplikasi desktop.
POST https://onemessengerhub.com/api/whatsapp-session/save-contact
Parameter
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
key |
string | Ya | Kunci API Anda dari aplikasi desktop |
contact_id |
string | Ya | Nomor telepon kontak atau ID WhatsApp (maksimal 50 karakter). Akhiran @c.us ditambahkan secara otomatis. |
name |
string | Ya | Nama tampilan untuk kontak (maksimal 255 karakter) |
Contoh Permintaan
curl -X POST https://onemessengerhub.com/api/whatsapp-session/save-contact \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contact_id": "1234567890", "name": "John Doe"}'
Respons Sukses (201)
{
"success": true,
"message": "Contact save operation queued",
"data": {
"operation_id": 456,
"contact_id": "[email protected]",
"status": "pending"
}
}
Hapus Kontak
Hapus kontak dari WhatsApp Anda. Operasi diantrekan dan diproses oleh aplikasi desktop.
POST https://onemessengerhub.com/api/whatsapp-session/remove-contact
Parameter
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
key |
string | Ya | Kunci API Anda dari aplikasi desktop |
contact_id |
string | Ya | Nomor telepon kontak atau ID WhatsApp (maksimal 50 karakter). Akhiran @c.us ditambahkan secara otomatis. |
Contoh Permintaan
curl -X POST https://onemessengerhub.com/api/whatsapp-session/remove-contact \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contact_id": "1234567890"}'
Respons Sukses (201)
{
"success": true,
"message": "Contact remove operation queued",
"data": {
"operation_id": 789,
"contact_id": "[email protected]",
"status": "pending"
}
}
Penanganan Kesalahan
API menggunakan kode status HTTP standar. Berikut respons kesalahan yang umum:
Kesalahan Autentikasi (401)
{
"success": false,
"message": "Invalid or inactive API key"
}
Kesalahan Validasi (422)
{
"success": false,
"message": "Validation failed",
"errors": {
"mobile": ["The mobile field is required when group id is not present."],
"message": ["The message field is required."]
}
}
Apa yang Dapat Anda Bangun
Integrasi CRM
Kirim pesan tindak lanjut, pengingat, dan pembaruan langsung dari sistem CRM Anda.
Konfirmasi Pemesanan
Otomatis mengirim konfirmasi dan pengingat janji temu kepada pelanggan.
Notifikasi Pesanan
Beri tahu pelanggan tentang status pesanan, pembaruan pengiriman, dan info pengantaran.
Sistem Peringatan
Kirim peringatan dan notifikasi penting kepada tim atau pelanggan Anda.
Kampanye Pemasaran
Kirim pesan promosi dan pembaruan ke daftar kontak Anda.
Alur Kerja Khusus
Integrasikan dengan Zapier, Make, n8n, atau platform otomatisasi apa pun.
Lebih Banyak API Segera Hadir
Kami memperluas penawaran API kami untuk mencakup lebih banyak platform dan kasus penggunaan.
Chatbot API
Picu respons chatbot dan kelola percakapan secara terprogram.
Contacts API
Akses dan kelola kontak aplikasi pesan Anda di seluruh platform.
Webhooks
Terima notifikasi real-time saat pesan diterima atau dikirim.
All-in-One Messenger Hub