Twitch.SharedChatPrimePaidUpgrade
WebSocket event schema, payload, and examples
user
object required
id
string
login
string
name
string
type
string
role
integer required
Value | Name |
---|---|
0 | Unknown |
1 | Viewer |
2 | Vip |
3 | Moderator |
4 | Broadcaster |
badges
TwitchBadge[]
name
string
version
string
imageUrl
string
info
string
color
string
subscribed
boolean required
subscriptionTier
string
monthsSubscribed
integer required
source
object required
id
string
login
string
name
string
type
string
sourceMessageId
string
sourceBadges
TwitchBadge[]
name
string
version
string
imageUrl
string
info
string
messageId
string
systemMessage
string
isTest
boolean required
isInSharedChat
boolean required
isSharedChatHost
boolean required
isFromSharedChatGuest
boolean required
upgradeTier
string
upgradeTierString
string
Schema
The JSON Schema for the event payload, if available.
schema.json
{
"$schema": "http://json-schema.org/draft-04/schema#",
"title": "TwitchChatNotification_SharedPrimePaidUpgradeEvent",
"type": "object",
"additionalProperties": false,
"properties": {
"user": {
"oneOf": [
{
"type": "null"
},
{
"$ref": "#/definitions/TwitchUser"
}
]
},
"source": {
"oneOf": [
{
"type": "null"
},
{
"$ref": "#/definitions/TwitchBaseUser"
}
]
},
"sourceMessageId": {
"type": [
"null",
"string"
]
},
"sourceBadges": {
"type": [
"array",
"null"
],
"items": {
"$ref": "#/definitions/TwitchBadge"
}
},
"messageId": {
"type": [
"null",
"string"
]
},
"systemMessage": {
"type": [
"null",
"string"
]
},
"isTest": {
"type": "boolean"
},
"isInSharedChat": {
"type": "boolean"
},
"isSharedChatHost": {
"type": "boolean"
},
"isFromSharedChatGuest": {
"type": "boolean"
},
"upgradeTier": {
"type": [
"null",
"string"
]
},
"upgradeTierString": {
"type": [
"null",
"string"
]
}
},
"definitions": {
"TwitchUser": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": [
"null",
"string"
]
},
"login": {
"type": [
"null",
"string"
]
},
"name": {
"type": [
"null",
"string"
]
},
"type": {
"type": [
"null",
"string"
]
},
"role": {
"$ref": "#/definitions/ViewerRole"
},
"badges": {
"type": [
"array",
"null"
],
"items": {
"$ref": "#/definitions/TwitchBadge"
}
},
"color": {
"type": [
"null",
"string"
]
},
"subscribed": {
"type": "boolean"
},
"subscriptionTier": {
"type": [
"null",
"string"
]
},
"monthsSubscribed": {
"type": "integer",
"format": "int32"
}
}
},
"ViewerRole": {
"type": "integer",
"description": "",
"x-enum-names": [
"Unknown",
"Viewer",
"Vip",
"Moderator",
"Broadcaster"
],
"x-enum-varnames": [
"Unknown",
"Viewer",
"Vip",
"Moderator",
"Broadcaster"
],
"x-enumNames": [
"Unknown",
"Viewer",
"Vip",
"Moderator",
"Broadcaster"
],
"x-enum-descriptions": [
null,
null,
null,
null,
null
],
"x-enumDescriptions": [
null,
null,
null,
null,
null
],
"enum": [
0,
1,
2,
3,
4
]
},
"TwitchBadge": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": [
"null",
"string"
]
},
"version": {
"type": [
"null",
"string"
]
},
"imageUrl": {
"type": [
"null",
"string"
]
},
"info": {
"type": [
"null",
"string"
]
}
}
},
"TwitchBaseUser": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": [
"null",
"string"
]
},
"login": {
"type": [
"null",
"string"
]
},
"name": {
"type": [
"null",
"string"
]
},
"type": {
"type": [
"null",
"string"
]
}
}
}
}
}
JSON Payload
An example JSON payload for the event, automatically generated using JSONSchemaFaker
example.json
{
"isFromSharedChatGuest": false,
"isInSharedChat": true,
"isSharedChatHost": true,
"isTest": false,
"messageId": "id Duis eiusmod occaecat velit",
"source": {
"id": "aliqua sunt",
"login": "eu ad dolore Excepteur nisi",
"name": null,
"type": "incididunt"
},
"sourceBadges": [
{
"imageUrl": null,
"info": null,
"name": "laborum occaecat ut Duis",
"version": null
},
{
"imageUrl": "mollit",
"info": null,
"name": null,
"version": "proident adipisicing"
},
{
"imageUrl": "eu deserunt",
"info": null,
"name": null,
"version": "dolore"
},
{
"imageUrl": "ea nulla",
"info": null,
"name": "eiusmod nulla ipsum laborum non",
"version": null
},
{
"imageUrl": null,
"info": "est velit eu dolore",
"name": null,
"version": null
}
],
"sourceMessageId": null,
"systemMessage": null,
"upgradeTier": null,
"upgradeTierString": "mollit in nulla fugiat incididunt",
"user": {
"badges": null,
"color": "ut velit magna consectetur",
"id": null,
"login": "deserunt laboris commodo proident exercitation",
"monthsSubscribed": -88679247,
"name": null,
"role": 4,
"subscribed": true,
"subscriptionTier": null,
"type": null
}
}
Client Example
Example code showing how to subscribe to this event using the Streamer.bot WebSocket Client
index.js
// Initialize the Streamer.bot WebSocket Client
const client = new StreamerbotClient();
// Subscribe to "Twitch.SharedChatPrimePaidUpgrade" events and register a callback
client.on('Twitch.SharedChatPrimePaidUpgrade', ({ event, data }) => {
// Code here will run every time the event is received!
console.log('Received event:', event.source, event.type);
console.log('Event data:', data);
});