Use webhooks to listen for and respond to events in your Wowza Streaming Cloud account.
Note: To receive event notifications, you have to enable webhooks for your account and create a webhook endpoint. See Receive event notifications with webhooks for more information.
Events
Wowza Streaming Cloud sends webhook events for transcoder and recording actions in JSON format through a POST request. The following sample webhook payload is sent when a transcoder stops.
{
While the payloads for other webhooks are structured similarly, object_data changes to display information specific to the triggered event.
Transcoder and live stream
Wowza Streaming Cloud sends the following events for transcoder actions. The object_id in the payload is the transcoder ID.
Note: These events are triggered for transcoder actions in both the live stream and transcoder workflows.
| Object type | Event | Sample object data | Description |
|---|---|---|---|
| transcoder | start.requested | "object_data": { "uptime_id": "bjwbhwld" } |
Occurs when a request is made to start a transcoder. |
| transcoder | start.complete | "object_data": { "uptime_id": "bjwbhwld", "ip_address": "34.73.51.79" } |
Occurs when the transcoder starts and is available. |
| transcoder | start.canceled | "object_data": { "uptime_id": "null" } |
Occurs when the transcoder cancels the startup process because of a failure. |
| transcoder | reset.requested | "object_data": { "uptime_id": "null", "ip_address": "34.73.51.79" } |
Occurs when a request is made to reset a transcoder. |
| transcoder | stop.complete | "object_data": { "uptime_id": "cczpplpv" } |
Occurs when the transcoder has stopped and is no longer available. |
| transcoder | audio.started | "object_data": { "stream_name": "3920b4c6.stream", "codec": "AAC" } |
Occurs when a running transcoder has started receiving audio. |
| transcoder | audio.stopped | "object_data": { "stream_name": "3920b4c6.stream" } |
Occurs when a running transcoder has stopped receiving audio. |
| transcoder | video.started | "object_data": { "stream_name": "3920b4c6.stream", "height": "720", "width": "1280", "codec": "H264", "codec_string": "avc1.4d402a", "profile": "Main", "level": "1.2" } |
Occurs when a running transcoder has started receiving video. |
| transcoder | video.stopped | "object_data": { "stream_name": "3920b4c6.stream" } |
Occurs when a running transcoder has stopped receiving video. |
Recording
Wowza Streaming Cloud sends the following events for recording actions. The object_id in the payload is the recording ID.
| Object type | Event | Sample object data | Description |
|---|---|---|---|
| recording | converting | "object_data": { "transcoder_id": "b3hjs7ty", "transcoder_uptime_id": "blc5grjh" } |
Occurs when a recording has been created and conversion to mp4 format begins. |
| recording | uploading | "object_data": { "transcoder_id": "b3hjs7ty", "transcoder_uptime_id": "blc5grjh" } |
Occurs when a recording is being uploaded to account storage. |
| recording | completed | "object_data": { "transcoder_id": "b3hjs7ty", "transcoder_uptime_id": "blc5grjh", "file_name": "filename.mp4", "file_size": "117957690", "duration": "546550", "download_url": "https://download_url.mp4" } |
Occurs when a recording is complete and available in account storage. |
| recording | failed | "object_data": { "transcoder_id": "b3hjs7ty", "transcoder_uptime_id": "blc5grjh" } |
Occurs when a recording failed to be converted or uploaded. |
| recording | no_video | "object_data": { "transcoder_id": "b3hjs7ty", "transcoder_uptime_id": "blc5grjh" } |
Occurs when no video content is found for the recording. |
| recording | deleted | "object_data": { "uptime_id": "blc5grih", "transcoder_id": "b3hjs7ty" } |
Occurs when a recording is deleted. |
