Platform

Twitch

Full Twitch integration with real-time events via EventSub, IRC chat, channel point rewards, polls, predictions, moderation, and comprehensive API access.

Overview

FaustBot provides deep integration with Twitch through the Helix API and EventSub WebSocket, enabling real-time reactions to stream events and complete control over your channel.

Real-time Events

Follows, subs, raids, cheers, and more via EventSub.

Chat Integration

Send messages, announcements, and whispers.

Channel Points

Manage rewards and handle redemptions.

Polls & Predictions

Create and manage interactive features.

Moderation

Ban, timeout, VIP, and chat mode control.

Stream Control

Update title, game, run ads, create clips.

Setup

Connecting Your Twitch Account

Open Twitch Settings

In FaustBot, navigate to Platforms in the sidebar and select Twitch.

Login with Twitch

Click Login with Twitch. A browser window will open for you to authorize FaustBot to access your Twitch account.

Screenshot: Twitch OAuth authorization

Authorize Permissions

Review and accept the requested permissions. FaustBot needs access to chat, channel management, moderation, and other features to function properly.

Automatic Connection

Once authorized, FaustBot will automatically connect to Twitch chat and EventSub. Enable Auto-Connect to reconnect automatically when FaustBot starts.

Bot Account

Optionally connect a separate bot account to send messages as a different user. This keeps your broadcaster account messages distinct from automated responses.

Triggers

React to real-time events from your Twitch channel:

Subscription Events

New Follower Someone followed your channel

Subscription New subscription (any tier)

Resub Message Subscriber shared a resub message

Gift Subscription Someone gifted subs to the channel

Subscription Ended A subscription was not renewed

Monetization Events

Cheer Bits were cheered in chat

Channel Point Redemption Custom reward was redeemed

Charity Donation Donation to charity campaign

Stream Events

Stream Online Your stream went live

Stream Offline Your stream ended

Raid Received Another streamer raided you

Channel Update Title, game, or tags changed

Ad Break Started A commercial break began

Interactive Events

Poll Started/Progress/Ended Poll lifecycle events

Prediction Started/Locked/Ended Prediction lifecycle events

Hype Train Started/Progress/Ended Hype train lifecycle events

Goal Started/Progress/Ended Channel goal lifecycle events

Chat Events

Chat Message Message sent in chat

First Words User's first message of the stream

User Joined/Left User joined or left the chat

Shoutout Received Another streamer shouted you out

Moderation Events

VIP Added/Removed VIP status changed

Shield Mode Started/Ended Shield mode toggled

AutoMod Message Held Message flagged by AutoMod

Suspicious User Message Low-trust user sent a message

Unban Request Created/Resolved Unban request lifecycle

Effects

Chat Effects

Send Message

Send a chat message.

Announce

Send colored announcement.

Shoutout

Shoutout another streamer.

Whisper

Send a private message.

Moderation Effects

Timeout

Temporarily ban a user.

Ban/Unban

Permanently ban or unban.

Clear Chat

Clear all chat messages.

Slow Mode

Limit message frequency.

Sub-Only Mode

Restrict chat to subs.

Emote-Only Mode

Allow only emotes.

Follower-Only Mode

Restrict to followers.

Add/Remove VIP

Manage VIP status.

Add/Remove Mod

Manage moderator status.

Warn User

Send an official warning.

Shield Mode

Toggle shield mode.

Block/Unblock

Block users from channel.

Channel Effects

Set Title

Change stream title.

Set Game

Change stream category.

Run Ad

Start a commercial break.

Snooze Ad

Delay next scheduled ad.

Create Marker

Add a stream marker.

Create Clip

Create a clip.

Raid

Start a raid to another channel.

Cancel Raid

Cancel an active raid.

Channel Point Reward Effects

Enable Reward

Make reward available.

Disable Reward

Make reward unavailable.

Pause/Unpause

Temporarily pause reward.

Fulfill Redemption

Complete a redemption.

Cancel Redemption

Refund and cancel.

Update Cost/Title

Modify reward properties.

Poll & Prediction Effects

Create Poll

Start a new poll.

End Poll

End poll early.

Create Prediction

Start a new prediction.

Resolve Prediction

Select winning outcome.

Cancel Prediction

Refund all points.

Guest Star Effects

Create Session

Start Guest Star session.

End Session

End Guest Star session.

Invite Guest

Invite user to session.

Remove Guest

Remove from session.

Scripting API

Access Twitch features from your scripts using the CPH API:

Chat Messages

Send chat messages and announcements

# Send a message to chat
CPH.TwitchSendMessage("Hello chat!")

# Send a reply to a message
CPH.TwitchSendMessage("Thanks for the follow!", replyToId="%msgId%")

# Send an announcement (colored)
CPH.TwitchAnnounce("Stream starting in 5 minutes!", "purple")

Moderation

Moderate your channel

# Timeout a user (600 seconds default)
CPH.TwitchTimeout("%userId%", 300, "Spamming")

# Ban a user
CPH.TwitchBan("%userId%", "Rule violation")

# Unban a user
CPH.TwitchUnban("%userId%")

# Add/remove VIP
CPH.TwitchAddVip("%userId%")
CPH.TwitchRemoveVip("%userId%")

Channel Control

Control your stream

# Update stream title
CPH.TwitchSetTitle("Playing some games!")

# Update game/category
CPH.TwitchSetGame("Just Chatting")

# Create a clip
CPH.TwitchCreateClip()

# Create a stream marker
CPH.TwitchCreateMarker("Epic moment!")

# Run a commercial
CPH.TwitchRunAd(60)  # 60 second ad

Polls & Predictions

Interactive features

# Create a poll
CPH.TwitchCreatePoll("What game next?", ["Minecraft", "Fortnite", "Valorant"], 60)

# Create a prediction
CPH.TwitchCreatePrediction("Will I win?", ["Yes", "No"], 120)

# Resolve a prediction (use outcome ID)
CPH.TwitchResolvePrediction("%predictionId%", "%winningOutcomeId%")

Channel Point Rewards

Manage channel point rewards

# Enable/disable a reward
CPH.TwitchEnableReward("%rewardId%")
CPH.TwitchDisableReward("%rewardId%")

# Fulfill a redemption
CPH.TwitchFulfillRedemption("%rewardId%", "%redemptionId%")

# Cancel a redemption (refund points)
CPH.TwitchCancelRedemption("%rewardId%", "%redemptionId%")

# Update reward cost
CPH.TwitchUpdateRewardCost("%rewardId%", 500)

See the full API reference for all Twitch methods.

Example Use Cases

Welcome Raiders

Trigger on Raid Received to send a thank-you message and play a sound alert when another streamer raids your channel.

Auto-Shoutout

Automatically shoutout raiders or specific users when they chat for the first time using the First Words trigger.

Dynamic Rewards

Enable or disable channel point rewards based on your current game or stream status. Great for game-specific rewards.

Hype Train Celebration

Trigger special effects and sounds when a hype train reaches certain levels, or celebrate when it completes successfully.

Chat Games

Create predictions for in-game outcomes and automatically resolve them based on game events or commands.

Mod Commands

Create chat commands that only moderators can use to control stream settings, run ads, or manage rewards.