Integrasi
Integrasi Zapier
Aplikasi Wbiztool di Zapier menghubungkan nomor WhatsApp Anda ke aplikasi lain yang Anda gunakan. Mulai Zap saat pesan WhatsApp masuk, atau kirim pesan WhatsApp saat sesuatu terjadi di aplikasi lain.
Sebelum memulai#
- Akun Wbiztool dengan nomor WhatsApp yang terhubung di WhatsApp settings.
- Client ID dan API key Anda dari Settings → API keys.
- Untuk pemicu pesan masuk: add-on Unibox di paket Anda. Lihat Persyaratan pemicu.
Menghubungkan akun Anda#
Tambahkan Wbiztool ke Zap
Di Zapier, buat Zap dan cari Wbiztool sebagai aplikasi trigger atau action.
Login
Saat Zapier meminta Anda menghubungkan akun, masukkan Client ID dan API key Anda dari Settings → API keys.
API key menentukan workspace mana yang digunakan Zapier. Jika Anda tergabung di lebih dari satu workspace, gunakan key yang dibuat di workspace yang ingin Anda hubungkan. Jika Client ID atau API key salah, Zapier menampilkan error saat Anda menghubungkan, misalnya Auth Error: invalid api key.
Pemicu pesan WhatsApp masuk#
Pemicu ini memulai Zap Anda setiap kali seseorang mengirim pesan ke salah satu nomor WhatsApp Anda. Gunakan untuk menambahkan chat baru ke CRM, memposting pesan ke channel tim, atau mencatat percakapan di spreadsheet.
Pilih pemicu
Pilih Wbiztool sebagai aplikasi dan Incoming WhatsApp Message sebagai trigger event.
Pilih nomor WhatsApp
Di bawah WhatsApp Number, pilih nomor terhubung yang pesan masuknya akan memulai Zap. Daftar ini menampilkan nomor telepon yang terhubung di workspace Anda.
Uji pemicu
Klik Test trigger. Zapier memuat pesan terbaru yang diterima di nomor tersebut, sehingga Anda dapat memetakan field sungguhan di langkah berikutnya. Jika nomor tersebut belum memiliki pesan, Zapier menampilkan contoh pesan.
Aktifkan Zap
Publikasikan Zap. Wbiztool terhubung ke Zapier secara otomatis. Anda tidak perlu menambahkan URL webhook di mana pun di Wbiztool.
Persyaratan pemicu#
- Add-on Unibox. Pemicu ini menggunakan listener Unibox pada nomor Anda. Tanpa add-on, mengaktifkan Zap gagal dengan
Unibox add-on subscription required. Beli di Billing & Plans: $20/bulan atau $200/tahun per nomor WhatsApp yang digunakan di Unibox. - Slot Unibox yang kosong. Jika nomor belum menjadi listener Unibox, nomor tersebut dihitung dalam jumlah listener yang diizinkan add-on Anda. Nomor yang sudah memiliki listener tidak memakai slot lain.
- Peran Owner atau Editor. API key harus milik Owner atau Editor workspace.
- Nomor WhatsApp yang terhubung. Nomor harus tetap terhubung agar pesan baru dapat diambil.
Cara pemicu bekerja dengan listener Anda#
- Hanya pesan masuk yang memulai Zap. Pesan yang dikirim dari nomor Anda tidak.
- Hanya pesan yang diterima setelah Anda mengaktifkan Zap yang dikirim. Pesan lama tidak diputar ulang.
- Jika nomor sudah memiliki listener dengan URL webhook Anda sendiri, webhook Zapier menggantikannya selama Zap aktif. Saat Anda menonaktifkan Zap, URL webhook, secret, dan pengaturan event Anda sendiri dikembalikan.
- Jika Anda menghapus Zap tanpa menonaktifkannya terlebih dahulu, Wbiztool berhenti mengirim ke Zap tersebut segera setelah Zapier melaporkan bahwa Zap sudah tidak ada.
- Di Unibox listeners, listener menampilkan lencana Zapier. Jika Anda menghapus atau menonaktifkannya di sana, Zap tetap aktif di Zapier tetapi tidak menerima pesan, dan halaman akan memperingatkan Anda terlebih dahulu. Untuk menghentikan Zap, nonaktifkan di Zapier. Agar pesan kembali mengalir setelah listener dihapus, nonaktifkan lalu aktifkan lagi Zap di Zapier.
Lihat Webhook listener untuk cara kerja listener dan webhook.
Data pemicu#
Setiap eksekusi Zap menerima satu pesan, seperti ini:
{
"event": "message_received",
"timestamp": "2026-09-16T10:31:12.482913+00:00",
"webhook_id": 42,
"whatsapp_client_id": "678",
"whatsapp_phone": "919812345678",
"message": {
"id": "[email protected]_3EB0C1A2B3D4E5F60718",
"type": "chat",
"content": "Hi, is my order #4821 out for delivery?",
"from": "919876543210",
"from_name": "Aman",
"to": "919812345678",
"timestamp": "2026-09-16T10:29:58+00:00",
"whatsapp_timestamp": 1789554598,
"direction": "incoming",
"status": "pending",
"is_forwarded": false,
"forwarding_score": 0
},
"contact": {
"whatsapp_id": "[email protected]",
"phone": "919876543210",
"lid": null,
"phone_hidden": false,
"name": "Aman",
"is_group": false,
"is_business": false
},
"organisation": {
"id": "5021",
"name": "Acme Stores"
}
}
| Field | Deskripsi |
|---|---|
whatsapp_phone | Nomor WhatsApp Anda yang menerima pesan. |
message.type | chat untuk teks. Pesan media menggunakan tipe seperti image, video, audio, ptt (pesan suara), document, dan sticker. |
message.content | Teksnya. Untuk media, berupa label singkat seperti "📸 Image". |
message.from | Nomor pengirim, tanpa +. Kosong jika WhatsApp menyembunyikannya (lihat di bawah). |
contact.phone | Nomor kontak, tanpa +. Kosong jika WhatsApp menyembunyikannya. |
contact.lid | ID privasi WhatsApp untuk kontak, seperti 62337239240946@lid, jika WhatsApp menggunakannya. Jika tidak, null. |
contact.phone_hidden | true jika WhatsApp tidak membagikan nomor kontak. |
contact.is_group | true jika pesan berasal dari grup. Pesan grup juga menyertakan group.name. |
Beberapa pesan menyertakan field tambahan: message.media (nama file, tipe, dan ukuran) untuk media, message.quoted_message_id untuk balasan, dan group untuk pesan grup.
Contoh: mencatat pesan masuk di Google Sheets#
- Pemicu: Wbiztool, Incoming WhatsApp Message.
- Action: Google Sheets, Create Spreadsheet Row. Petakan Contact Phone ke kolom Phone, Contact Name ke kolom Name, dan Message Content ke kolom Message.
Mengirim pesan WhatsApp dari Zap#
Tambahkan Wbiztool sebagai action dan pilih salah satu action event berikut:
| Action | Yang dikirim |
|---|---|
| Send Text-Only WhatsApp Message | Pesan teks. |
| Send Image File With Text on WhatsApp | Gambar dari URL gambar publik, dengan keterangan opsional. |
| Send PDF File With Text on WhatsApp | File dari URL publik, dengan pesan opsional. |
| Send Advanced WhatsApp Message | Teks, gambar, atau file, dengan webhook status opsional. |
| Send WhatsApp Message on Group | Pesan ke grup WhatsApp, berdasarkan nama grup yang persis. |
Di setiap action, pilih nomor pengirim di bawah WhatsApp Number. Masukkan nomor telepon penerima dengan kode negara, seperti 919876543210, atau masukkan kode negara di field opsional Country Code, seperti 91. Send WhatsApp Message on Group tidak memiliki telepon atau kode negara; action ini menggunakan Group Name.
Jika Wbiztool tidak dapat menerima pesan, langkah tersebut gagal dan Zapier menampilkan alasannya, misalnya WbizTool: Invalid phone number atau WbizTool: Not enough credits. Langkah yang berhasil berarti pesan sudah masuk antrean. Wbiztool kemudian mengirimnya dari nomor Anda yang terhubung.
Anda juga dapat memanggil API secara langsung dengan Webhooks by Zapier:
| Pengaturan | Nilai |
|---|---|
| Action event | POST |
| URL | https://wbiztool.com/api/v1/send_msg/ |
| Payload type | json atau form |
| Data | client_id, api_key, whatsapp_client, country_code, phone, msg |
Lihat Kirim pesan WhatsApp dari alat otomatisasi apa pun untuk arti setiap field, dan Kirim pesan untuk semua opsi.
Pemecahan masalah#
| Masalah | Yang perlu diperiksa |
|---|---|
Auth Error: invalid api key | Key sudah dihapus atau salah ketik, atau tidak cocok dengan Client ID. Buat yang baru di Settings → API keys lalu hubungkan ulang. |
This API key is not linked to a workspace. Create a new API key in WbizTool. | Key berasal dari penyiapan akun lama. Buat key baru di Settings → API keys lalu hubungkan ulang. |
Unibox add-on subscription required | Beli add-on Unibox di Billing & Plans, lalu aktifkan Zap lagi. |
Unibox numbers limit reached for your plan. Remove a listener or upgrade to connect this number. | Semua slot Unibox Anda sudah terpakai. Hapus listener yang tidak lagi Anda perlukan di Unibox listeners, atau tambah jumlah add-on. |
Only workspace owners and editors can connect Zapier triggers | Hubungkan ulang Zapier dengan API key yang dibuat oleh Owner atau Editor workspace. |
Invalid WhatsApp client | Nomor yang dipilih pada pemicu sedang tidak terhubung. Hubungkan ulang di WhatsApp settings. |
Invalid phone number atau Phone number is invalid | Nomor penerima salah atau tidak menyertakan kode negara. Gunakan hanya angka, seperti 919876543210, atau isi Country Code. |
Not enough credits | Kredit pesan workspace Anda sudah habis. Isi ulang di Billing & Plans. |
| Zap aktif tetapi tidak terpicu | Nomor harus tetap terhubung. Periksa di WhatsApp settings dan pastikan listener-nya di Unibox listeners ada, menampilkan Zapier, dan aktif. Jika listener sudah dihapus atau tidak menampilkan lencana Zapier, nonaktifkan lalu aktifkan lagi Zap di Zapier. Pesan diambil dalam beberapa menit. |
| Contact Phone kosong | WhatsApp menyembunyikan nomor kontak tersebut. Lihat Saat nomor telepon disembunyikan. |
