Skip to content
StreamElements Docs

Chatbot Counters

Topic
channel.chatbot.counters

This event is triggered whenever a chatbot counter value changes, whether through increment, decrement, or reset operations. Counter changes can originate from counter edits in the dashboard, the $(count) variable, or the !editcounter command. It provides real-time updates of counter values, enabling immediate synchronization across your applications. Subscribe to this topic to receive real-time notifications about changes to your chatbot counters. This is particularly useful for maintaining accurate counter displays in overlays, applications, or other integrations that need to reflect the current state of your chatbot counters.

Payload

Section titled “Payload”
Parameter Type Description
data.counter string The name of the counter that was updated
data.value number The current value of the counter after the update operation

Example

Section titled “Example”
{
    "id": "01HB0YF39XF16HMHCPDYZYJYFL",
    "ts": "2023-09-23T12:10:25Z",
    "type": "message",
    "topic": "channel.chatbot.counters",
    "data": {
        "counter": "deaths",
        "value": 42
    }
}

Subscription Request

Section titled “Subscription Request”
{
  "type": "subscribe",
  "nonce": "86ccb2b3-eb8d-4b3c-902d-509c3f5ca88c",
  "data": {
    "topic": "channel.chatbot.counters",
    "room": "channelId123",
    "token": "YOUR_JWT_TOKEN",
    "token_type": "jwt"
  }
}
Section titled “Related”