Server Webhooks
Webhooks are user-defined HTTP callbacks that can send event-triggered notifications or updates to an external web server. You can use webhooks to hook your own processing into LiveSwitch events. LiveSwitch sends out webhook event updates as an HTTP POST request with the body formatted in JSON.
Server Webhooks allow you to hook into server-level events.
Server Started
This event triggers when any server starts running.
Server Started sample JSON object
{
"timestamp": 1562614545646,
"origin": "gateway", // or "mediaserver" or "sipconnector" or "recordingmonitor" or "recordingmover" or "recordingmuxer"
"type": "gateway.started", // or "mediaserver.started" or "sipconnector.started" or "recordingmonitor.started" or "recordingmover.started" or "recordingmuxer.started"
"gateway": {
"id": "dc5e5677-5b0d-4b3e-b2a5-42761849ae19",
"version": 0.0.0.0,
"machineName": "MY-SERVER",
"coreCount": 12,
"operatingSystem": "windows",
"operatingSystemVersion": "6.2.9200.0",
"architecture": "x64",
"networkinterfaces": [...],
"deploymentId": "<string>",
"publicIPAddresses": [...]
}
}
Server Stopped
This event triggers when any server stops running.
Server Stopped sample JSON object
{
"timestamp": 1562614545646,
"origin": "gateway", // or "mediaserver" or "sipconnector" or "recordingmonitor" or "recordingmover" or "recordingmuxer"
"type": "gateway.stopped", // or "mediaserver.stopped" or "sipconnector.stopped" or "recordingmonitor.stopped" or "recordingmover.stopped" or "recordingmuxer.stopped"
"gateway": {
"id": "dc5e5677-5b0d-4b3e-b2a5-42761849ae19",
"version": 0.0.0.0,
"machineName": "MY-SERVER",
"coreCount": 12,
"operatingSystem": "windows",
"operatingSystemVersion": "6.2.9200.0",
"architecture": "x64",
"networkinterfaces": [...],
"deploymentId": "<string>",
"publicIPAddresses": [...]
}
}
Server Registered
This event triggers when either the Media Server or SIP Connector registers to the Gateway.
Server Registered sample JSON object
{
"timestamp": 1562614545646,
"origin": "mediaserver", // or "sipconnector" or "recordingmonitor" or "recordingmover" or "recordingmuxer"
"type": "mediaserver.registered", // or "sipconnector.registered" or "recordingmonitor.registered" or "recordingmover.registered" or "recordingmuxer.registered"
"mediaserver": {
"iceServerUris": [...],
"region": "en-us",
"id": "dc5e5677-5b0d-4b3e-b2a5-42761849ae19",
"version": 0.0.0.0,
"machineName": "MY-SERVER",
"coreCount": 12,
"operatingSystem": "windows",
"operatingSystemVersion": "6.2.9200.0",
"architecture": "x64",
"networkinterfaces": [...],
"deploymentId": "<string>",
}
}
Server Unregistered
This event triggers when either the Media Server or SIP Connector unregisters from the Gateway.
Server Unregistered sample JSON object
{
"timestamp": 1562614545646,
"origin": "mediaserver", // or "sipconnector" or "recordingmonitor" or "recordingmover" or "recordingmuxer"
"type": "mediaserver.unregistered", // or "sipconnector.unregistered" or "recordingmonitor.unregistered" or "recordingmover.unregistered" or "recordingmuxer.unregistered"
"mediaserver": {
"iceServerUris": [...],
"region": "en-us",
"id": "dc5e5677-5b0d-4b3e-b2a5-42761849ae19",
"version": 0.0.0.0,
"machineName": "MY-SERVER",
"coreCount": 12,
"operatingSystem": "windows",
"operatingSystemVersion": "6.2.9200.0",
"architecture": "x64",
"networkinterfaces": [...],
"deploymentId": "<string>",
}
}