Panduan Lengkap Open API WhatsApp untuk Integrasi Sistem Bisnis dengan Everpro Chat
Jika bisnis Anda sudah memiliki sistem sendiri seperti CRM, ERP, platform e-commerce, atau aplikasi internal dan ingin mengirimkan pesan WhatsApp broadcast secara otomatis tanpa harus membuka dashboard secara manual, fitur Open API WhatsApp dari Everpro Chat adalah solusinya.
Fitur API / App Integration memungkinkan Anda menghubungkan sistem atau aplikasi Anda langsung ke akun Everpro Chat. Melalui integrasi ini, sistem Anda dapat mengirimkan pesan broadcast WhatsApp otomatis menggunakan template Meta yang sudah disetujui (marketing, utility, maupun OTP) cukup dengan satu request dari sisi sistem Anda.
⚠️ Penting: Fitur API / App Integration hanya tersedia untuk akun WhatsApp yang sudah ter-whitelist. Jika akun Anda belum ter-whitelist, silakan hubungi tim Support Everpro untuk mengajukan permintaan akses.
Bagaimana Cara Kerja Open API WhatsApp Everpro?
Ada dua alur utama yang perlu Anda pahami sebelum melakukan integrasi:
Alur Pengiriman Pesan & Penerimaan Status:
- Authenticate: Sistem Anda menambahkan API Key pada HTTP Header
- Send Request: Sistem Anda mengirim request ke Open API Everpro
- Deliver Message: Everpro mengirimkan pesan secara otomatis ke WhatsApp pelanggan
- Webhook: Sistem Anda menerima status pengiriman pesan
Alur Monitoring Human Agent di Chat Room:
- Pesan Pertama: Pelanggan mengirimkan pesan pertama kali di sesi percakapan
- Balasan Agen: Agen membalas pelanggan untuk pertama kali
- Percakapan Berlangsung: Terjadi percakapan aktif di Chat Room
- Sesi Ditutup: Agen menutup atau melakukan closing sesi percakapan
📌 Webhook hanya aktif untuk percakapan yang berlangsung di Chat Room Everpro Chat.
Setelah akun Anda ter-whitelist, menu API / App Integration akan muncul di dashboard Everpro Chat Anda. Melalui menu ini, Anda dapat melakukan dua hal utama: mengelola API Key dan mengatur Webhook.
| API Key | Kode unik yang berfungsi sebagai izin masuk agar aplikasi lain bisa terhubung dengan akun Everpro Anda. |
| Webhook | Cara otomatis bagi Everpro untuk memberi tahu aplikasi Anda setiap kali terjadi sesuatu, misalnya ada pesan masuk. |
Cara Generate dan Menggunakan API Key di Everpro Chat
Langkah 1: Buka Menu API / App Integration
Setelah login ke dashboard Everpro Chat, pilih menu API / App Integration pada sidebar.
Langkah 2: Generate API Key
Klik tulisan Klik untuk generate API Key.
⚠️ Catatan: Generate API Key hanya dapat dilakukan oleh akun dengan role Owner jika API Key belum pernah dibuat sebelumnya. Jika API Key sebelumnya sudah pernah dibuat, role Supervisor juga dapat mengaksesnya.
Langkah 3: Salin API Key dan Key Secret
Klik ikon copy untuk menyalin API Key dan Key Secret Anda.
⚠️ Catatan: Tindakan ini hanya dapat dilakukan oleh akun dengan role Owner dan Supervisor.
Langkah 4: Siapkan Template Pesan
Kembali ke dashboard Everpro Chat dan buka menu Template Pesan.
Untuk dapat mengirim broadcast via API, Anda memerlukan Template Official (Meta-Approved). Jika belum memilikinya, ada dua cara untuk mendapatkannya:
a. Membuat Template Baru
- Klik Buat Template, kemudian pilih Template Official
- Isi detail template yang dibutuhkan
- Tunggu hingga status template berubah menjadi DISETUJUI
b. Sinkronisasi Template yang Sudah Ada
- Klik tombol Sync Meta Template
- Jika berhasil, akan muncul notifikasi pop-up Success: Template berhasil disinkronisasi
Langkah 5: Salin Template Key
Setelah template tersedia, temukan Template Key yang dibutuhkan dan klik tombol Salin.
Langkah 6: Implementasikan Request di Sistem Anda
Pada sistem Anda, lakukan implementasi request sesuai template menggunakan API Key, Key Secret, dan Template Key yang telah Anda salin. Berikut contoh implementasinya dalam format JSON:
Contoh API Request (POST /v1/send-message):
Untuk panduan implementasi lengkap di berbagai bahasa pemrograman, kunjungi dokumentasi berikut: Client Auth Everpro: https://developer.everpro.id/chat/#tag/Client-Auth
📌 Pastikan Anda memiliki WhatsApp Credit yang cukup sebelum melakukan broadcast via API. Untuk informasi lebih lengkap mengenai WhatsApp Credit, baca panduan: WhatsApp Credit Everpro. Untuk melihat riwayat penggunaan, buka menu WhatsApp Credit di dashboard, lalu klik tombol Download pada nomor WhatsApp yang ingin Anda cek.
Cara Setting Webhook WhatsApp di Everpro Chat
Langkah 1: Buka Menu API / App Integration
Pilih menu API / App Integration pada sidebar dashboard Everpro Chat.
Langkah 2: Masukkan Webhook URL
Isi kolom Webhook URL dengan tautan endpoint sistem Anda yang akan menerima notifikasi dari Everpro.
Langkah 3: Salin Callback Key
Klik ikon copy untuk menyalin Callback Key.
Langkah 4: Konfigurasi Webhook di Sistem Anda
Pada sistem Anda, masukkan Callback Key yang telah disalin ke dalam konfigurasi penerimaan webhook.
Untuk panduan implementasi lengkap di berbagai bahasa pemrograman, kunjungi: Callback Everpro: https://developer.everpro.id/chat/#tag/Callback
Langkah 5: Atur Jenis Event yang Ingin Diterima
Anda dapat memilih jenis informasi apa yang sistem Anda terima dari Everpro. Aktifkan atau nonaktifkan toggle pada setiap opsi event yang tersedia, lalu klik Simpan.
Berikut opsi event yang tersedia:
| Event | Keterangan |
| First reply by agent | Informasi waktu respon pertama kali yang diberikan agen kepada pelanggan dalam sebuah percakapan. |
| Conversation closed | Notifikasi saat agen menutup percakapan, lengkap dengan catatan (note), identitas agen yang menutup, dan waktu penutupan. |
| Broadcast delivery status | Notifikasi pembaruan status pengiriman pesan secara massal berdasarkan ID Broadcast (total pesan terkirim, gagal sebagian, atau gagal seluruhnya). |
| First inbound message | Notifikasi saat pelanggan memulai percakapan baru (setelah status sebelumnya ditutup), mencakup data pengirim, agen, dan waktu pesan masuk. |
FAQ: Pertanyaan Umum tentang Open API WhatsApp Everpro
1. Siapa yang bisa menggunakan fitur Open API di Everpro Chat?
Fitur ini hanya tersedia untuk akun WhatsApp yang sudah ter-whitelist. Hubungi tim Support Everpro untuk mengajukan akses.
2. Siapa yang bisa generate API Key?
Generate API Key pertama kali hanya bisa dilakukan oleh role Owner. Setelah API Key dibuat, role Supervisor juga dapat mengakses dan menyalinnya.
3. Template apa saja yang bisa digunakan untuk broadcast via API?
Semua jenis template Meta yang sudah berstatus DISETUJUI, termasuk template marketing, utility, dan OTP.
4. Apakah saya perlu WhatsApp Credit untuk kirim broadcast via API?
Ya. Setiap pengiriman pesan broadcast via API tetap memotong WhatsApp Credit sesuai jenis template yang digunakan.
5. Apa perbedaan API Key dan Webhook?
API Key digunakan agar sistem Anda bisa mengirim request ke Everpro (outbound). Webhook digunakan agar Everpro bisa mengirim notifikasi ke sistem Anda secara otomatis (inbound).
Butuh bantuan lebih lanjut? Hubungi tim Support Everpro melalui fitur live chat di dashboard atau kunjungi halaman Panduan Everpro Chat untuk artikel panduan lainnya.