Publikasi otomatis klip Twitch baru di Discord melalui EventSub
Untuk siapa posting otomatis klip Twitch di Discord cocok digunakan
Integrasi bawaan Twitch dan Discord membantu menampilkan status streaming, memberikan role, dan memberi tahu tentang dimulainya siaran. Klip baru biasanya tidak dipublikasikan secara otomatis ke kanal teks. Untuk itu diperlukan bot siap pakai, layanan otomatisasi, atau rangkaian Twitch EventSub dan Discord webhook buatan sendiri.
Solusi siap pakai cocok jika Anda tidak perlu melakukan pengembangan: Anda menghubungkan Twitch dan Discord, memilih kanal, dan mengatur templat. Sebelum memulai, pastikan bahwa layanan tersebut bereaksi tepat terhadap pembuatan klip, bukan hanya terhadap dimulainya siaran. Kekurangan solusi siap pakai adalah ketergantungan pada tarif, filter yang tersedia, dan tampilan pesan.
Pilih skema publikasi sebelum mengatur Twitch
Untuk pengujian cepat, buat kanal Discord privat dan uji beberapa klip secara manual. Ini akan membantu melihat jeda, memeriksa kartu tautan, dan memahami apakah ada pesan tentang klip yang tidak seharusnya masuk ke komunitas.
- Bot siap pakai lebih cepat dihubungkan, tetapi mungkin tidak mendukung kondisi publikasi yang diperlukan dan format embed khusus.
- Konstruktor otomatisasi memungkinkan penambahan percabangan dan filter, tetapi sebagian pemicu dan aksi mungkin dibatasi oleh paket layanan.
- Handler EventSub buatan sendiri memberikan kendali atas antrean, templat, log, dan perlindungan dari duplikat, tetapi memerlukan server, OAuth, dan pemeliharaan kode.
Tentukan aturan terlebih dahulu: publikasikan semua klip, hanya klip milik pemilik kanal, klip dari moderator, atau tautan setelah persetujuan manual. Kekurangan penyaringan yang ketat adalah momen bagus yang dibuat oleh penonton bisa tetap tidak dipublikasikan.
Buat Discord webhook untuk kanal berisi klip
Webhook dibuat di pengaturan kanal teks Discord yang diinginkan. Untuk itu diperlukan izin mengelola webhook. Webhook mengirim pesan dengan nama dan avatar yang ditentukan, sehingga akun Discord terpisah untuk publikasi dasar tidak diperlukan.
- Buka pengaturan kanal teks tempat klip akan masuk.
- Masuk ke bagian integrasi dan temukan webhook.
- Buat webhook baru, tentukan nama yang jelas, dan unggah avatar jika perlu.
- Salin URL dan simpan di variabel lingkungan atau penyimpanan yang aman.
- Kirim pesan uji ke kanal privat.
URL webhook adalah rahasia. Siapa pun yang mendapatkan tautan ini dapat mengirim pesan ke kanal atas nama webhook. Jangan menambahkan alamat tersebut ke repositori publik, tangkapan layar panel, atau kode klien. Jika terjadi kebocoran, hapus webhook dan buat yang baru: mengganti URL pada alamat lama saja tidak cukup.
Hubungkan peristiwa pembuatan klip melalui Twitch EventSub
Dalam skema buatan sendiri, Twitch mengirim peristiwa channel.clip.created ke alamat HTTPS handler Anda. Handler memverifikasi permintaan, menyimpan data klip, menyusun pesan, dan meneruskannya ke Discord webhook. Akun Twitch tidak mendapatkan akses ke server Discord.
Untuk berlangganan diperlukan aplikasi Twitch, ID kanal, callback URL, dan otorisasi yang sesuai dengan jenis peristiwa yang dipilih. Persyaratan token dan izin sebaiknya dicocokkan dengan dokumentasi EventSub terbaru: persyaratan tersebut dapat berubah. Jangan gunakan parameter otorisasi dari contoh lama tanpa memeriksanya.
Token pengguna milik pemilik kanal dapat kedaluwarsa atau dicabut. Kekurangan skema ini adalah refresh token harus disimpan dengan aman dan akses diperbarui tepat waktu. Jika pembaruan tidak berfungsi, langganan atau pembuatan langganan baru dapat berhenti berfungsi tanpa kesalahan yang terlihat di Discord.
Siapkan alamat HTTPS untuk notifikasi Twitch
Callback URL harus dapat diakses dari internet melalui HTTPS. Saat membuat langganan, Twitch mengirim permintaan verifikasi dengan tipe webhook_callback_verification. Server harus memastikan keaslian permintaan dan mengembalikan nilai challenge sebagai teks biasa. Selama tahap ini belum berhasil, langganan tidak akan aktif.
Peristiwa kerja datang dengan tipe notification. Untuk peristiwa tersebut, sebaiknya segera kembalikan respons HTTP yang berhasil, lalu teruskan publikasi ke antrean atau handler terpisah. Jika menunggu respons Discord di dalam permintaan EventSub, jeda jaringan meningkatkan risiko pengiriman ulang notifikasi.
Untuk pengembangan lokal, Anda dapat menggunakan tunnel HTTPS. Kekurangannya adalah alamat publik dapat berubah setelah restart. Tunnel berguna untuk pengujian, tetapi tidak menggantikan endpoint permanen untuk otomatisasi yang berjalan.
Verifikasi tanda tangan berdasarkan body permintaan asli
Tanda tangan EventSub dibentuk dari ID pesan, waktu pengiriman, dan body permintaan HTTP asli. Pertama, dapatkan byte body, simpan tanpa perubahan, lalu verifikasi HMAC. Anda tidak boleh mengurai JSON dan menyusunnya kembali sebelum verifikasi tanda tangan. Urutan field, spasi, atau encoding dapat berubah, dan tanda tangan yang dihitung tidak akan cocok.
Untuk verifikasi diperlukan header Twitch-Eventsub-Message-Id, Twitch-Eventsub-Message-Timestamp, dan Twitch-Eventsub-Message-Signature. String untuk HMAC SHA-256 disusun sebagai berikut: messageId + timestamp + rawBody. Sebagai kunci digunakan secret yang ditentukan saat membuat langganan. Hasil dalam bentuk heksadesimal dibandingkan dengan nilai header yang diawali dengan sha256=.
Di Node.js logikanya seperti ini: buat HMAC SHA-256 dengan secret langganan, masukkan messageId + timestamp + rawBody, tambahkan awalan sha256= pada hash, dan bandingkan dengan Twitch-Eventsub-Message-Signature melalui crypto.timingSafeEqual. Sebelum membandingkan, periksa bahwa panjang string sama, jika tidak perbandingan aman akan gagal.

Periksa jenis pesan dan waktu pengirimannya
Verifikasi HMAC diperlukan untuk setiap permintaan EventSub, termasuk callback verification, notification, dan revocation. Hanya setelah verifikasi berhasil, baca JSON dan tentukan jenis pesan berdasarkan header Twitch-Eventsub-Message-Type. Untuk callback verification, kembalikan challenge; untuk notification, buat tugas publikasi; untuk revocation, catat alasan penonaktifan langganan ke log.
Selain itu, cocokkan waktu dari Twitch-Eventsub-Message-Timestamp dengan waktu server saat ini. Jendela penerimaan yang terbatas membantu menyaring permintaan lama yang dikirim ulang oleh pihak ketiga. Pemeriksaan ini tidak menggantikan HMAC: timestamp dapat dibaca dari permintaan, tetapi tanpa secret tanda tangan yang valid tidak dapat dibuat.
Simpan secret langganan terpisah dari kode dan URL Discord webhook. Kekurangan penggantian secret secara sering tanpa prosedur pembaruan adalah langganan yang ada akan berhenti lolos verifikasi. Buat atau perbarui langganan terlebih dahulu, lalu ganti secret di handler.
Jangan publikasikan satu klip dua kali
EventSub dapat mengirim ulang satu notifikasi jika endpoint merespons terlalu lama, koneksi terputus, atau terjadi kesalahan jaringan. Simpan Twitch-Eventsub-Message-Id di basis data permanen dengan indeks unik. Jika ID tersebut sudah diproses, jangan buat tugas kedua dan kembalikan respons yang berhasil.
Tambahkan kunci unik kedua berdasarkan ID klip dari data peristiwa. Ini melindungi dari publikasi ulang ketika video yang sama datang dalam notifikasi berbeda atau tugas dijalankan ulang setelah kegagalan. Coba catat clip_id ke tabel klip yang telah dipublikasikan terlebih dahulu, dan hanya setelah pencatatan berhasil, kirim pesan ke Discord.
Skema ini memiliki kekurangan: kegagalan antara pencatatan clip_id dan pengiriman webhook dapat membuat klip ditandai sebagai sudah dipublikasikan tanpa pesan di Discord. Untuk kasus seperti itu, simpan status tugas: dibuat, sedang dikirim, dipublikasikan, kesalahan. Tugas dengan status kesalahan dapat diulang secara manual atau sesuai aturan antrean.
Susun pesan embed untuk Discord
Dalam pesan, sebaiknya sertakan judul klip, nama pembuat, nama kanal, kategori, dan tautan langsung. Jangan menyisipkan teks dari Twitch ke JSON secara manual melalui penggabungan string: tanda kutip dan karakter khusus dapat merusak permintaan. Bentuk objek menggunakan fitur bahasa dan kirim sebagai JSON.
Templat embed dapat terlihat seperti ini: judul «Klip baru di kanal», deskripsi «Pembuat: {creator_name}», URL «{clip_url}», field «Judul» dengan nilai «{clip_title}», field «Kategori» dengan nilai «{game_name}». Jika dalam peristiwa tidak ada kategori atau nama pembuat, biarkan field kosong atau jangan tambahkan field tersebut.
Anda dapat menambahkan mention role, tetapi jangan mengirimnya pada setiap klip tanpa batasan. Kekurangan notifikasi terus-menerus adalah anggota server akan mulai mematikan kanal atau role. Untuk kanal yang aktif, sebaiknya publikasikan klip tanpa ping atau mention role hanya berdasarkan aturan terpisah.
Uji skenario sebelum publikasi di kanal utama
Pertama, gunakan kanal Discord pengujian dan buat beberapa klip dengan judul, pembuat, dan kategori berbeda. Periksa apakah callback verification berhasil, apakah tanda tangan divalidasi sebelum penguraian JSON, apakah muncul satu kartu per clip_id, dan apakah pesan tidak dipublikasikan saat EventSub dikirim ulang.
- Periksa bahwa server membaca raw body sebelum JSON parser atau menyimpan byte permintaan asli.
- Pastikan challenge dikembalikan hanya setelah verifikasi Twitch-Eventsub-Message-Signature berhasil.
- Periksa penanganan kesalahan Discord webhook dan pengulangan tugas tanpa membuat pesan kedua.
- Tinjau log berdasarkan message ID, clip_id, jenis pesan EventSub, dan status pengiriman.
Jangan catat secret langganan, token OAuth, dan URL Discord webhook lengkap ke log. Untuk diagnostik, cukup ID peristiwa, ID klip, kode respons Discord, dan teks kesalahan teknis tanpa header rahasia.
Last Articles
Apa yang Berubah dalam Desain dan Fungsionalitas Kami telah memperbarui situs agar bekerja lebih cepat dan nyaman. Perubahan utama menyangkut antarmu..
Good afternoon, I've collected all the news during this time.: 1. The main news is that prices for twitch viewers have been greatly reduced, while Tw..
1. Gunakan kode promo "December2025" untuk diskon 15% untuk semua penonton kami2. Kami telah menurunkan harga dasar untuk konfigurator dan kategori pe..
Layanan Twitch adalah bekerja dengan stabil, jadi kami siap bekerja sama dengan regu, reseller, pemilik layanan, pemilik bot, dan banyak lainnya.K..
Kami telah sepenuhnya memperbarui layanan penampil Twitch kami, dan sekarang sudah tersedia bekerja dengan stabil. Kami hanya menggunakan alamat I..
Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..
Greetings, I have compiled a guide for streamers, which will be very relevant at the moment. Now YouTube and twitch have disabled monetization from vi..
We have finally developed the APINow it will be more convenient for our partner sites to work with us.To update the maximum tariffs for YouTube, an up..
Karena popularitas besar layanan kemitraan dan program rujukan, kami telah membuat tabel kerja sama. Intinya sangat sederhana: lebih banyak pemirsa la..
Layanan Kami untuk Streamer

Shopee
Layanan Kami untuk Pembuat Konten









