`Twitch.Announcement`

WebSocket event schema, payload, and examples

Properties

text

string

parts

TwitchMessagePartBase[]

user

object required

string

name

string

type

string

role

integer required

Value	Name
0	Unknown
1	Viewer
2	Vip
3	Moderator
4	Broadcaster

badges

TwitchBadge[]

color

string

subscribed

boolean required

subscriptionTier

string

monthsSubscribed

integer required

messageId

string

systemMessage

string

isTest

boolean required

isInSharedChat

boolean required

isSharedChatHost

boolean required

isFromSharedChatGuest

boolean required

announcementColor

string

Schema

The JSON Schema for the event payload, if available.

schema.json

{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "TwitchChatNotification_Announcement",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "text": {
      "type": [
        "null",
        "string"
      ]
    },
    "parts": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/definitions/TwitchMessagePartBase"
      }
    },
    "user": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "$ref": "#/definitions/TwitchUser"
        }
      ]
    },
    "messageId": {
      "type": [
        "null",
        "string"
      ]
    },
    "systemMessage": {
      "type": [
        "null",
        "string"
      ]
    },
    "isTest": {
      "type": "boolean"
    },
    "isInSharedChat": {
      "type": "boolean"
    },
    "isSharedChatHost": {
      "type": "boolean"
    },
    "isFromSharedChatGuest": {
      "type": "boolean"
    },
    "announcementColor": {
      "type": [
        "null",
        "string"
      ]
    }
  },
  "definitions": {
    "TwitchMessagePartBase": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "type": {
          "type": [
            "null",
            "string"
          ]
        },
        "text": {
          "type": [
            "null",
            "string"
          ]
        }
      }
    },
    "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"
          ]
        }
      }
    }
  }
}

JSON Payload

An example JSON payload for the event, automatically generated using JSONSchemaFaker

example.json

{
  "announcementColor": "deserunt laboris",
  "isFromSharedChatGuest": true,
  "isInSharedChat": true,
  "isSharedChatHost": false,
  "isTest": false,
  "messageId": null,
  "parts": [
    {
      "text": "id deserunt proident ullamco cillum",
      "type": "in sed veniam eiusmod"
    },
    {
      "text": null,
      "type": "nostrud adipisicing"
    },
    {
      "text": null,
      "type": null
    },
    {
      "text": "sunt laborum id",
      "type": null
    },
    {
      "text": "dolor ullamco enim velit",
      "type": null
    }
  ],
  "systemMessage": "laboris",
  "text": "veniam ut",
  "user": {
    "badges": [
      {
        "imageUrl": null,
        "info": "ad sed magna",
        "name": "est esse",
        "version": "laboris Duis nulla ex"
      },
      {
        "imageUrl": null,
        "info": "aliquip cillum deserunt",
        "name": null,
        "version": "eiusmod pariatur velit do"
      },
      {
        "imageUrl": null,
        "info": null,
        "name": null,
        "version": null
      },
      {
        "imageUrl": "minim est ea amet",
        "info": "magna nisi consequat sit",
        "name": "in dolore",
        "version": "enim Ut"
      },
      {
        "imageUrl": "adipisicing consequat",
        "info": "ullamco",
        "name": null,
        "version": null
      }
    ],
    "color": null,
    "id": null,
    "login": null,
    "monthsSubscribed": -43302151,
    "name": "in incididunt deserunt elit",
    "role": 4,
    "subscribed": false,
    "subscriptionTier": null,
    "type": "ullamco ipsum"
  }
}

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.Announcement" events and register a callback
client.on('Twitch.Announcement', ({ 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);
});