Skip to main content

Overlay Broadcast

Overview

The channel.overlay.broadcast topic delivers custom events to a channel's overlays in real-time. Events can target all overlays globally or a specific overlay by ID.

Payload

{
"id": "01J6VTDB25SX14GDBDFZWDX3M9",
"ts": "2024-09-03T11:30:39Z",
"type": "message",
"topic": "channel.overlay.broadcast",
"room": "5ad23dcc18fff500d78c5348",
"data": {
"target": "global",
"event": "my-custom-event",
"data": {
"key": "value"
}
}
}

Fields

FieldTypeDescription
targetstring"global" to target all overlays, or a specific overlay ID
eventstringCustom event name (max 256 characters)
dataobjectCustom event payload (max 5KB)