API WA Gateway Billingotomatis
WA Gateway merupakan layanan dari billingotomatis, detail tentang layanan ini bisa di cek di:
https://www.domosquare.com/blog/berita/hai-kenalan-sama-wa-gateway-billingotomatis-yuk/
Sebelum menggunakan WA Gateway pada WHMCS, Anda perlu mengordernya dahulu , ada bisa mengorder di halaman:
https://www.domosquare.com/manage/cart.php?gid=20
Untuk setup awalnya, Anda bisa baca tutorialnya di halaman berikut:
https://www.domosquare.com/tutorial/billingotomatis/cara-order-dan-penggunaan-wa-gateway-billingotomatis.html
Setelah informasi API Anda dapatkan, jika Anda menggunakan CMS berikut Anda bisa dengan mudah mengintegrasikan module yang sudah disediakan billingotomatis.com:
- WordPress
https://www.domosquare.com/tutorial/billingotomatis/cara-menggunakan-wa-gateway-billingotomatis-pada-wordpress.html - Woocommerce
https://www.domosquare.com/tutorial/billingotomatis/whatsapp-gateway-untuk-woocommerce-dan-cara-menggunakannya.html - WHMCS
https://www.domosquare.com/tutorial/billingotomatis/integrasi-notifikasi-whatsapp-gateway-otomatis-billingotomatis-dengan-whmcs.html
Namun jika Anda ingin mengembangkan sendiri, maka tidak ada masalah ada pilihan penggunaan API untuk Anda.
Cara penggunaan nya pun sangat mudah, pastikan Anda persiapkan data berikut sebelum menggunakan API:
- api_server
- api_id
- api key
Ketiga informasi diatas bisa Anda dapatkan pada halaman produk WA Gateway di member area Domosquare.com.
Mengirimkan Pesan via API
API URL:
https://api_server/
Parameter POST/GET:
api_id
api_key
phone
text
Parameter phone dan text adalah nomor WA tujuan, dan pesan yang ingin dikirimkan.
Contoh:
Anda memiliki informasi API:
API Server: wa.bilo.com
API ID: 1234
API Key: XyXyxyZZ
Anda ingin mengirim pesan WA ke 087654321 dengan pesan Hallo ini WA Otomatis.
Maka panggilan API nya adalah sebagai berikut:
<?php $var['api_id'] = '1234'; $var['api_key'] = 'XyXyxyZZ'; $var['phone'] = '087654321'; $var['text'] = 'Hallo ini WA Otomatis'; $ch = curl_init('https://wa.bilo.com'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $var); $response = curl_exec($ch); curl_close($ch); var_dump($response); ?>
Atau jika Anda ingin panggil di browser secara langsung juga bisa
https://wa.bilo.com/?api_id=1234&api_key=XyXyxyZZ&phone=087654321&text=Hallo ini WA Otomatis
Nah, mudahkan
Mengirim pesan WA dengan gambar/attachment
Nah jika ANda mengirim pesan attachment bisa dengan cara menambahkan parameter mime, filename, filedata. Filedata merupakan base64encode dari file yang akan dikirimkan.
Berikut contoh mengirimkan WA dengan pesan gambar:
<?php $var['api_id'] = '1234'; $var['api_key'] = 'XyXyxyZZ'; $var['phone'] = '087654321'; #mengirimkan gambar/attachment $var['mime'] = 'image/png'; $var['filename'] = 'gambar.png'; $var['filedata'] = base64_encode(file_get_contents('/path/to/photo.png')); #jika pakai caption bisa tambahkan variable text $var['text'] = 'Hallo ini gambar via WA Gateway'; $ch = curl_init('https://wa.bilo.com'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $var); $response = curl_exec($ch); curl_close($ch); var_dump($response); ?>
Mengiriman Pesan Button
Untuk pesan button sifat nya experimental, pastikan anda berkala cek apakah pesan button dapat dikirim dan dapat diterima disemua versi whatsapp.
Pesan button merupakan pesan yang memungkinkan menambahkan button atau tombol pada pesan whatsapp.
Ada 4 jenis button yang disupport saat ini:
- Button biasa (jadi hanya text saja)
- Button dengan id.
Jika button ini diklik maka id button yang di klik akan dikirim pada balasan, dan id yang di klik akan diteruskan ke callback hooks dengan key: button_clicked - Button dengan url.
Button ini saat diklik akan membuka URl tertentu. - Button dengan number.
Button ini jika diklik akan mengarah kepada nomor tertentu.
Untuk pengiriman, ada 2 cara mengirimkan pesan button pada request API:
- Dengan cara menambahkan parameter button_list dan parameter type dengan value button pada request API.
- Dengan cara menambahkan tag
Untuk contoh pertama bisa dilakukan seperti ini:
https://wa.bilo.com/?api_id=1234&api_key=XyXyxyZZ&phone=087654321&text=Hallo ini WA Otomatis&type=button&button_list=
Adapun contoh penulisan untuk value button_list, setiap button dipisah dengan dua buah asterik (**), dan setiap button memiliki struktur sebagai berikut:
Text button|value button|tipe button
Jadi antara text button dan value button, serta tipe button dipisah oleh vertical line (|).
Contoh penulisannya adalah sebagai berikut, jika memakai tag [button_list] pada pesan biasa. Semua didalam button list ini nanti akan menjadi tombol.
Hai, Ini merupakan pesan whatsapp otomatis untuk Anda! [button_list] **Buka website|https://www.billingotomatis.com/|url **Hubungi CS|+62123456789|number [/button_list]
Atau jika ingin dengan request via URL langsung bisa seperti:
https://wa.bilo.com/?api_id=1234&api_key=XyXyxyZZ&phone=087654321&text=Hallo ini WA Otomatis&type=button&button_list=**Buka website|https://www.billingotomatis.com/|url**Hubungi CS|+62123456789|number
Untuk button call dan URL saat ini tidak support pada versi iOS.
Jika Ada kendala, atau ingin informasi lebih lanjut Anda bisa hubung billingotomatis@domosquare.com.