> For the complete documentation index, see [llms.txt](https://docs.vox.bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vox.bot/connect-a-channel/twitch.md).

# Connect Twitch to VoxBot

Connect your Twitch channel to your VoxBot account, set up TTS playback, test chat while offline or live, and fix common connection problems.

Connecting your Twitch channel lets viewers use VoxBot commands in the channel's normal chat. VoxBot can also recognize VIP, subscriber, and moderator badges.

{% hint style="info" %}
This guide assumes you have a VoxBot account and can sign in as the broadcaster for the Twitch channel you want to connect.
{% endhint %}

## Connect your Twitch channel

1. If you manage more than one VoxBot account, select the correct one from the account menu in the top-left corner.
2. Open [Account](https://vox.bot/dashboard/account).
3. Find Twitch under the **Not Connected** section.
4. Select **Connect**.

<figure><img src="https://99517040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRLilJ2T36zg40NjFQOt8%2Fuploads%2Fgit-blob-762c058cc241a202802ab797fafada23cd505ab2%2Fvoxbot-twitch-connect.png?alt=media" alt="The Twitch row under Not Connected with a red outline around Connect"><figcaption><p>Select <strong>Connect</strong> on the Twitch row to begin the Twitch sign-in.</p></figcaption></figure>

5. Sign in to Twitch with the broadcaster login for the channel you want to connect.

<figure><img src="https://99517040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRLilJ2T36zg40NjFQOt8%2Fuploads%2Fgit-blob-bbbfd580aec72b8f0bef330d6d6ce2929b482adc%2Fvoxbot-twitch-sign-in.png?alt=media" alt="The Twitch login page with username, password, and connected sign-in options"><figcaption><p>Sign in on Twitch. You do not enter your Twitch password in the VoxBot dashboard.</p></figcaption></figure>

6. Review the access request on Twitch.
7. Approve the request.
8. Wait for Twitch to return you to VoxBot.
9. Open **Account** and confirm that the Twitch channel appears under the **Connected** section.

{% hint style="warning" %}
Sign in as the broadcaster for the Twitch channel. Signing in as a viewer or moderator connects that person's channel instead, even if they can moderate your chat.
{% endhint %}

## Choose who can use each command

The permission buttons on [Commands](https://vox.bot/dashboard/tts/commands) work with these Twitch badges:

* **All** allows any viewer to use the command.
* **VIP** allows viewers with a Twitch VIP badge.
* **Sub** allows viewers with a subscriber or founder badge.
* **Mod** allows viewers with a moderator badge.

The broadcaster can also use commands in the connected Twitch channel.

## Set up TTS playback

Before you test a message, add the VoxBot browser source to your streaming software. This is what lets you hear the generated voice in OBS Studio, Streamlabs Desktop, Meld, or another streaming app.

1. Open [Playback Settings](https://vox.bot/dashboard/tts/playback).
2. Find the **Browser Source** card.
3. Select **Copy**.
4. Add a browser source in your streaming software and paste the URL.

Follow [Send your first TTS message](/getting-started/first-tts-message.md) for the complete browser source and command test.

## Test Twitch chat

Your Twitch channel does not need to be live for this test. Twitch chat stays available while the channel is offline.

1. Open the chat for your connected Twitch channel.
2. Send `!tts Hello stream`.
3. Open [Message History](https://vox.bot/dashboard/tts/history).
4. Find the Twitch message under **Recent Messages**.

If the message appears without TTS, check the command spelling, **Status**, viewer permission, **TTS Enabled**, cooldowns, limits, and moderation settings.

If the message is missing, confirm that the correct Twitch channel appears under the **Connected** section. Then select **Reconnect** and send another test.

## Reconnect Twitch

Reconnect the channel if you removed VoxBot access in Twitch, changed your Twitch security settings, or no longer see new chat messages in **Message History**.

1. Open [Account](https://vox.bot/dashboard/account).
2. Find Twitch under the **Connected** section.
3. Select **Reconnect**.
4. Approve the Twitch access request again.
5. Send another controlled chat test.

Reconnect refreshes the Twitch connection. Your VoxBot commands, voices, and **Playback Settings** do not change.

## Disconnect Twitch

1. Open [Account](https://vox.bot/dashboard/account).
2. Select the trash icon on the connected Twitch row.
3. Review the warning.
4. Select **Disconnect**.

VoxBot stops receiving messages from that Twitch channel. Your commands, voices, and **Playback Settings** stay on your VoxBot account, so you can reconnect the channel later without rebuilding the TTS setup.

## Troubleshooting

* **Authentication failed. Please try again.:** Start the connection again and make sure your browser allows the Twitch sign-in page to open.
* **This account is already connected to another VoxBot user.:** The Twitch channel is connected to another VoxBot account. Switch to that VoxBot account or remove its Twitch connection first.
* **Twitch is under Connected, but messages are missing:** Select **Reconnect**, send another test, and check **Message History** again.
* **The message appears without TTS:** The channel connection works. Check the TTS command, permissions, limits, **TTS Enabled**, and moderation settings.
* **The message shows TTS, but you cannot hear it:** Check the browser source, active scene, and audio mixer in your streaming software.

## FAQ

<details>

<summary>Do I need to make VoxBot a moderator on Twitch?</summary>

No. You do not need to add a separate VoxBot account to your Twitch chat. Connect the channel by signing in as its broadcaster.

</details>

<details>

<summary>Can VoxBot recognize Twitch VIPs, subscribers, and moderators?</summary>

Yes. Use the **VIP**, **Sub**, and **Mod** permission buttons on the **Commands** page to limit a command to those viewers.

</details>

<details>

<summary>Does my Twitch channel need to be live for VoxBot to work?</summary>

No. Twitch chat remains active while the channel is offline, so you can test VoxBot before you start your stream.

</details>

<details>

<summary>Can I connect Twitch and YouTube to the same VoxBot account?</summary>

Yes. You can connect one Twitch channel and one YouTube channel, along with channels from other supported platforms, to the same VoxBot account.

</details>

## Still having trouble with Twitch?

Email <support@vox.bot> or ask in the [VoxBot Discord](https://discord.gg/GtU5XqhRSq). Include a screenshot of the Twitch row under **Platform Connections** and what [Message History](https://vox.bot/dashboard/tts/history) shows.