The Discord integration forwards channel events to your own Discord server: go-live notices, follows and subs, tips — even a full chat mirror. After installing, each kind of event can go to a different Discord channel.
What it solves
Your community does not hang out on Twitch; it hangs out on Discord. The people who most want to know you went live are exactly the ones already chatting in your server. Pushing events over there keeps that side alive on its own — no manually pasting a link every time you start, and offline activity has somewhere to land.
Getting started
- Hit "Install to server" and pick the server on Discord's authorisation screen.
- Back on the settings page, assign a Discord channel to each forwarding group.
- Enable the groups you want, and save.
- Use "Send test message" to confirm it actually arrives.
The install asks for exactly three permissions: view channels (to list your text channels), send messages and embed links (to post the forwarded content), and manage webhooks (to create the sending webhook in the channel you chose).
Forwarding groups
| Group | What it covers |
|---|---|
| Stream activity | Going live, going offline, title and category changes. |
| Supporter events | Follows, subs, gift subs, Bits, raids, channel point redemptions. |
| Tips | On-site tips, gifted plans, external payment providers. Includes amounts — usually one for a private channel. |
| Chat mirror | Mirrors chat messages into Discord. Orders of magnitude more traffic than the others, so it is always batched. |
By default every event follows its group. Per-event channel overrides exist for the case where one specific event needs to go somewhere else.
The go-live notice is one message for the whole stream
It is posted when you go live, updated periodically with viewer count and preview image, and turned into an offline card when you stop. Updates do not post new messages, so the channel never gets flooded.
- Turning off "keep updating while live" only stops the updates; it still switches to the offline card at the end.
- Because it is one long-lived message, the go-live notice cannot be routed per-event to a different channel.
- You can add a line of text outside the embed — usually to mention a role. Leave it empty to post the card alone.
Chat mirror
Chat messages accumulate briefly and are posted as one batch. A shorter batch interval is more immediate but more likely to hit Discord's rate limits. You can also exclude known bots, exclude command messages, exclude this site's own bot replies, and merge multiple messages from the same person within a batch into a single card (easier to read during a flood).
⚠️ Messages from other channels in a Shared Chat session are never forwarded, and that cannot be turned off.
Emote mapping
Your channel's Twitch emotes can be mapped to custom emoji on your Discord server. Anything you do not map explicitly falls back to a same-named emoji on Discord if one exists, and to the emote's plain name if not. "Auto-map by name" only fills in what is still unmapped — it never overwrites what you already set.
Webhooks and removal
ChiwaBots creates a webhook in the channel you pick. Its name and avatar can be changed under Discord's Server Settings → Integrations → Webhooks, and we never overwrite your changes — but switching to a different channel creates a new one, back at the defaults.
Removing the integration also deletes the webhook we created for you. Messages already sent are not deleted.
Common misconceptions
- An enabled group with no channel assigned forwards nothing. The settings page calls this out explicitly rather than silently doing nothing.
- Profanity filtering is off by default. With it on, every piece of text this integration sends to Discord goes through the site's profanity filter; with it off, messages are forwarded verbatim.
- Kicking the bot out of your server is not the same as removing the integration here. A periodic reconciliation notices the bot is gone, marks the connection as broken and asks you to reinstall. Your settings are still there and come back after reinstalling.
- This page is not about system notifications. Here you forward your channel's events to your own server. Account-level notices (a plan expiring, say) travel a different path and are configured on the Account page.
Settings
Forward channel events to your own Discord server. After installing, you can pick a channel for each event group separately.
By default every event follows its group. Set this only when a single event needs to go to a different channel.
Map your channel's Twitch emotes to custom emojis on your Discord server. Unmapped emotes automatically use a Discord emoji with the same name; if there is none, the emote name is shown as text.
The text below is taken from the in-app help, so it stays in sync with the actual interface.
| Setting | What it does |
|---|---|
| Remove integration | Webhooks ChiwaBots created for you will also be deleted; messages already sent won't be removed. |
| Filter profanity | When enabled, all text this integration sends to Discord (chat mirror, subscriptions/announcements, reply previews, live-notification custom messages, donation messages, test messages) is passed through the site-wide profanity filter. Off by default — messages are forwarded as-is. |
| Enable this group | When off, this event group won't be forwarded, but the settings are kept. |
| Live message | A line of text shown outside the embed. Use it to mention a role. Leave blank to send only the card. |
| Keep updating while live | When on, the same live message is periodically refreshed with viewer count and a preview image. Turning it off just stops the updates — the message still switches to offline style when the stream ends. |
| Batch interval (ms) | How often accumulated chat messages are combined into one post. Shorter is more real-time, but more likely to hit Discord rate limits. |
| Exclude known bots | Don't forward chat from known bot accounts. |
| Exclude commands | Don't forward messages starting with a command prefix like !. |
| Exclude ChiwaBots's own replies | Don't forward messages sent by this site's bot. |
| Forward moderation actions | Also forward events like message deletion and timeouts. |
| Merge messages from the same user | Combine multiple messages from the same person within a batch into one card, easier to read during chat floods. |
| Auto-map by name | Only fills in blanks - mappings you already set are kept. |
Other notes
- A routine check found the bot was removed from this server, so forwarding has stopped. Please reinstall.
- ChiwaBots creates a webhook in the channel you pick. You can rename it and change its avatar under Discord's Server Settings → Integrations → Webhooks, and we won't overwrite that. Switching channels creates a new one, which resets the name and avatar.
- Messages from other channels in a Shared Chat session are never forwarded — this can't be turned off.
- Going live, going offline, title and category changes. The live message stays as one post for the whole stream: posted when you go live, refreshed while live, switched to offline style when you end.
- Follows, subscriptions, gift subs, cheers, raids, channel points redemptions.
- Site tips, gifted plans, and external payment tips. Includes amounts — you'll usually want a private channel for this.
- Mirrors chat messages to Discord. Volume is orders of magnitude higher than other groups, so it's always sent in batches.
Other settings
These settings have no additional help text in the dashboard; only their names are listed here.
- Discord Integration
- Install to your Discord server
- View Channels — list available text channels
- Send Messages & Embed Links — post forwarded content
- Manage Webhooks — create webhooks on your behalf in the channels you pick
- Install to server
- Installed
- Could not determine which channel this install was for. Please go back and start the install again.
- This install authorization has expired or was already used (valid for 10 minutes). Please go back and start the install again.
- Installed on
- Change server
- Remove Discord integration
- ChiwaBots is no longer in this server
- Last error:
- Connected
- Not connected
- Discord channel
- Not set (won't forward)
- Live announcement
- Mention a role
- Display name
- Login name
- Display name (with login)
- Channel URL
- Stream title
- Category
- Message filters
- Send test message
- Save before testing
- Forwarding groups
- This group is on but has no Discord channel yet, so nothing is forwarded.
- The live notice is one message that lives for the whole stream, so it cannot be split across channels per event.
- Per-event channel override
- Follow group
- Emote mapping
- Search emotes
- Clear all mappings
- Clear all
- Not mapped
- This channel has no Twitch emotes of its own, or Twitch isn't connected.
- This Discord server has no custom emojis yet. Upload some on Discord first.
- Stream status
- Supporter events
- Donations
- Chat mirror
- Follow
- Subscribe
- Gift subscription
- Continued sub (gift/Prime to paid)
- Pay it forward
- Watch streak share
- Announcement
- Cheer
- Raid in
- Raid out
- Channel points redemption
- Site tips
- Plan gifts
- External payment tips
- Chat message
- Moderation action