> ## 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.

# Thông báo Twitch

> Thông báo trong Discord khi một streamer Twitch lên sóng hoặc offline, với một embed hoàn toàn tùy chỉnh.

<Info>
  Yêu cầu **Basic**. Tối đa **10 streamer** cho mỗi máy chủ. Xem [cách các thông báo hoạt động](/vi/notifications/overview) để biết các quy tắc được chia sẻ bởi tất cả các nền tảng.
</Info>

## Thêm một streamer

Tìm kênh theo tên — Vetox tra cứu nó trên Twitch và xác nhận nó tồn tại trước khi thêm. Một tên người dùng không phân giải được sẽ bị từ chối với **Twitch user not found**.

Tên người dùng có 1–25 ký tự, chỉ chữ cái, số và dấu gạch dưới.

## Cài đặt

| Cài đặt                       | Mặc định        | Ghi chú                                                                                    |
| ----------------------------- | --------------- | ------------------------------------------------------------------------------------------ |
| **Discord Channel**           | —               | Bắt buộc. Đặt theo streamer, nên các streamer khác nhau có thể đăng đến các kênh khác nhau |
| **Notify when online**        | **On**          | Thông báo live                                                                             |
| **Notify when offline**       | **Off**         | Một thông báo thứ hai khi luồng kết thúc                                                   |
| **Mention Role**              | Không           | Được ping với thông báo                                                                    |
| **Custom Notification Embed** | Twitch mặc định | Tím, với tiêu đề luồng, trò chơi và số người xem                                           |

## Biến

| Biến                 | Phân giải thành                                         |
| -------------------- | ------------------------------------------------------- |
| `{streamer.name}`    | Tên hiển thị của streamer                               |
| `{streamer.url}`     | URL kênh Twitch của họ                                  |
| `{streamer.avatar}`  | Ảnh hồ sơ của họ                                        |
| `{stream.title}`     | Tiêu đề luồng — **chỉ thông báo live**                  |
| `{stream.game}`      | Danh mục đang được stream — **chỉ khi live**            |
| `{stream.viewers}`   | Số người xem tại thời điểm thông báo — **chỉ khi live** |
| `{stream.thumbnail}` | Hình ảnh xem trước luồng — **chỉ khi live**             |

<Warning>
  Bốn biến `{stream.*}` không có giá trị trong thông báo **offline**. Bất kỳ trường embed nào được xây dựng từ chúng sẽ biến mất khỏi tin nhắn đó. Giữ embed offline của bạn chỉ với các biến `{streamer.*}`.
</Warning>

## Cách phát hiện đi live

Vetox kiểm tra mỗi **60 giây** và theo dõi liệu kênh có đang live hay không.

<Steps>
  <Step title="Offline → live">
    Thông báo được kích hoạt, tuân theo **thời gian hồi 10 phút** cho mỗi streamer.
  </Step>

  <Step title="Vẫn live">
    Không có gì. Trạng thái chỉ được làm mới — một luồng dài tạo ra chính xác một thông báo.
  </Step>

  <Step title="Live → offline">
    Thông báo offline được kích hoạt, nếu bạn đã bật nó.
  </Step>
</Steps>

<Warning>
  **Thêm một streamer đã đang live sẽ không thông báo gì.** Trình theo dõi được kích hoạt trên sự chuyển đổi, không phải trên trạng thái hiện tại. Thông báo đầu tiên của bạn sẽ là luồng tiếp theo của họ.
</Warning>

<Note>
  Một luồng ngắn ngủi ngắt và kết nối lại trong cửa sổ thời gian hồi tạo ra một thông báo, không phải hai — điều này là có chủ đích, và đó là lý do tại sao thời gian hồi là 10 phút chứ không phải 1.
</Note>

## Thiết lập trong thực tế

<Steps>
  <Step title="Bật Twitch trong Server Setup">
    Nó tắt theo mặc định. Không có gì hoạt động cho đến khi cái này được bật.
  </Step>

  <Step title="Thêm streamer">
    Tìm kiếm tên của họ và chọn họ từ kết quả.
  </Step>

  <Step title="Chọn một kênh và một vai trò">
    Một kênh chuyên dụng `#going-live` và một vai trò `@Stream Ping` mà thành viên chọn tham gia qua [Self-Roles](/vi/engagement/self-roles) là mô hình mà hầu hết các máy chủ chọn.
  </Step>

  <Step title="Kiểm tra quyền của bot ở đó">
    View Channel, Send Messages và **Embed Links**.
  </Step>

  <Step title="Đợi luồng tiếp theo của họ">
    Đừng đánh giá nó bằng cách thêm ai đó giữa luồng.
  </Step>
</Steps>

## Xử lý sự cố

<AccordionGroup>
  <Accordion title="Họ đã lên sóng và không có gì được đăng">
    Kiểm tra công tắc Twitch của Server Setup, premium đang hoạt động, và Embed Links trong kênh. Nếu bạn thêm họ khi họ đang stream, điều này là được mong đợi — đợi luồng tiếp theo.
  </Accordion>

  <Accordion title="Trò chơi hoặc số người xem bị thiếu">
    Bạn đang xem thông báo offline. Những biến đó chỉ tồn tại khi live.
  </Accordion>

  <Accordion title="Thay đổi kênh không có hiệu lực">
    Xóa trường kênh không gửi gì và âm thầm giữ giá trị cũ. Chọn một kênh khác thay vì xóa nó.
  </Accordion>

  <Accordion title="Hai máy chủ theo dõi cùng streamer và chỉ một máy chủ nhận được ping">
    Cả hai đều phải được kích hoạt. Nếu quyền của một kênh thất bại, mục đó bị mất mà không có thử lại — kiểm tra Embed Links ở phía thất bại.
  </Accordion>
</AccordionGroup>

<Card title="Kick" icon="tower-broadcast" horizontal href="/vi/notifications/kick">
  Cùng mô hình live/offline trên Kick.
</Card>