Integrasi Zapier

Aplikasi Wbiztool di Zapier menyambungkan nombor WhatsApp anda ke aplikasi lain yang anda gunakan. Mulakan Zap apabila mesej WhatsApp tiba, atau hantar mesej WhatsApp apabila sesuatu berlaku dalam aplikasi lain.

Sebelum anda bermula#

• Akaun Wbiztool dengan nombor WhatsApp yang bersambung di WhatsApp settings.
• Client ID dan kunci API anda dari Settings → API keys.
• Untuk pencetus mesej masuk: tambahan Unibox dalam pelan anda. Lihat Keperluan pencetus.

Sambung akaun anda#

1. Tambah Wbiztool ke Zap

   Dalam Zapier, cipta Zap dan cari Wbiztool sebagai aplikasi pencetus atau tindakan.

2. Log masuk

   Apabila Zapier meminta anda menyambung akaun, masukkan Client ID dan kunci API anda dari Settings → API keys.

Kunci API menentukan ruang kerja yang digunakan oleh Zapier. Jika anda tergolong dalam lebih daripada satu ruang kerja, gunakan kunci yang dicipta dalam ruang kerja yang ingin anda sambungkan. Jika Client ID atau kunci API salah, Zapier menunjukkan ralat semasa anda menyambung, contohnya Auth Error: invalid api key.

Pencetus mesej WhatsApp masuk#

Pencetus ini memulakan Zap anda setiap kali seseorang menghantar mesej ke salah satu nombor WhatsApp anda. Gunakannya untuk menambah sembang baharu ke CRM, menyiarkan mesej ke saluran pasukan, atau merekod perbualan dalam hamparan.

1. Pilih pencetus

   Pilih Wbiztool sebagai aplikasi dan Incoming WhatsApp Message sebagai peristiwa pencetus.

2. Pilih nombor WhatsApp

   Di bawah WhatsApp Number, pilih nombor bersambung yang mesej masuknya patut memulakan Zap. Senarai menunjukkan nombor telefon yang bersambung dalam ruang kerja anda.

3. Uji pencetus

   Klik Test trigger. Zapier memuatkan mesej terkini yang diterima pada nombor itu, supaya anda boleh memetakan medan sebenar dalam langkah seterusnya. Jika nombor itu belum mempunyai mesej, Zapier menunjukkan mesej contoh sebaliknya.

4. Hidupkan Zap

   Terbitkan Zap. Wbiztool bersambung ke Zapier secara automatik. Anda tidak perlu menambah URL webhook di mana-mana dalam Wbiztool.

Keperluan pencetus#

• Tambahan Unibox. Pencetus menggunakan listener Unibox pada nombor anda. Tanpa tambahan ini, menghidupkan Zap gagal dengan Unibox add-on subscription required. Belinya di Billing & Plans: $20/bulan atau $200/tahun bagi setiap nombor WhatsApp yang digunakan dalam Unibox.
• Slot Unibox yang kosong. Jika nombor itu belum menjadi listener Unibox, ia dikira dalam bilangan listener yang dibenarkan oleh tambahan anda. Nombor yang sudah mempunyai listener tidak menggunakan slot lain.
• Peranan Owner atau Editor. Kunci API mesti milik Owner (Pemilik) atau Editor ruang kerja.
• Nombor WhatsApp yang bersambung. Nombor itu mesti kekal bersambung supaya mesej baharu dapat diambil.

Cara pencetus berfungsi dengan listener anda#

• Hanya mesej masuk memulakan Zap. Mesej yang dihantar dari nombor anda tidak.
• Hanya mesej yang diterima selepas anda menghidupkan Zap dihantar. Mesej lama tidak dimainkan semula.
• Jika nombor itu sudah mempunyai listener dengan URL webhook anda sendiri, webhook Zapier mengambil tempatnya semasa Zap dihidupkan. Apabila anda mematikan Zap, URL webhook, rahsia dan tetapan peristiwa anda sendiri dipulihkan.
• Jika anda memadam Zap tanpa mematikannya dahulu, Wbiztool berhenti menghantar kepadanya sebaik sahaja Zapier melaporkan bahawa Zap itu sudah tiada.
• Di Unibox listeners, listener menunjukkan lencana Zapier. Jika anda memadam atau melumpuhkannya di sana, Zap kekal hidup dalam Zapier tetapi tidak menerima mesej, dan halaman itu memberi amaran terlebih dahulu. Untuk menghentikan Zap, matikannya dalam Zapier sebaliknya. Untuk mendapatkan aliran mesej semula selepas memadam listener, matikan dan hidupkan semula Zap dalam Zapier.

Lihat Webhook listener untuk cara listener dan webhook berfungsi.

Data pencetus#

Setiap larian Zap menerima satu mesej, 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"
  }
}

Sesetengah mesej termasuk medan tambahan: message.media (nama, jenis dan saiz fail) untuk media, message.quoted_message_id untuk balasan dan group untuk mesej kumpulan.

Contoh: rekod mesej masuk dalam Google Sheets#

1. Pencetus: Wbiztool, Incoming WhatsApp Message.
2. Tindakan: Google Sheets, Create Spreadsheet Row. Petakan Contact Phone ke lajur Phone, Contact Name ke lajur Name dan Message Content ke lajur Message.

Hantar mesej WhatsApp dari Zap#

Tambah Wbiztool sebagai tindakan dan pilih salah satu peristiwa tindakan berikut:

Dalam setiap tindakan, pilih nombor penghantar di bawah WhatsApp Number. Masukkan nombor telefon penerima dengan kod negara, seperti 919876543210, atau letakkan kod negara dalam medan pilihan Country Code, seperti 91 (Malaysia: 60). Send WhatsApp Message on Group tiada telefon atau kod negara; ia mengambil Group Name sebaliknya.

Apabila Wbiztool tidak dapat menerima mesej, langkah itu gagal dan Zapier menunjukkan sebabnya, contohnya WbizTool: Invalid phone number atau WbizTool: Not enough credits. Langkah yang berjaya bermaksud mesej telah dimasukkan ke baris gilir. Wbiztool kemudian menghantarnya dari nombor anda yang bersambung.

Anda juga boleh memanggil API secara terus dengan Webhooks by Zapier:

Lihat Hantar mesej WhatsApp dari mana-mana alat automasi untuk maksud setiap medan, dan Hantar mesej untuk setiap pilihan.

Penyelesaian masalah#