Langsung ke konten
WbizTool

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#

Menghubungkan akun Anda#

  1. Tambahkan WbizTool ke Zap

    Di Zapier, buat Zap dan cari WbizTool sebagai aplikasi trigger atau action.

  2. 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.

  1. Pilih pemicu

    Pilih WbizTool sebagai aplikasi dan Incoming WhatsApp Message sebagai trigger event.

  2. 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.

  3. 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.

  4. 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"
  }
}
FieldDeskripsi
whatsapp_phoneNomor WhatsApp Anda yang menerima pesan.
message.typechat untuk teks. Pesan media menggunakan tipe seperti image, video, audio, ptt (pesan suara), document, dan sticker.
message.contentTeksnya. Untuk media, berupa label singkat seperti "📸 Image".
message.fromNomor pengirim, tanpa +. Kosong jika WhatsApp menyembunyikannya (lihat di bawah).
contact.phoneNomor kontak, tanpa +. Kosong jika WhatsApp menyembunyikannya.
contact.lidID privasi WhatsApp untuk kontak, seperti 62337239240946@lid, jika WhatsApp menggunakannya. Jika tidak, null.
contact.phone_hiddentrue jika WhatsApp tidak membagikan nomor kontak.
contact.is_grouptrue 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#

  1. Pemicu: WbizTool, Incoming WhatsApp Message.
  2. 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:

ActionYang dikirim
Send Text-Only WhatsApp MessagePesan teks.
Send Image File With Text on WhatsAppGambar dari URL gambar publik, dengan keterangan opsional.
Send PDF File With Text on WhatsAppFile dari URL publik, dengan pesan opsional.
Send Advanced WhatsApp MessageTeks, gambar, atau file, dengan webhook status opsional.
Send WhatsApp Message on GroupPesan 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:

PengaturanNilai
Action eventPOST
URLhttps://wbiztool.com/api/v1/send_msg/
Payload typejson atau form
Dataclient_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#

MasalahYang perlu diperiksa
Auth Error: invalid api keyKunci 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 requiredBeli 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 triggersHubungkan ulang Zapier dengan kunci API yang dibuat oleh Pemilik atau Editor workspace.
Invalid WhatsApp clientNomor yang dipilih pada pemicu sedang tidak terhubung. Hubungkan ulang di WhatsApp settings.
Invalid phone number atau Phone number is invalidNomor penerima salah atau tidak menyertakan kode negara. Gunakan hanya angka, seperti 919876543210, atau isi Country Code.
Not enough creditsWorkspace 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 terpicuNomor 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 kosongWhatsApp menyembunyikan nomor kontak tersebut. Lihat Saat nomor telepon disembunyikan.