Tutorial

Menerima dan menangani pesan webhook

 

Dengan webhook kamu bisa menerima notifikasi saat ada sesuatu yang terjadi pada bot trading. Di tutorial ini, kamu akan belajar cara memverifikasi webhook dan mulai menerima serta mengelola pesan webhook dari API. Dalam tutorial ini, kita akan menggunakan bahasa PHP untuk membuat webhook, tapi kamu juga bisa membuat webhook dengan bahasa pemrograman lainnya. Tentu saja, kamu memerlukan server publik tempat kita bisa mengirim pesan webhook, dan server publik tersebut harus dilindungi dengan sertifikat SSL, dan harus bisa diakses melalui https. Kamu juga memerlukan sebuah aplikasi di Cryptohopper, jika kamu belum membuat aplikasi, silakan ke Apps dan buat aplikasi pertama kamu.

Mempersiapkan webhook kamu

Sebelum kita mengonfigurasi dan menghubungkan webhook ke aplikasi kamu, kita akan mempersiapkan webhook di server kamu. Salin kode PHP di bawah ini dan letakkan di folder publik server kamu. Mari kita beri nama webhook.php.


Pastikan untuk menyesuaikan variabel rahasia aplikasi dan variabel kode verifikasi. Rahasia aplikasi bisa ditemukan saat kamu mengedit aplikasi kamu, dan kode verifikasi bisa berupa apa saja yang kamu inginkan. Pastikan kamu mengingat kode verifikasi, karena kamu akan membutuhkannya saat ingin memverifikasi webhook kamu.

Konfigurasi webhook kamu di aplikasi

Setelah kamu membuat webhook di server, kita bisa mengonfigurasi webhook di aplikasi kamu. Buka Apps, pilih aplikasi kamu, dan klik tab "webhook". Klik "Tambahkan webhook" dan mulai masukkan URL webhook kamu (dengan https). Selanjutnya, kamu bisa mengonfigurasi jenis pesan yang ingin kamu terima dengan memilih langganan. Terakhir, kamu perlu memasukkan kode verifikasi yang telah kamu masukkan di kode PHP di server, harus sama persis. Klik validasi dan simpan, webhook kamu sekarang akan muncul di daftar webhook yang terhubung.

Menerima pesan webhook

Karena kode PHP dalam contoh didesain hanya untuk menampilkan dan mencetak pesan webhook, kamu tidak akan langsung melihat apakah kode webhook kamu berfungsi. Oleh karena itu, kita perlu melakukan beberapa penyesuaian pada kode PHP untuk meneruskan pesan webhook ke email atau, misalnya, menyimpan pesan dalam database. Keputusan ada di tanganmu, terserah kamu apa yang ingin kamu lakukan dengan pesan webhook.

Untuk meneruskan pesan webhook sebagai notifikasi ke email kamu, kamu bisa menggunakan dan menyesuaikan kode PHP dalam contoh berikut.

'.$message['type'];
            $email_message .= 'Judul:
'.$message['title']; $email_message .= '

'; $email_message .= 'Pesan:
'.$message['message']; mail($send_to_email, $subject_email, $email_message); } } }else{ // unkown type echo 'Tipe pesan webhook tidak diketahui.'; } }else{ //invalid signature echo 'Tanda tangan tidak valid.'; } ?>

Pastikan untuk mengedit variabel dalam contoh di atas agar sesuai dengan kebutuhan kamu. Jika kamu memerlukan informasi lebih lanjut tentang kemungkinan webhook, silakan periksa dokumentasi API Webhooks untuk informasi lebih lanjut.