Langsung ke konten
Wbiztool

Integrasi

Kirim pesan WhatsApp dari alat otomatisasi apa pun

Sebagian besar platform otomatisasi memiliki action yang mengirim permintaan HTTP, sering disebut HTTP Request, API request, atau Outgoing webhook. Arahkan action tersebut ke endpoint Kirim pesan Wbiztool, dan setiap kali alur kerja Anda berjalan, pesan WhatsApp dikirim dari nomor Anda yang terhubung.

Halaman ini menjelaskan penyiapannya sekali, lalu menunjukkan letak action tersebut di Pabbly Connect, Albato, Activepieces, dan Make.

Sebelum memulai#

Anda memerlukan tiga nilai dari akun Wbiztool Anda:

  • Client ID dan API key dari Settings → API keys.
  • WhatsApp Client ID dari nomor pengirim, yang ditampilkan di WhatsApp settings. Nomor tersebut sebaiknya terhubung; pesan yang dikirim saat nomor terputus akan menunggu di antrean.

Lihat Autentikasi untuk detailnya.

Mengonfigurasi action HTTP#

  1. Tambahkan action HTTP request

    Setelah pemicu Anda (entri formulir baru, baris spreadsheet baru, pesanan baru), tambahkan action HTTP atau API request dari platform Anda.

  2. Atur metode dan URL

    Metode POST, URL https://wbiztool.com/api/v1/send_msg/. Biarkan autentikasi diatur ke none (tidak ada): kredensial dikirim di body.

  3. Pilih jenis body

    Pilih JSON jika alat Anda menyediakannya. Form data (field formulir) juga berfungsi, jadi gunakan yang paling mudah di alat Anda. Anda tidak memerlukan header tambahan.

  4. Tambahkan field body

    Tambahkan field pada tabel di bawah. Ketik kredensial Anda sebagai nilai tetap dan petakan phone serta msg dari data pemicu Anda.

  5. Uji langkahnya

    Jalankan langkah tersebut sekali dengan data uji. Respons dengan "status": 1 berarti pesan sudah masuk antrean.

Field body#

FieldWajibNilai
client_idYaAPI Client ID Anda.
api_keyYaAPI key Anda.
whatsapp_clientDisarankanID nomor WhatsApp pengirim. Anda hanya boleh menghilangkannya jika workspace Anda memiliki tepat satu nomor yang terhubung. Jika nomor itu terputus, menghilangkan field ini mengembalikan Invalid whatsapp client id.
phoneYaNomor penerima, misalnya dipetakan dari kolom formulir atau sheet.
country_codeDisarankanKode panggilan negara tanpa +, seperti 62, 91, atau 1. Ditambahkan di depan phone kecuali nomornya sudah diawali kode tersebut. Jadi nomor lokal yang kebetulan diawali digit yang sama dengan kode negara tidak diberi awalan. Pengecualiannya adalah kode 91, di mana nomor 10 digit selalu diberi awalan. Kirim nomor internasional lengkap jika memungkinkan.
msgUntuk pesan teksTeks pesan, maksimal 3.000 karakter. message diterima sebagai nama lain untuk field ini.
msg_typeTidak0 teks (default), 1 gambar, 2 file.
img_urlUntuk msg_type 1URL publik gambar.
file_urlUntuk msg_type 2URL publik file.
file_nameTidakNama file yang dilihat penerima, seperti invoice.pdf.
webhookTidakURL yang dipanggil saat pesan terkirim atau gagal.
expire_after_secondsTidakJika pesan belum terkirim dalam sekian detik, misalnya 3600, pesan ditandai Expired dan tidak dikirim.

Untuk mengirim ke grup WhatsApp alih-alih nomor, kirim group_name sebagai pengganti phone. Lihat Kirim ke grup. Semua opsi lainnya tercantum di Kirim pesan.

Contoh body JSON#

Ganti nilai berhuruf kapital dan petakan placeholder ke field dari pemicu Anda. Sintaks persis untuk menyisipkan data pemicu berbeda di setiap alat; sebagian besar memungkinkan Anda mengklik field dari pemilih data.

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "country_code": "91",
  "phone": "PHONE_FROM_TRIGGER",
  "msg": "Hi NAME_FROM_TRIGGER, thanks for your order. We will update you here on WhatsApp."
}

Untuk mengirim ke grup, ganti phone dan country_code dengan group_name:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "group_name": "Sales Team Mumbai",
  "msg": "New lead: NAME_FROM_TRIGGER, PHONE_FROM_TRIGGER"
}

Untuk mengirim gambar, atur msg_type ke 1 dan tambahkan img_url; msg menjadi keterangan (caption). Untuk file, atur msg_type ke 2 dan tambahkan file_url serta file_name:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 2,
  "country_code": "91",
  "phone": "PHONE_FROM_TRIGGER",
  "file_url": "https://example.com/invoices/INV-1042.pdf",
  "file_name": "INV-1042.pdf",
  "msg": "Here is your invoice."
}

Respons#

Permintaan yang berhasil mengembalikan:

{
  "status": 1,
  "message": "Created",
  "msg_id": 9817263
}

"status": 1 berarti pesan sudah masuk antrean, belum terkirim. Jika ada yang salah, API mengembalikan HTTP 400 dengan "status": 0 dan message seperti Auth Error: invalid api key atau Invalid phone number. Beberapa alat menghentikan alur kerja saat menerima respons 400; buka output langkah tersebut untuk membaca message. Daftar lengkapnya ada di Kirim pesan → Error.

Untuk mengetahui kapan pesan benar-benar terkirim, sertakan URL webhook (misalnya pemicu webhook di alat yang sama). URL tersebut menerima POST dengan encoding form berisi msg_id dan status bernilai SENT atau FAILED. Lihat Webhook.

Pabbly Connect#

  1. Tambahkan action API

    Di alur kerja Anda, tambahkan langkah action, pilih aplikasi API (Pabbly) dan action event Execute API Request.

    Alur kerja Pabbly Connect dengan pemicu Google Sheets New or Updated Spreadsheet Row dan action API (Pabbly) Execute API Request

  2. Konfigurasikan permintaan

    Atur Action Event Method ke POST, API Endpoint URL ke https://wbiztool.com/api/v1/send_msg/, Payload Type ke Form Data atau JSON, dan Authentication ke No Auth.

    Permintaan API Pabbly Connect dengan metode POST, URL send_msg Wbiztool, payload type Form Data, dan No Auth

  3. Atur parameter

    Centang Set Parameters dan tambahkan satu baris per field body: client_id, api_key, whatsapp_client, phone, country_code, msg, dan msg_type. Petakan phone dan msg dari pemicu Anda.

    Set Parameters di Pabbly Connect dengan baris client_id, api_key, whatsapp_client, phone, msg_type, dan msg

    Tangkapan layar ini tidak menyertakan country_code karena nomor uji sudah menyertakannya.

  4. Simpan dan kirim permintaan uji

    Pastikan respons berisi "status": 1.

Albato#

  1. Tambahkan action HTTP

    Di otomatisasi Anda, tambahkan action dan pilih HTTP Request/Outgoing webhook, lalu action Send request-nya. Misalnya, gunakan pemicu Google Sheets New row created untuk mengirim pesan untuk setiap baris baru.

    Dialog Add an action di Albato dengan HTTP Request/Outgoing webhook di bagian atas daftar aplikasi

  2. Buat koneksi

    Beri nama koneksi, seperti „Wbiztool“. Anda dapat memasukkan https://wbiztool.com/api/v1/send_msg/ sebagai URL-nya dan mengatur content type ke JSON.

  3. Petakan field Anda

    Atur URL ke https://wbiztool.com/api/v1/send_msg/ (jika dikosongkan, URL koneksi yang digunakan) dan Request method ke POST. Di bawah Request parameters, tambahkan client_id, api_key, whatsapp_client, msg_type, country_code, phone, dan msg, lalu pilih phone dan msg dari field pemicu Anda.

    Map your fields di Albato dengan URL send_msg Wbiztool dan request method POST

    Request parameters di Albato, dengan phone dipetakan ke kolom Google Sheets dari pemicu

    Tangkapan layar ini menggunakan message, yang berfungsi sebagai pengganti msg. Tangkapan layar ini tidak menyertakan country_code karena nomor uji sudah menyertakannya.

  4. Uji dan mulai

    Jalankan uji, pastikan respons berisi "status": 1, lalu mulai otomatisasi.

    Otomatisasi Albato dengan Step 1 Google Sheets New row created dan Step 2 HTTP Request Wbiztool Send request

Activepieces#

  1. Tambahkan piece HTTP

    Klik + setelah pemicu Anda dan pilih HTTP → Send HTTP request.

  2. Konfigurasikan permintaan

    Atur Method ke POST dan URL ke https://wbiztool.com/api/v1/send_msg/. Pilih JSON atau Form Data sebagai Body Type.

    Langkah Send HTTP request di Activepieces dengan metode POST, URL send_msg Wbiztool, dan body type Form Data

  3. Tambahkan field body

    Tambahkan satu item per field. Gunakan Data Selector untuk menyisipkan nilai dari pemicu Anda ke phone dan msg. Jika phone sudah menyertakan kode negara (misalnya 919876543210), Anda dapat menghilangkan country_code.

  4. Uji langkahnya

    Klik Test Step dan pastikan respons berisi "status": 1, lalu publikasikan flow.

Make#

Gunakan modul HTTP Make dengan action Make a request. Atur metode ke POST, URL ke https://wbiztool.com/api/v1/send_msg/, jenis body ke JSON (raw, content type application/json) atau form data, lalu isi field body di atas.

Pemecahan masalah#

MasalahYang perlu diperiksa
Auth Error: invalid api keyKey sudah dihapus, salah ketik, atau milik workspace yang berbeda dari client_id.
Invalid whatsapp client atau Invalid whatsapp client id.Gunakan WhatsApp Client ID dari WhatsApp settings. Field ini wajib kecuali workspace Anda memiliki tepat satu nomor yang terhubung.
Invalid phone numberNilainya berisi huruf atau simbol selain spasi, titik, tanda hubung, tanda kurung, dan +, atau memiliki kurang dari 6 atau lebih dari 17 digit. Petakan kolom telepon, bukan kolom nama.
Invalid Contact Number "…"Nomor lebih dari 15 digit setelah kode negara ditambahkan. Pastikan nilai telepon belum menyertakan kode negara lain.
Either phone or group_name parameter is requiredNilai telepon yang dipetakan kosong pada eksekusi ini.
Msg cant be nullField pesan yang dipetakan kosong pada eksekusi ini.
Image Url Can't be null atau File Url Can't be nullmsg_type adalah 1 atau 2, tetapi img_url atau file_url yang dipetakan kosong pada eksekusi ini.
Invalid file url, Can't download atau Invalid file urlURL tidak mengembalikan file. URL harus publik: tautan yang memerlukan login, seperti tautan Google Drive pribadi, tidak berfungsi.
Respons berisi "status": 1 tetapi tidak ada yang sampaiPesan berada di antrean sampai nomor WhatsApp Anda terhubung. Periksa WhatsApp settings dan Status pesan.