Webhook TradingView
Apa Itu Webhook TradingView dan Bagaimana Cara Kerjanya?
Webhook memungkinkan alert TradingView mengirim pesan secara otomatis ke URL tujuan ketika kondisi alert terpenuhi. Botconnector menggunakan pesan tersebut untuk memilih route dan menyiapkan instruksi menuju terminal MetaTrader pengguna.
Webhook tidak perlu mengetahui login atau password akun MetaTrader. Login tetap dilakukan langsung pada terminal MetaTrader di PC atau VPS Windows pengguna.
1. Pengertian webhook TradingView
Webhook adalah cara sebuah sistem mengirim data ke sistem lain melalui sebuah URL. Dalam penggunaan TradingView, alert yang terpicu dapat mengirimkan permintaan ke Webhook URL yang sudah ditentukan. Isi permintaan berasal dari kolom Message pada alert.
Webhook berbeda dari notifikasi biasa. Notifikasi hanya memberi tahu pengguna, sedangkan webhook dapat mengirimkan pesan ke aplikasi penerima agar pesan tersebut diperiksa dan diproses lebih lanjut.
Webhook bukan strategy trading. Kondisi sinyal tetap ditentukan oleh indikator, Pine, atau strategy yang digunakan pada TradingView.
2. Cara kerja webhook TradingView dengan Botconnector
Kondisi alert TradingView terpenuhi
↓
Message dikirim ke Webhook URL
↓
Botconnector memeriksa format pesan
↓
Botconnector memilih route simbol dan terminal
↓
Botconnector Agent mengambil instruksi
↓
Terminal MetaTrader tujuan
- TradingView mendeteksi bahwa kondisi alert telah terpenuhi.
- TradingView mengirimkan Message ke Webhook URL yang disimpan pada alert.
- Botconnector memeriksa apakah URL masih berlaku dan format pesan dikenali.
- Botconnector mencocokkan simbol sumber dengan route pengguna.
- Pada LIVE, instruksi yang valid disiapkan untuk Agent dan terminal tujuan. Pada CAPTURE, event dicatat tanpa diteruskan sebagai instruksi transaksi.
3. Perbedaan Webhook URL dan Message
Webhook URL
Webhook URL menentukan ke mana TradingView mengirim alert. URL pelanggan dibuat melalui Dashboard Botconnector dan harus ditempel secara utuh.
URL tersebut mengandung identitas dan secret webhook. Karena itu URL tidak boleh dipublikasikan.
Message
Message adalah isi alert yang dikirim ke Botconnector. Message dapat berasal dari Pine, strategy, atau format lain yang memang sudah didukung dan diuji.
Pesan yang tidak dikenali akan ditolak dan tidak diteruskan ke terminal MetaTrader.
Webhook URL:
[URL rahasia dari Dashboard Botconnector]
Message:
[Pesan dari Pine atau strategy yang didukung]
Lihat panduan format alert TradingView yang didukung.
4. Cara memasang Webhook URL pada alert
- Masuk ke Dashboard Botconnector dan buat webhook pelanggan.
- Salin URL webhook yang ditampilkan. Jangan mengubah karakter, garis miring, atau secret pada URL.
- Buka pembuatan alert pada TradingView dan pilih kondisi indikator atau strategy yang benar.
- Aktifkan bagian Webhook URL dan tempel URL dari Dashboard Botconnector.
- Isi Message persis sesuai format yang dibutuhkan Pine atau strategy.
- Simpan alert, lalu lakukan satu pengujian melalui CAPTURE.
Satu webhook pelanggan dapat memiliki beberapa route pair. Setiap route harus mengarah ke simbol broker dan terminal yang benar.
5. Cara menjaga keamanan webhook
Jangan membagikan URL
Jangan menampilkan URL webhook pada screenshot, grup, video, siaran langsung, atau dokumen publik.
Ganti secret bila bocor
Bila URL terlihat oleh pihak lain, gunakan fungsi penggantian secret. Setelah secret diganti, URL lama tidak berlaku dan alert TradingView harus diperbarui.
Pisahkan dari password broker
Secret webhook bukan password akun broker. Botconnector tidak memerlukan password MetaTrader pada URL atau Message.
Gunakan URL HTTPS
Gunakan URL HTTPS yang tersedia pada Dashboard dan hindari menyalin URL dari sumber yang tidak dipercaya.
6. Mengapa harus menguji CAPTURE terlebih dahulu?
CAPTURE memisahkan pemeriksaan penerimaan webhook dari tindakan transaksi. Ketika CAPTURE aktif, Botconnector dapat menerima serta mencatat event tanpa meneruskan instruksi transaksi ke MetaTrader.
- Periksa apakah event muncul pada Activity Log.
- Periksa apakah format pesan dikenali.
- Periksa simbol sumber dan route tujuan.
- Periksa Agent online dan terminal READY.
- Aktifkan LIVE hanya setelah semua pemeriksaan selesai.
Baca cara memasang dan memeriksa Botconnector Agent.
7. Penyebab webhook TradingView tidak bekerja
URL tidak lengkap atau sudah lama
Karakter URL terpotong atau secret sudah diganti sehingga TradingView masih memakai URL lama.
Alert tidak pernah terpicu
Kondisi indikator atau strategy belum terpenuhi, alert dihentikan, atau alert sudah kedaluwarsa.
Message tidak dikenali
Format berubah karena tambahan kata, emoji, baris, atau susunan yang tidak didukung.
CAPTURE dianggap sebagai kegagalan
Event berstatus paused_captured berarti event diterima tetapi memang tidak diteruskan sebagai transaksi.
Route belum sesuai
Simbol sumber tidak cocok, simbol broker salah, route tidak aktif, atau terminal tujuan belum dipilih.
Agent atau terminal tidak siap
Agent offline, MetaTrader tidak terhubung, Algo Trading tidak aktif, atau terminal belum menunjukkan READY.
Buka pemeriksaan lengkap alert yang tidak masuk.
Pertanyaan umum tentang webhook TradingView
Apakah webhook langsung membuka transaksi?
Tidak selalu. Pada Botconnector, pesan terlebih dahulu diperiksa, dicocokkan dengan route, dan dipengaruhi oleh mode CAPTURE atau LIVE serta kesiapan Agent dan terminal.
Apakah satu webhook dapat dipakai untuk banyak pair?
Ya. Satu webhook dapat memiliki beberapa route selama setiap simbol sumber, simbol broker, dan terminal tujuan sudah dipetakan dengan benar.
Apa yang dilakukan bila URL webhook terlihat orang lain?
Ganti secret melalui Dashboard, lalu perbarui Webhook URL pada seluruh alert TradingView yang masih menggunakan URL lama.
Apakah password MetaTrader dimasukkan ke webhook?
Tidak. Password tetap digunakan langsung pada terminal MetaTrader pengguna dan tidak dimasukkan ke Webhook URL maupun Message.