> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifikasi Twitch

> Umumkan di Discord ketika streamer Twitch live atau offline, dengan embed yang sepenuhnya dapat dikustomisasi.

<Info>
  Memerlukan **Basic**. Hingga **10 streamer** per server. Lihat [cara kerja notifikasi](/id/notifications/overview) untuk aturan yang dibagi semua platform.
</Info>

## Menambahkan streamer

Cari channel berdasarkan nama — Vetox mencarinya di Twitch dan mengonfirmasi keberadaannya sebelum menambahkan. Username yang tidak dapat diselesaikan ditolak dengan **Twitch user not found**.

Username 1–25 karakter, hanya huruf, angka, dan underscore.

## Pengaturan

| Pengaturan                    | Default        | Catatan                                                                                   |
| ----------------------------- | -------------- | ----------------------------------------------------------------------------------------- |
| **Discord Channel**           | —              | Wajib. Diatur per streamer, sehingga streamer berbeda dapat memposting ke channel berbeda |
| **Notify when online**        | **Aktif**      | Pengumuman live                                                                           |
| **Notify when offline**       | **Nonaktif**   | Pengumuman kedua saat stream berakhir                                                     |
| **Mention Role**              | Tidak ada      | Di-ping bersama pengumuman                                                                |
| **Custom Notification Embed** | Default Twitch | Ungu, dengan judul stream, game, dan jumlah penonton                                      |

## Variabel

| Variabel             | Diselesaikan menjadi                             |
| -------------------- | ------------------------------------------------ |
| `{streamer.name}`    | Nama tampilan streamer                           |
| `{streamer.url}`     | URL channel Twitch mereka                        |
| `{streamer.avatar}`  | Foto profil mereka                               |
| `{stream.title}`     | Judul stream — **hanya pengumuman live**         |
| `{stream.game}`      | Kategori yang di-stream — **hanya live**         |
| `{stream.viewers}`   | Jumlah penonton saat pengumuman — **hanya live** |
| `{stream.thumbnail}` | Gambar pratinjau stream — **hanya live**         |

<Warning>
  Empat variabel `{stream.*}` tidak memiliki nilai di pengumuman **offline**. Setiap field embed yang dibangun dari mereka menghilang dari pesan itu. Jaga embed offline Anda hanya ke variabel `{streamer.*}`.
</Warning>

## Bagaimana going live terdeteksi

Vetox memeriksa setiap **60 detik** dan melacak apakah channel live.

<Steps>
  <Step title="Offline → live">
    Pengumuman menyala, tunduk pada **cooldown 10 menit** per streamer.
  </Step>

  <Step title="Masih live">
    Tidak ada. Status hanya di-refresh — stream panjang menghasilkan tepat satu pengumuman.
  </Step>

  <Step title="Live → offline">
    Pengumuman offline menyala, jika Anda mengaktifkannya.
  </Step>
</Steps>

<Warning>
  **Menambahkan streamer yang sudah live tidak mengumumkan apa pun.** Pelacak menyala pada transisi, bukan pada status saat ini. Pengumuman pertama Anda akan menjadi stream berikutnya mereka.
</Warning>

<Note>
  Stream yang sebentar putus dan menyambung kembali dalam jendela cooldown menghasilkan satu pengumuman, bukan dua — ini disengaja, dan itulah sebabnya cooldown adalah 10 menit bukan 1.
</Note>

## Pengaturan dunia nyata

<Steps>
  <Step title="Aktifkan Twitch di Server Setup">
    Mati secara default. Tidak ada yang bekerja sampai ini aktif.
  </Step>

  <Step title="Tambahkan streamer">
    Cari nama mereka dan pilih dari hasil.
  </Step>

  <Step title="Pilih channel dan role">
    Channel `#going-live` khusus dan role `@Stream Ping` yang anggota opt-in melalui [Self-Roles](/id/engagement/self-roles) adalah pola yang paling banyak diadopsi server.
  </Step>

  <Step title="Periksa izin bot di sana">
    View Channel, Send Messages, dan **Embed Links**.
  </Step>

  <Step title="Tunggu stream berikutnya">
    Jangan menilainya dengan menambahkan seseorang di tengah stream.
  </Step>
</Steps>

## Pemecahan masalah

<AccordionGroup>
  <Accordion title="Mereka live dan tidak ada yang diposting">
    Periksa toggle Twitch Server Setup, premium aktif, dan Embed Links di channel. Jika Anda menambahkan mereka saat mereka sudah streaming, ini sesuai perkiraan — tunggu stream berikutnya.
  </Accordion>

  <Accordion title="Game atau jumlah penonton hilang">
    Anda melihat pengumuman offline. Variabel itu hanya ada saat live.
  </Accordion>

  <Accordion title="Mengubah channel tidak berlaku">
    Mengosongkan field channel tidak mengirim apa-apa dan diam-diam mempertahankan nilai lama. Pilih channel berbeda daripada mengosongkannya.
  </Accordion>

  <Accordion title="Dua server mengikuti streamer yang sama dan hanya satu yang mendapatkan ping">
    Keduanya harus menyala. Jika izin satu channel gagal, item itu hilang tanpa retry — periksa Embed Links di sisi yang gagal.
  </Accordion>
</AccordionGroup>

<Card title="Kick" icon="tower-broadcast" horizontal href="/id/notifications/kick">
  Model live/offline yang sama di Kick.
</Card>