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

  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 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"
  }
}
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, dan ukuran) untuk media, message.quoted_message_id untuk balasan, dan group untuk pesan grup.

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 keyKey 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 requiredBeli 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 triggersHubungkan ulang Zapier dengan API key yang dibuat oleh Owner 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 creditsKredit pesan workspace Anda sudah habis. Isi ulang di Billing & Plans.
Zap aktif tetapi tidak terpicuNomor 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 kosongWhatsApp menyembunyikan nomor kontak tersebut. Lihat Saat nomor telepon disembunyikan.