Penguji Webhook Discord

Uji webhook Discord kamu dalam hitungan detik. Tempel URL-nya, validasi, lalu kirim pesan uji untuk memastikan semuanya berfungsi.

Apa itu webhook Discord?

Webhook Discord adalah URL unik yang memungkinkan kamu mengirim pesan ke channel Discord tertentu tanpa perlu bot. Webhook umum dipakai untuk notifikasi GitHub, peringatan pemantauan server, pembaruan pipeline CI/CD, dan integrasi khusus. Setiap webhook punya nama dan avatar sendiri, serta terhubung ke satu channel tertentu.

Cara membuat webhook Discord

1. Buka server Discord kamu lalu masuk ke Pengaturan Server
2. Masuk ke Integrasi > Webhook
3. Klik Webhook Baru
4. Beri nama dan pilih channel tujuan
5. Klik Salin URL Webhook
6. Tempel URL-nya ke penguji di atas untuk memastikan berfungsi

Cara kerja penguji ini

Tempel URL webhook kamu lalu klik Periksa. Alat ini memvalidasi URL ke API Discord dan menampilkan nama, avatar, serta channel yang terhubung. Kalau valid, kamu bisa mengetik pesan sendiri dan mengirimnya lewat webhook untuk memastikan semuanya bekerja. URL webhook kamu diteruskan lewat server kami demi keamanan (peramban tidak bisa memanggil API Discord langsung karena CORS), tetapi tidak pernah disimpan atau dicatat.

Kode error webhook Discord yang umum

Saat permintaan webhook gagal, Discord mengembalikan status HTTP dengan body JSON berisi code numerik dan message. Ini yang benar-benar akan kamu temui:

• 400 Bad Request - Body JSON rusak, embed melebihi total 6.000 karakter, atau panjang sebuah field melewati batasnya. Validasi payload kamu secara lokal sebelum mengirim.
• 401 Unauthorized - Token webhook salah atau sudah dibuat ulang. Membuat ulang webhook di pengaturan server langsung membatalkan URL lama.
• 404 Not Found - Webhook dihapus, channel dihapus, atau ada salah ketik di URL. Salin ulang URL dari Pengaturan Server > Integrasi.
• 429 Too Many Requests - Kamu kena batas laju. Discord mengembalikan field retry_after (dalam detik) yang memberitahu kapan harus mencoba lagi. Patuhi itu.
• Code 50027 (Invalid Webhook Token) - Akar masalahnya sama dengan 401, muncul saat bagian token pada URL rusak atau terpotong.
• Code 50006 (Cannot send empty message) - Payload kamu tidak punya content, embeds, maupun files. Setidaknya salah satu wajib ada.
• Code 50035 (Invalid Form Body) - Penyebab paling umum: embed.color dikirim sebagai string heksadesimal, bukan bilangan bulat desimal. Ubah #9B59B6 menjadi 10181046 sebelum mengirim.

Batas laju webhook Discord

Discord menerapkan batas laju per webhook dan per channel, dan ukuran bucket-nya ditentukan di sisi server lalu disajikan lewat header respons, bukan sebagai angka tetap. Setiap respons sukses berisi X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset-After - baca itu untuk menjadwalkan permintaan berikutnya, jangan menuliskan laju tetap di kode. Body respons 429 juga membawa nilai retry_after (dalam detik). Untuk integrasi bervolume tinggi (pipeline build, agregasi log), gabungkan beberapa peristiwa ke dalam satu pesan: satu panggilan webhook bisa membawa hingga 10 embed dengan total 6.000 karakter per embed, yang biasanya cukup untuk merangkum ledakan peristiwa jadi satu permintaan.

Praktik terbaik keamanan webhook

URL webhook adalah kredensial pembawa. Siapa pun yang punya URL lengkapnya bisa memposting ke channel kamu sebagai bot webhook, tanpa autentikasi lain. Perlakukan seperti kata sandi:

• Jangan pernah commit URL webhook ke repositori Git publik. Pemindaian rahasia GitHub mendeteksi dan mencabut webhook Discord yang bocor secara otomatis, tetapi hanya setelah webhook itu terlanjur terekspos.
• Simpan URL webhook di variabel lingkungan atau pengelola rahasia, bukan di kode sumber atau berkas konfigurasi yang masuk kontrol versi.
• Kalau sebuah webhook terekspos, hapus segera di Pengaturan Server > Integrasi > Webhook. Membuatnya ulang menghasilkan token baru; URL lama berhenti berfungsi.
• Untuk pemakaian di sisi klien (aplikasi peramban yang memposting ke Discord), teruskan panggilan lewat backend kamu sendiri supaya URL tidak pernah sampai ke peramban pengguna. URL yang bocor dari aplikasi peramban adalah magnet vandalisme.
• Webhook Discord mengabaikan mention @everyone dan @here kecuali allowed_mentions mengizinkannya secara eksplisit. Setel "parse": [] untuk mematikan semua ping mention kalau kamu tidak membutuhkannya.

Uji webhook manual dengan curl

Kalau kamu lebih suka menguji dari terminal, payload paling minim adalah satu field content. POST yang sukses mengembalikan HTTP 204 dengan body kosong, atau HTTP 200 dengan JSON pesan yang dibuat kalau kamu menambahkan ?wait=true ke URL. Pakai ?wait=true saat kamu butuh ID pesannya kembali (misalnya untuk menyunting atau menghapus pesan itu nanti lewat endpoint /webhooks/<id>/<token>/messages/<message_id>).

Alat Discord gratis lainnya

• Snowflake Checker - Cek umur akun Discord mana pun
• Colored Text Generator - Buat pesan berwarna dengan kode ANSI
• Message Length Counter - Cek apakah pesan kamu muat di batas Discord
• Color Role Previewer - Pratinjau warna role di semua tema Discord

Didukung oleh Pigona - Terjemahan gratis untuk Discord