Bot Whispers

Trigger for a Twitch Bot Whisper
Chat Client

Notes

The user sending the whisper must have a verified phone number (see the Phone Number setting in your Security and Privacy settings).

The API may silently drop whispers that it suspects of violating Twitch policies, it will still indicate success even if the message is dropped.

Rate Limits: You may whisper to a maximum of 40 unique recipients per day. Within the per day limit, you may whisper a maximum of 3 whispers per second and a maximum of 100 whispers per minute.

The maximum message lengths are:

  • 500 characters if the user you're sending the message to hasn't whispered you before.
  • 10,000 characters if the user you're sending the message to has whispered you before.

Messages that exceed the maximum length are truncated.

Variables

NameTypeDescription
Example Value:3

The count of badges this user has

A C# accessible list of emotes used in the chat message

Example Value:false

Is the broadcaster an affiliate?

Example Value:true

Is the broadcaster a partner?

Example Value:TwitchUser123

The Twitch display name of the broadcaster account

Example Value:a126e8a8-43f7-4a14-8990-e8c3feea76d8

The Twitch user ID of the broadcaster account

Example Value:twitchuser123

The Twitch user name of the broadcaster account

Example Value:true

Is this user a moderator?

Example Value:true

Is this user subscribed?

Example Value:true

Is this user a VIP?

Example Value:3

The amount of months the user is subscribed

Example Value:3000

The subscription tier (T1 = 1000, T2 = 2000, T3 = 3000) (only available if isSubscribed is True)

Example Value:TwitchUser123

The display name of the user

Example Value:Awesome Streamers,Discord Peeps,Top Contributors

Comma-delimited list of groups the user is in

Example Value:718933593

Unique user identifier

Example Value:twitchuser123

The login name of the user

Example Value:8/4/2023 10:56:06 AM

When was this user last active?

Example Value:twitch

Streaming service of this user