5176 5176
5177## Server events5177## Server events
5178 5178
5179<a id="transport.ringing"></a>
5180
5181### transport.ringing
5182
5183The outbound SIP provider leg is ringing or providing early media. Delivered only to sideband observers.
5184
5185#### Schema
5186
5187Schema name: `LiveTransportRinging`
5188
5189- `event_id: string`
5190
5191- `session_id: string`
5192
5193 The canonical Live session ID.
5194
5195- `type: "transport.ringing"`
5196
5197 - `"transport.ringing"`
5198
5199#### Example
5200
5201```json
5202{
5203 "type": "transport.ringing",
5204 "event_id": "event_call_1",
5205 "session_id": "live_u0_123"
5206}
5207```
5208
5209<a id="transport.answered"></a>
5210
5211### transport.answered
5212
5213The outbound SIP provider leg answered and media is established. Delivered only to sideband observers.
5214
5215#### Schema
5216
5217Schema name: `LiveTransportAnswered`
5218
5219- `event_id: string`
5220
5221- `session_id: string`
5222
5223 The canonical Live session ID.
5224
5225- `type: "transport.answered"`
5226
5227 - `"transport.answered"`
5228
5229#### Example
5230
5231```json
5232{
5233 "type": "transport.answered",
5234 "event_id": "event_call_2",
5235 "session_id": "live_u0_123"
5236}
5237```
5238
5239<a id="transport.failed"></a>
5240
5241### transport.failed
5242
5243An asynchronous outbound SIP setup failure. Delivered only to sideband observers.
5244
5245#### Schema
5246
5247Schema name: `LiveTransportFailed`
5248
5249- `error: object { code, message, type, param }`
5250
5251 - `code: string`
5252
5253 The call setup failure code.
5254
5255 - `message: string`
5256
5257 - `type: "call_error"`
5258
5259 - `"call_error"`
5260
5261 - `param: optional string`
5262
5263 The parameter related to the error, if any. Empty when no parameter applies.
5264
5265- `event_id: string`
5266
5267- `session_id: string`
5268
5269 The canonical Live session ID.
5270
5271- `type: "transport.failed"`
5272
5273 - `"transport.failed"`
5274
5275#### Example
5276
5277```json
5278{
5279 "type": "transport.failed",
5280 "event_id": "event_call_4",
5281 "session_id": "live_u0_123",
5282 "error": {
5283 "type": "call_error",
5284 "code": "provider_invite_failed",
5285 "message": "provider rejected the call",
5286 "param": ""
5287 }
5288}
5289```
5290
5179<a id="session.started"></a>5291<a id="session.started"></a>
5180 5292
5181### session.started5293### session.started
7619 "event": "#"7731 "event": "#"
7620}7732}
7621```7733```
7622
7623<a id="transport.ringing"></a>
7624
7625### transport.ringing
7626
7627The outbound SIP provider leg is ringing or providing early media. Delivered only to sideband observers.
7628
7629#### Schema
7630
7631Schema name: `LiveTransportRinging`
7632
7633- `event_id: string`
7634
7635- `session_id: string`
7636
7637 The canonical Live session ID.
7638
7639- `type: "transport.ringing"`
7640
7641 - `"transport.ringing"`
7642
7643#### Example
7644
7645```json
7646{
7647 "type": "transport.ringing",
7648 "event_id": "event_call_1",
7649 "session_id": "live_u0_123"
7650}
7651```
7652
7653<a id="transport.answered"></a>
7654
7655### transport.answered
7656
7657The outbound SIP provider leg answered and media is established. Delivered only to sideband observers.
7658
7659#### Schema
7660
7661Schema name: `LiveTransportAnswered`
7662
7663- `event_id: string`
7664
7665- `session_id: string`
7666
7667 The canonical Live session ID.
7668
7669- `type: "transport.answered"`
7670
7671 - `"transport.answered"`
7672
7673#### Example
7674
7675```json
7676{
7677 "type": "transport.answered",
7678 "event_id": "event_call_2",
7679 "session_id": "live_u0_123"
7680}
7681```
7682
7683<a id="transport.failed"></a>
7684
7685### transport.failed
7686
7687An asynchronous outbound SIP setup failure. Delivered only to sideband observers.
7688
7689#### Schema
7690
7691Schema name: `LiveTransportFailed`
7692
7693- `error: object { code, message, type, param }`
7694
7695 - `code: string`
7696
7697 The call setup failure code.
7698
7699 - `message: string`
7700
7701 - `type: "call_error"`
7702
7703 - `"call_error"`
7704
7705 - `param: optional string`
7706
7707 The parameter related to the error, if any. Empty when no parameter applies.
7708
7709- `event_id: string`
7710
7711- `session_id: string`
7712
7713 The canonical Live session ID.
7714
7715- `type: "transport.failed"`
7716
7717 - `"transport.failed"`
7718
7719#### Example
7720
7721```json
7722{
7723 "type": "transport.failed",
7724 "event_id": "event_call_4",
7725 "session_id": "live_u0_123",
7726 "error": {
7727 "type": "call_error",
7728 "code": "provider_invite_failed",
7729 "message": "provider rejected the call",
7730 "param": ""
7731 }
7732}
7733```