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 kunci API Anda dari Pengaturan → Kunci API.
- 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 kunci API Anda dari Pengaturan → Kunci API.
Kunci API menentukan workspace mana yang digunakan Zapier. Jika Anda tergabung di lebih dari satu workspace, gunakan kunci yang dibuat di workspace yang ingin Anda hubungkan. Jika Client ID atau kunci API 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 menambahkan nomor Anda ke kotak masuk Unibox (sebagai nomor kotak masuk). Tanpa add-on, mengaktifkan Zap gagal dengan
Unibox add-on subscription required. Beli di Tagihan & paket: $20/bulan atau $200/tahun per nomor WhatsApp yang digunakan di Unibox. - Nomor kotak masuk yang tersedia. Jika nomor belum ada di kotak masuk, nomor tersebut memakai salah satu nomor kotak masuk yang diizinkan add-on Anda. Nomor yang sudah ada di kotak masuk tidak memakai nomor kotak masuk lain.
- Peran Pemilik atau Editor. Kunci API harus dibuat oleh Pemilik atau Editor workspace saat ini.
- Nomor WhatsApp yang terhubung. Nomor harus tetap terhubung agar pesan baru dapat diambil.
Cara pemicu bekerja dengan nomor kotak masuk 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 ada di kotak masuk 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 Nomor kotak masuk, webhook nomor tersebut menampilkan lencana Zapier. Jika Anda mengklik Hentikan atau Hapus pada nomor itu 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 pesan masuk untuk cara kerja nomor kotak masuk 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, ukuran, dan url, tautan unduhan yang berlaku selama 7 hari) untuk media, message.quoted_message_id untuk balasan, dan group untuk pesan grup. Untuk menyimpan file, salin dalam 7 hari tersebut (misalnya dengan langkah unggah ke Google Drive atau Dropbox).
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 | Kunci sudah dihapus atau salah ketik, atau tidak cocok dengan Client ID. Buat yang baru di Pengaturan → Kunci API lalu hubungkan ulang. |
This API key is not linked to a workspace. Create a new API key in WbizTool. | Kunci berasal dari penyiapan akun lama. Buat kunci baru di Pengaturan → Kunci API lalu hubungkan ulang. |
Unibox add-on subscription required | Beli add-on Unibox di Tagihan & paket, lalu aktifkan Zap lagi. |
Unibox numbers limit reached for your plan. Remove a listener or upgrade to connect this number. | Semua nomor kotak masuk Anda sedang digunakan. Hapus nomor yang tidak lagi Anda perlukan di Nomor kotak masuk, atau tambah jumlah add-on. |
Only workspace owners and editors can connect Zapier triggers | Hubungkan ulang Zapier dengan kunci API yang dibuat oleh Pemilik 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 | Workspace memakai paket gratis dan pesannya sudah habis. Pilih paket di Tagihan & paket: paket berbayar mengirim pesan tanpa batas. |
Daily limit reached: … | Nomor WhatsApp sudah menerima 1.000 pesan dalam 24 jam terakhir (penggunaan wajar). Kirim sisanya nanti atau dari nomor lain. |
| Zap aktif tetapi tidak terpicu | Nomor harus tetap terhubung. Periksa di WhatsApp settings dan pastikan nomornya ada di Nomor kotak masuk, menampilkan Zapier, dan berstatus Menyinkronkan. Jika nomor 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. |

