Webhook Discord
Disertakan dengan Macro DeckKirim pesan kaya dengan embed dan sebutan ke saluran Discord melalui webhook, dengan pratinjau langsung.
Dialog Tambahkan webhook Discord dengan kolom Nama dan URL webhook
- Simpan webhook berdasarkan nama, satu per saluran
- Editor visual dengan pratinjau yang tampak seperti Discord
- Hingga 10 embed dengan kolom, gambar, penulis, dan footer
- Sebutan tidak memberi notifikasi kepada siapa pun kecuali Anda mengizinkannya
- Variabel templat diisi saat aksi berjalan
Webhook Discord memungkinkan apa pun yang mengetahui URL-nya mengirim pesan ke satu saluran Discord. Integrasi Webhook Discord menyimpan webhook dengan sebuah nama dan memberi Anda satu aksi, Kirim pesan webhook Discord, dengan editor visual untuk pesannya. Integrasi ini tidak memerlukan aplikasi Discord atau akun Discord di komputer yang menjalankan Macro Deck.
Yang dapat Anda kirim
Editor memiliki empat tab:
- Pesan: teks pesan dengan Markdown Discord dan baris baru, ditambah tombol yang menyisipkan sebutan pengguna atau peran,
@everyone, atau@here. - Embed: hingga 10 embed, masing-masing dengan judul dan tautan judul, deskripsi, warna, stempel waktu, penulis, footer, gambar, thumbnail, dan hingga 25 kolom yang dapat ditampilkan berdampingan.
- Profil: nama pengguna dan avatar untuk pesan ini, menggantikan milik webhook itu sendiri.
- Sebutan: siapa yang boleh diberi notifikasi oleh sebutan dalam pesan.
Secara default, pesan tidak memberi notifikasi kepada siapa pun, bahkan saat pesan menyebut seseorang, @everyone, atau @here. Sebutan tetap ditampilkan di Discord, hanya saja tidak mengirim notifikasi. Semua kolom teks menerima variabel templat, yang diisi saat aksi berjalan, sehingga pesan dapat memuat scene, lagu, atau jumlah penonton saat ini.
Pratinjau di bawah editor berubah saat Anda mengetik dan menampilkan pesan seperti cara Discord menampilkannya. Pratinjau tidak pernah mengirim apa pun ke Discord. Gambar ditampilkan sebagai placeholder, dan variabel muncul seperti yang Anda tulis. Kirim pesan uji langsung mengirim pesan ke Discord setelah Anda mengonfirmasi dengan Kirim sekarang, sehingga Anda dapat melihat tampilan sebenarnya.
Beberapa contoh penggunaan:
- Tombol Mulai live yang mengirim embed berisi judul dan tautan stream Anda ke saluran pengumuman.
- Tombol yang mengirim lagu yang sedang diputar ke saluran musik.
- Otomasi yang mengirim pesan ke saluran moderator saat sesuatu terjadi di stream Anda.
Webhook tersimpan dan URL kustom
Tambahkan satu konfigurasi per saluran, lalu pilih webhook berdasarkan namanya di setiap aksi. Saat URL berubah, Anda cukup mengubahnya di satu tempat. Untuk pesan sekali kirim, Anda juga dapat mengatur Webhook ke URL kustom dan menempelkan URL ke dalam aksi. Macro Deck menyimpan setiap URL webhook dalam bentuk terenkripsi, tidak pernah menampilkannya lagi, dan tidak pernah menuliskannya ke log.
Macro Deck memeriksa batas Discord sebelum mengirim, misalnya 2000 karakter teks pesan dan 6000 karakter di semua embed sekaligus, dan mencantumkan setiap masalah di atas pratinjau saat Anda mengedit. Saat Discord membatasi seberapa sering sebuah webhook boleh mengirim, Macro Deck menunggu dan mencoba sekali lagi jika waktu tunggunya 5 detik atau kurang.
Yang Anda butuhkan
- Macro Deck 3 di Windows, macOS, atau Linux
- Koneksi internet di komputer yang menjalankan Macro Deck
- Saluran Discord tempat Anda dapat mengelola webhook, beserta URL webhook-nya
Cara menyiapkan
Langkah 1: Buat webhook di Discord
Di Discord, buka pengaturan saluran, buka Integrations, lalu Webhooks, dan buat webhook atau pilih yang sudah ada. Klik Copy Webhook URL. URL-nya diawali dengan
https://discord.com/api/webhooks/. Siapa pun yang memilikinya dapat mengirim pesan ke saluran tersebut, jadi perlakukan seperti kata sandi.Langkah 2: Buka Webhook Discord di Macro Deck
Di Macro Deck, klik Integrasi di bilah samping, lalu klik Webhook Discord. Di tab Ringkasan, klik Tambah konfigurasi di bagian Konfigurasi. Mengaktifkan sakelar di kanan atas membuka dialog yang sama.
Langkah 3: Simpan webhook
Isi dialog Tambahkan webhook Discord:
- Nama: ditampilkan saat Anda memilih webhook di sebuah aksi, misalnya nama saluran.
- URL webhook: URL yang Anda salin di Discord.
Klik Lanjutkan. Tambahkan satu konfigurasi untuk setiap saluran berikutnya.
Langkah 4: Tambahkan aksi ke tombol
Di halaman Deck, klik tombol yang ingin Anda gunakan. Deck harus tidak terkunci: saat tombol di kanan atas bertuliskan Kunci, deck tidak terkunci. Editor terbuka dengan Ketuk Singkat terpilih. Klik + Tambah aksi, pilih Webhook Discord di sisi kiri dialog Tambah aksi, lalu pilih Kirim pesan webhook Discord.
Langkah 5: Tulis pesannya
Pilih webhook yang tersimpan di Webhook. Tulis Teks pesan di tab Pesan, dan tambahkan embed di tab Embed jika Anda mau. Periksa pratinjaunya, lalu klik Kirim pesan uji dan Kirim sekarang untuk melihat pesan di Discord.
Langkah 6: Tekan tombolnya
Tekan tombol di ponsel, tablet, atau klien web Anda. Pesan muncul di saluran Discord, dengan semua variabel sudah terisi. Jika tidak muncul, aksi menampilkan alasannya, misalnya bahwa Discord menolak token webhook.
Aksi1
Pasang aksi ini di tombol atau jalankan dari alur.
- Kirim pesan webhook Discord
- Mengirim pesan dengan embed opsional melalui webhook Discord yang tersimpan atau kustom, diedit dengan pratinjau langsung.
Pertanyaan yang sering diajukan
Bagaimana cara menyebut pengguna atau peran?
Sebutan memerlukan ID Discord. Di Discord, aktifkan Developer Mode di pengaturan lanjutan, lalu klik kanan pengguna atau peran dan pilih Copy ID. Di tab Sebutan, pilih apakah tidak ada yang diberi notifikasi, semua yang disebut, atau hanya ID yang Anda cantumkan.
Apa bedanya dengan integrasi Discord?
Integrasi Discord memiliki aksi Jalankan webhook yang lebih lama dengan satu embed dan tanpa pratinjau. Aksi itu tetap berfungsi. Webhook Discord menambahkan beberapa embed, kontrol sebutan, profil per pesan, dan pratinjau langsung.
Di mana URL webhook disimpan?
Macro Deck menyimpannya dalam bentuk terenkripsi di komputer yang menjalankan Macro Deck. URL ini tidak pernah ditampilkan lagi, tidak pernah ditulis ke log, dan tidak pernah menjadi bagian dari pratinjau. Untuk mengubahnya, masukkan lagi. Hanya alamat webhook Discord di discord.com, discordapp.com, ptb.discord.com, dan canary.discord.com yang diterima.
Mengapa variabel tidak terisi di pesan uji saya?
Kirim pesan uji mengirim variabel apa adanya. Variabel hanya diisi saat aksi berjalan dari tombol, otomasi, atau skrip.
Mengapa aksi gagal?
Aksi menampilkan alasannya, misalnya pesan kosong atau terlalu panjang, webhook sudah tidak ada di Discord, Discord menolak token webhook, atau Discord membatasi laju webhook. Jika token ditolak, salin lagi URL webhook dan masukkan ke konfigurasi.
Bisakah saya mengedit pesan di aplikasi Companion?
Aplikasi Companion dan aplikasi desktop versi lama menampilkan pengaturan dasar aksi, dengan pesan berupa kunci dan nilai seperti content dan embeds.0.title, dan tidak menyimpan perubahan yang dibuat di editor visual. Edit pesan kaya di aplikasi desktop versi terbaru.
