# Kick Livestream Notifications

## Kick Livestream Notification System Documentation

### Introduction

The Discord Verification Bot includes a powerful livestream notification system that allows your Discord server to be notified whenever your favorite Kick streamers go live. This feature helps keep your community engaged and informed about live content from streamers you choose to follow.

### How It Works

The notification system regularly checks the status of Kick channels you've configured for monitoring. When a streamer goes live:

1. The bot detects the change in stream status
2. A notification is sent to your designated Discord channel
3. The notification includes:
   * Stream title
   * Streamer name
   * Category/game being played
   * Current viewer count
   * Thumbnail from the stream (when available)
   * A direct link to the stream

### Setting Up Notifications

#### Prerequisites

Before setting up notifications, ensure:

* The bot has been added to your server
* You have the "Manage Server" permission to configure notifications

#### Basic Commands

All notification commands use the `/kick` prefix:

**Adding a Streamer**

To add a Kick streamer for notifications:

```
/kick add slug:streamername channel:#announcements
```

Where:

* `slug`: The Kick channel username (what appears in their URL after kick.com/)
* `channel`: The Discord channel where you want notifications to appear

Example:

```
/kick add slug:xqc channel:#stream-announcements
```

**Listing Configured Streamers**

To see all streamers you're currently tracking:

```
/kick list
```

This displays:

* Notification ID (needed for other commands)
* Discord channel where notifications are sent
* Kick streamer username
* Current status (enabled/disabled)

**Disabling Notifications**

To temporarily disable notifications for a streamer without removing them:

```
/kick disable id:notification-id
```

Where `notification-id` is the ID shown in the `/kick list` command.

**Re-enabling Notifications**

To re-enable previously disabled notifications:

```
/kick enable id:notification-id
```

**Removing a Streamer**

To completely remove a streamer from notifications:

```
/kick remove id:notification-id
```

**Checking Streamer Status**

To see detailed information about a Kick streamer:

```
/kick show slug:streamername
```

This displays:

* Current online/offline status
* Stream title (if live)
* Viewer count (if live)
* Category/game
* Stream start time (if live)
* Other channel information

#### Testing Notifications

After setting up a notification, you can test it:

```
/kick test id:notification-id
```

This sends a test notification to the configured channel, showing how it will appear when the streamer actually goes live.

### Advanced Features

#### Notification Frequency

To prevent spam:

* Notifications are only sent when a streamer goes live
* Repeat notifications for the same stream are prevented
* A cooldown period of 30 minutes is enforced between notifications for the same streamer

#### Customization

The notification message includes:

* An eye-catching notification with the streamer's name
* An embedded card with stream details
* A thumbnail from the stream
* Direct link to the stream

### Troubleshooting

#### Common Issues

1. **No notifications appearing**:
   * Ensure the notification is enabled (`/kick list` to check)
   * Verify the bot has permission to send messages in the destination channel
   * Check that the streamer username is spelled correctly
2. **Streamer not found**:
   * Double-check the spelling of the Kick username
   * Make sure you're using the streamer's slug (username) not their display name
   * Use the `/kick show` command to verify the streamer exists
3. **Delayed notifications**:
   * The system checks stream status every 2 minutes, so there may be a short delay between a stream starting and the notification appearing
4. **Multiple notifications for one stream**:
   * This shouldn't happen due to the built-in cooldown, but if it does, try:
     * Disabling and re-enabling the notification
     * Removing and re-adding the notification

### Best Practices

1. **Create a dedicated channel** for stream notifications to avoid cluttering other channels
2. **Use clear naming conventions** for your notification channels (e.g., #live-streams)
3. **Limit the number of tracked streamers** to prevent notification overload
4. **Regularly review** your notification list and remove inactive streamers

### Support

For additional help or to report issues with the notification system, please contact support through our website's help system or by emailing <support@betsync.app>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.betsync.app/kick-livestream-notifications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
