# Discord Voice Stream Notifications

## How do Discord voice stream notifications work?

Sx Bot will automatically post announcements in your Discord server whenever someone goes live in your Discord voice channels.

![Discord Live Voice Channel Streaming](/files/fJq5WUPz0yMor5NBGN3c)

## Set up your notification channel

**1.** [Invite the Bot](https://invite.sxbot.io) if you haven't already.

**2.** Create a channel for stream announcements if you haven't already.

**3.** Configure the bot to send stream notifications to that channel.\
**Example: `/discord-live channel set #stream-notifications`**

**4.** Edit your channel's settings, and go to the "Permissions" tab.

**5.** From the "Roles/Members" selection, add Sx Bot.

**6.** Allow Sx Bot to have the following permissions in the channel:

* View Channel
* Send Messages
* Embed Links
* Attach Files
* Use External Emoji
* Mention @everyone, @here, and All Roles

## Add the streamers

**1.** Add the streamers.

**Example:`/discord-live streamers add @user#2041`**

{% hint style="success" %}
That's it! Anytime the streamer @user#2041 goes live in a voice channel, you will now receive an alert to the notifications channel you set.
{% endhint %}

## Ping a specific role (optional)

**1.** Ping a specific role instead of @everyone

**Example:`/discord-live ping-role set @stream notifications`**

**2.** If you want to turn off pings altogether

**Example:`/discord-live no-ping enable`**

{% hint style="success" %}
The notifications will be sent silently without mentioning anyone!
{% endhint %}

## Live Logs (optional)

1. Setup a log channel to keep an audit lot of the live role\
   **Example:`/discord-live log-channel set #live-logs`**

## Create a live role (optional)

**1.** [Invite the Bot](https://invite.sxbot.io) if you haven't already.

**2.** Create a live role if you haven't already.

**3.** Configure the bot to the live role you created.

**Example: `/discord-live role set @Live on Discord`**

**4.** Setup a whitelist role to allow only members with this role to receive the live role.\
**Example: `/discord-live whitelist-role set @Members`**

**5.** You can turn on onlystreamers mode which will only allow users who are manually added to the streamers list to receive the live role.\
**Example: `/discord-live only-streamers enable`**<br>

{% hint style="warning" %}
Creating the live role is optional is will automatically give members a specific role when they begin streaming. It's not required for the notifications to be sent.
{% endhint %}

{% hint style="info" %}
Need help? join our [support server](https://support.sxlivebot.com)!
{% endhint %}


---

# 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.sxbot.io/discord-live-notifications/discord-voice-stream-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.