Wiki source code of Call Segments
Version 24.1 by hanlys on 2016/01/06 11:17
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{layout}} | ||
| 2 | {{layout-section ac:type="two_right_sidebar"}} | ||
| 3 | {{layout-cell}} | ||
| 4 | {{warning}} | ||
| 5 | This page is currently being written. Although the information below is probably accurate, it may not be complete or may have errors. | ||
| 6 | {{/warning}} | ||
| 7 | |||
| 8 | {{info}} | ||
| 9 | The information on this page applies to **iSymphony 3.2+**. | ||
| 10 | {{/info}} | ||
| 11 | |||
| 12 | {{note}} | ||
| 13 | This resource is restricted by licensing. See the resource and action path information below for more details. | ||
| 14 | {{/note}} | ||
| 15 | |||
| 16 | = (% style="color: rgb(0,0,0);" %)Description(%%) = | ||
| 17 | |||
| 18 | The live call segment REST resource provides access to information about call segments in the system, including call segments bound to an extension, waiting in a queue, or related to other call segments. This resource provides actions to transfer call segments to other destinations. | ||
| 19 | |||
| 20 | {{info}} | ||
| 21 | This resource does not provide any sub resources, but does provide references to other call segments, as the relationships between call segments represent call state between two endpoints. | ||
| 22 | {{/info}} | ||
| 23 | {{/layout-cell}} | ||
| 24 | |||
| 25 | {{layout-cell}} | ||
| 26 | {{panel title="On this page:"}} | ||
| 27 | |||
| 28 | |||
| 29 | {{toc maxLevel="2" indent="1"/}} | ||
| 30 | {{/panel}} | ||
| 31 | {{/layout-cell}} | ||
| 32 | {{/layout-section}} | ||
| 33 | |||
| 34 | {{layout-section ac:type="single"}} | ||
| 35 | {{layout-cell}} | ||
| 36 | (% style="color: rgb(0,0,0);" %) | ||
| 37 | |||
| 38 | |||
| 39 | = (% style="color: rgb(0,0,0);" %)JSON Representation(%%) = | ||
| 40 | |||
| 41 | {{code}} | ||
| 42 | { | ||
| 43 | "id": "804dbbc2-c4e3-47f2-96b9-b8262d542e7c", | ||
| 44 | "type": "INTERNAL", | ||
| 45 | "callerId": { | ||
| 46 | "id": "c9450235-0f6d-4e0f-bb3b-3fef010d8617", | ||
| 47 | "name": "Michael Y", | ||
| 48 | "number": "4224" | ||
| 49 | }, | ||
| 50 | "did": "s", | ||
| 51 | "onHold": false, | ||
| 52 | "recording": false, | ||
| 53 | "incoming": true, | ||
| 54 | } | ||
| 55 | {{/code}} | ||
| 56 | |||
| 57 | (% style="line-height: 1.4285715;" %) | ||
| 58 | |=((( | ||
| 59 | Property | ||
| 60 | )))|=((( | ||
| 61 | Type | ||
| 62 | )))|=((( | ||
| 63 | Description | ||
| 64 | ))) | ||
| 65 | |((( | ||
| 66 | {{{id}}} | ||
| 67 | )))|((( | ||
| 68 | String | ||
| 69 | )))|((( | ||
| 70 | The id of the call segment. | ||
| 71 | ))) | ||
| 72 | |(% colspan="1" %)(% colspan="1" %) | ||
| 73 | ((( | ||
| 74 | type | ||
| 75 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 76 | ((( | ||
| 77 | String | ||
| 78 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 79 | ((( | ||
| 80 | The Type of the call segment. Values are (% style="font-family: monospace;" %)Internal(%%) (Call Segment is bound to an internal extension), and External (Call Segment is bound to an external source). | ||
| 81 | |||
| 82 | {{info}} | ||
| 83 | If the system cannot determine the extension a call segment is bound to (i.e. the extension is not configured in iSymphony), the type will be set to External. | ||
| 84 | {{/info}} | ||
| 85 | ))) | ||
| 86 | |(% colspan="1" %)(% colspan="1" %) | ||
| 87 | ((( | ||
| 88 | callerId:id | ||
| 89 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 90 | ((( | ||
| 91 | String | ||
| 92 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 93 | ((( | ||
| 94 | The id of the call segment's caller id object. | ||
| 95 | ))) | ||
| 96 | |(% colspan="1" %)(% colspan="1" %) | ||
| 97 | ((( | ||
| 98 | callerId:name | ||
| 99 | |||
| 100 | {{{}}} | ||
| 101 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 102 | ((( | ||
| 103 | String | ||
| 104 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 105 | ((( | ||
| 106 | The caller id name of the call segment. | ||
| 107 | ))) | ||
| 108 | |(% colspan="1" %)(% colspan="1" %) | ||
| 109 | ((( | ||
| 110 | {{{callerId:number}}} | ||
| 111 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 112 | ((( | ||
| 113 | String | ||
| 114 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 115 | ((( | ||
| 116 | The caller id number of the call segment. | ||
| 117 | ))) | ||
| 118 | |(% colspan="1" %)(% colspan="1" %) | ||
| 119 | ((( | ||
| 120 | did | ||
| 121 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 122 | ((( | ||
| 123 | String | ||
| 124 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 125 | ((( | ||
| 126 | The number the caller used to enter the phone system, or null if the call segment was created in response to a dial, or no DID could be determined for the call. | ||
| 127 | ))) | ||
| 128 | |(% colspan="1" %)(% colspan="1" %) | ||
| 129 | ((( | ||
| 130 | onHold | ||
| 131 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 132 | ((( | ||
| 133 | Boolean | ||
| 134 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 135 | ((( | ||
| 136 | Specifies if the current call segment is on hold or not. | ||
| 137 | ))) | ||
| 138 | |(% colspan="1" %)(% colspan="1" %) | ||
| 139 | ((( | ||
| 140 | recording | ||
| 141 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 142 | ((( | ||
| 143 | Boolean | ||
| 144 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 145 | ((( | ||
| 146 | Specifies if the call segment is currently being recorded or not. | ||
| 147 | ))) | ||
| 148 | |(% colspan="1" %)(% colspan="1" %) | ||
| 149 | ((( | ||
| 150 | incoming | ||
| 151 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 152 | ((( | ||
| 153 | Boolean | ||
| 154 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 155 | ((( | ||
| 156 | Species if the call segment is being dialed by another call segment (i.e. receiving a call) | ||
| 157 | ))) | ||
| 158 | |||
| 159 | = Root Resource Paths = | ||
| 160 | |||
| 161 | Paths used to access sets of the resource, in relation to parent resources. | ||
| 162 | |||
| 163 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 164 | ((( | ||
| 165 | {{{communication_manager/rest/live/coreServers/[{core_server_id} | getByName/{core_server_slug}]/callSegments}}} | ||
| 166 | ))) | ||
| 167 | |(% class="highlight-grey" data-highlight-colour="grey" %)(% class="highlight-grey" data-highlight-colour="grey" %) | ||
| 168 | ((( | ||
| 169 | **Description** | ||
| 170 | )))|((( | ||
| 171 | Provides access to all call segments in a specified core server. | ||
| 172 | |||
| 173 | {{info}} | ||
| 174 | Excludes any call segments that are not related to an extension that is bound to a licensed/full user, or have not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 175 | {{/info}} | ||
| 176 | |||
| 177 | **Parameters:** | ||
| 178 | |||
| 179 | * core_server_id: the id of the parent core server\\ | ||
| 180 | * core_server_slug: the slug of the parent core server | ||
| 181 | |||
| 182 | **Errors:** | ||
| 183 | |||
| 184 | * 404 Not Found: Returned if no core server with the given id or slug exists | ||
| 185 | ))) | ||
| 186 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 187 | ((( | ||
| 188 | **GET** | ||
| 189 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 190 | ((( | ||
| 191 | Gets all call segments in the specified core server. | ||
| 192 | ))) | ||
| 193 | |(% colspan="1" %)(% colspan="1" %) | ||
| 194 | ((( | ||
| 195 | |||
| 196 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 197 | ((( | ||
| 198 | |||
| 199 | ))) | ||
| 200 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 201 | ((( | ||
| 202 | {{{communication_manager/rest/live/coreServers/[{core_server_id} | getByName/{core_server_slug}]/extensions/[{extensions_id} | getByName/{extension_number}]/callSegments}}} | ||
| 203 | ))) | ||
| 204 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 205 | ((( | ||
| 206 | **Description** | ||
| 207 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 208 | ((( | ||
| 209 | Provides access to all call segments bound to a specified extension. | ||
| 210 | |||
| 211 | {{info}} | ||
| 212 | Excludes any call segments that are not related to an extension that is bound to a licensed/full user, or have not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 213 | {{/info}} | ||
| 214 | |||
| 215 | **Parameters:** | ||
| 216 | |||
| 217 | * core_server_id: the id of the parent core server\\ | ||
| 218 | * core_server_slug: the slug of the parent core server | ||
| 219 | * extension_id: the id of the parent extension | ||
| 220 | * (% style="font-family: monospace;" %)extension_number(%%): the extension number of the parent extension | ||
| 221 | |||
| 222 | **Errors:** | ||
| 223 | |||
| 224 | * 404 Not Found: Returned if no core server with the given id or slug exists | ||
| 225 | * 404 Not Found: Returned if no user with the given id or username exists | ||
| 226 | * 403 Forbidden: Returned if the extension is not bound to a licensed/full user | ||
| 227 | ))) | ||
| 228 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 229 | ((( | ||
| 230 | **GET** | ||
| 231 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 232 | ((( | ||
| 233 | Gets all call segment bound to a specified extension. | ||
| 234 | ))) | ||
| 235 | |(% colspan="2" %)(% colspan="2" %) | ||
| 236 | ((( | ||
| 237 | |||
| 238 | ))) | ||
| 239 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 240 | ((( | ||
| 241 | {{{communication_manager/rest/live/coreServers/[{core_server_id} | getByName/{core_server_slug}]/callSegments/{call_segment_id}/dialingToCallSegments}}} | ||
| 242 | ))) | ||
| 243 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 244 | ((( | ||
| 245 | **Description** | ||
| 246 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 247 | ((( | ||
| 248 | Provides access to all call segments the specified call segment is dialing. | ||
| 249 | |||
| 250 | {{info}} | ||
| 251 | Excludes any call segments that are not related to an extension that is bound to a licensed/full user, or have not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 252 | {{/info}} | ||
| 253 | |||
| 254 | **Parameters:** | ||
| 255 | |||
| 256 | * core_server_id: the id of the parent core server\\ | ||
| 257 | * core_server_slug: the slug of the parent core server | ||
| 258 | * call_segment_id: the id of the parent call segment | ||
| 259 | |||
| 260 | **Errors:** | ||
| 261 | |||
| 262 | * 404 Not Found: Returned if no core server with the given id or slug exists | ||
| 263 | * 404 Not Found: Returned if no user with the given id or username exists | ||
| 264 | * 403 Forbidden(% style="line-height: 1.4285715;" %): Returned if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 265 | ))) | ||
| 266 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 267 | ((( | ||
| 268 | **GET** | ||
| 269 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 270 | ((( | ||
| 271 | Gets all call segments the specified call segment is dialing. | ||
| 272 | ))) | ||
| 273 | |||
| 274 | = Instance Resource Paths = | ||
| 275 | |||
| 276 | Paths used to access a specific instance of the resource. | ||
| 277 | |||
| 278 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 279 | ((( | ||
| 280 | {{{{root_resource_path}/{call_segment_id}}}} | ||
| 281 | ))) | ||
| 282 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 283 | ((( | ||
| 284 | **Description** | ||
| 285 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 286 | ((( | ||
| 287 | Provides access to a specified call segment, by call segment id. | ||
| 288 | |||
| 289 | {{info}} | ||
| 290 | This resource will not be available if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 291 | {{/info}} | ||
| 292 | |||
| 293 | **Parameters:** | ||
| 294 | |||
| 295 | * root_resource_path: One of the root resource paths for this resource. See Root Resource Paths above | ||
| 296 | * call_segment_id: the id of the call segment to access | ||
| 297 | |||
| 298 | **Errors:** | ||
| 299 | |||
| 300 | * 404 Not Found: Returned if any of the ancestors in the root resource path could not be found | ||
| 301 | * 404 Not Found: Returned if no call segment with the specified call segment id could be found | ||
| 302 | * 403 Forbidden: Returned if any of the parents specified in the root resource path are restricted | ||
| 303 | * 403 Forbidden: Returned if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 304 | ))) | ||
| 305 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 306 | ((( | ||
| 307 | **GET** | ||
| 308 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 309 | ((( | ||
| 310 | Gets the specified call segment. | ||
| 311 | ))) | ||
| 312 | |(% colspan="2" %)(% colspan="2" %) | ||
| 313 | ((( | ||
| 314 | |||
| 315 | ))) | ||
| 316 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 317 | ((( | ||
| 318 | {{{communication_manager/rest/live/coreServers/[{core_server_id} | getByName/{core_server_slug}]/callSegments/{call_segment_id}/dialingFromCallSegment}}} | ||
| 319 | ))) | ||
| 320 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 321 | ((( | ||
| 322 | **Description** | ||
| 323 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 324 | ((( | ||
| 325 | Provides access to the call segment that is dialing the specified call segment. | ||
| 326 | |||
| 327 | {{info}} | ||
| 328 | This resource will not be available if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 329 | {{/info}} | ||
| 330 | |||
| 331 | **Parameters:** | ||
| 332 | |||
| 333 | * root_resource_path: One of the root resource paths for this resource. See Root Resource Paths above | ||
| 334 | * call_segment_id: the id of the parent call segment | ||
| 335 | |||
| 336 | **Errors:** | ||
| 337 | |||
| 338 | * 404 Not Found: Returned if any of the ancestors in the root resource path could not be found | ||
| 339 | * 404 Not Found: Returned if no call segment with the specified call segment id could be found | ||
| 340 | * 404 Not Found: Returned if the specified call segment is not being dialed by another call segment | ||
| 341 | * 403 Forbidden: Returned if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 342 | ))) | ||
| 343 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 344 | ((( | ||
| 345 | **GET** | ||
| 346 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 347 | ((( | ||
| 348 | Gets the call segment that is dialing the specified call segment. | ||
| 349 | ))) | ||
| 350 | |(% colspan="2" %)(% colspan="2" %) | ||
| 351 | ((( | ||
| 352 | |||
| 353 | ))) | ||
| 354 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 355 | ((( | ||
| 356 | {{{communication_manager/rest/live/coreServers/[{core_server_id} | getByName/{core_server_slug}]/callSegments/{call_segment_id}/linkedCallSegment}}} | ||
| 357 | ))) | ||
| 358 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 359 | ((( | ||
| 360 | **Description** | ||
| 361 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 362 | ((( | ||
| 363 | Provides access to the call segment that the specified call segment is linked to. | ||
| 364 | |||
| 365 | {{info}} | ||
| 366 | This resource will not be available if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 367 | {{/info}} | ||
| 368 | |||
| 369 | **Parameters:** | ||
| 370 | |||
| 371 | * root_resource_path: One of the root resource paths for this resource. See Root Resource Paths above | ||
| 372 | * call_segment_id: the id of the parent call segment | ||
| 373 | |||
| 374 | **Errors:** | ||
| 375 | |||
| 376 | * 404 Not Found: Returned if any of the ancestors in the root resource path could not be found | ||
| 377 | * 404 Not Found: Returned if no call segment with the specified call segment id could be found | ||
| 378 | * 404 Not Found: Returned if the specified call segment is not linked to another call segment | ||
| 379 | * 403 Forbidden: Returned if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 380 | ))) | ||
| 381 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 382 | ((( | ||
| 383 | **GET** | ||
| 384 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 385 | ((( | ||
| 386 | Gets the call segment that the specified call segment is linked to. | ||
| 387 | ))) | ||
| 388 | |||
| 389 | = Action Paths = | ||
| 390 | |||
| 391 | Actions that can be performed on this resource. | ||
| 392 | |||
| 393 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 394 | ((( | ||
| 395 | {{{{instance_resource_path}/transfer}}} | ||
| 396 | ))) | ||
| 397 | |=(% class="highlight-grey" data-highlight-colour="grey" %)(% class="highlight-grey" data-highlight-colour="grey" %) | ||
| 398 | ((( | ||
| 399 | **Description** | ||
| 400 | )))|((( | ||
| 401 | Transfers the call segment, that is bound to the specified call segment. | ||
| 402 | |||
| 403 | {{info}} | ||
| 404 | This action will not be available if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 405 | {{/info}} | ||
| 406 | |||
| 407 | {{note}} | ||
| 408 | The call segment that is specified in the path is not the call segment that will be transferred. The call segment that is bound to the specified call segment (e.g. linked call segment or dialing from call segment) will be transferred. | ||
| 409 | |||
| 410 | For example: | ||
| 411 | |||
| 412 | If extension 100 and 200 are on a linked call, and you wish to transfer the user behind extension 200 to another destination, you must execute the transfer action on extension 100's call segment. | ||
| 413 | {{/note}} | ||
| 414 | |||
| 415 | (% style="line-height: 1.4285715;" %)**Parameters:** | ||
| 416 | |||
| 417 | * instance_resource_path: One of the instance resource paths for this resource. See Instance Resource Paths above | ||
| 418 | |||
| 419 | **Errors:** | ||
| 420 | |||
| 421 | * 404 Not Found: Returned if any of the ancestors in the instance resource path could not be found | ||
| 422 | * 403 Forbidden(% style="line-height: 1.4285715;" %): Returned if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 423 | * 422 Unprocessable Entity: Returned if no destination number value was provided(% style="line-height: 1.4285715;" %) | ||
| 424 | |||
| 425 | * 422 Unprocessable Entity: Returned if no attended value was provided | ||
| 426 | * 422 Unprocessable Entity: Returned if the attended value provided is not a boolean value | ||
| 427 | ))) | ||
| 428 | |=(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 429 | ((( | ||
| 430 | **JSON** | ||
| 431 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 432 | ((( | ||
| 433 | {{code}} | ||
| 434 | { | ||
| 435 | "destinationNumber": "18005555555", | ||
| 436 | "attended" : false | ||
| 437 | } | ||
| 438 | {{/code}} | ||
| 439 | |||
| 440 | **Properties:** | ||
| 441 | |||
| 442 | |=((( | ||
| 443 | Property | ||
| 444 | )))|=((( | ||
| 445 | Type | ||
| 446 | )))|=((( | ||
| 447 | Description | ||
| 448 | ))) | ||
| 449 | |(% colspan="1" %)(% colspan="1" %) | ||
| 450 | ((( | ||
| 451 | {{{destinationNumber}}} | ||
| 452 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 453 | ((( | ||
| 454 | String | ||
| 455 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 456 | ((( | ||
| 457 | The number to transfer to. | ||
| 458 | ))) | ||
| 459 | |(% colspan="1" %)(% colspan="1" %) | ||
| 460 | ((( | ||
| 461 | attended | ||
| 462 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 463 | ((( | ||
| 464 | Boolean | ||
| 465 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 466 | ((( | ||
| 467 | Specifies if the transfer should be attended or not. | ||
| 468 | |||
| 469 | {{info}} | ||
| 470 | Attended transfers should no be performed, if the call source is not an extension. | ||
| 471 | {{/info}} | ||
| 472 | ))) | ||
| 473 | |||
| 474 | ** | ||
| 475 | ** | ||
| 476 | ))) | ||
| 477 | |=(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 478 | ((( | ||
| 479 | **POST | ||
| 480 | ** | ||
| 481 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 482 | ((( | ||
| 483 | Transfers the call segment, that is bound to the specified call segment. | ||
| 484 | ))) | ||
| 485 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 486 | ((( | ||
| 487 | {{{{instance_resource_path}/kick}}} | ||
| 488 | ))) | ||
| 489 | |=(% colspan="1" %)(% colspan="1" %) | ||
| 490 | ((( | ||
| 491 | **Description** | ||
| 492 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 493 | ((( | ||
| 494 | Kicks the call segment from it's current conference room. | ||
| 495 | |||
| 496 | {{info}} | ||
| 497 | (% style="line-height: 1.42857;" %)This action is only available on servers that have conference rooms enabled. | ||
| 498 | {{/info}} | ||
| 499 | |||
| 500 | {{note}} | ||
| 501 | This action can only be performed on call segments that are in conference rooms. | ||
| 502 | {{/note}} | ||
| 503 | |||
| 504 | (% style="line-height: 1.42857;" %)**Errors:** | ||
| 505 | |||
| 506 | * 404 Not Found: Returned if any of the ancestors in the instance resource path could not be found. | ||
| 507 | * 500 Internal Server Error: Returned if the specified call segment is not on a server with conference rooms enabled. | ||
| 508 | ))) | ||
| 509 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 510 | ((( | ||
| 511 | {{{{instance_resource_path}/mute}}} | ||
| 512 | ))) | ||
| 513 | |=(% colspan="1" %)(% colspan="1" %) | ||
| 514 | ((( | ||
| 515 | **Description** | ||
| 516 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 517 | ((( | ||
| 518 | Mutes the call segment in a conference room. | ||
| 519 | |||
| 520 | {{info}} | ||
| 521 | This action is only available on servers that have conference rooms enabled. | ||
| 522 | {{/info}} | ||
| 523 | |||
| 524 | {{note}} | ||
| 525 | This action can only be performed on call segments that are in conference rooms. | ||
| 526 | {{/note}} | ||
| 527 | |||
| 528 | **Errors:** | ||
| 529 | |||
| 530 | * 404 Not Found: Returned if any of the ancestors in the instance resource path could not be found. | ||
| 531 | * 500 Internal Server Error: Returned if the specified call segment is not on a server with conference rooms enabled. | ||
| 532 | |||
| 533 | |||
| 534 | ))) | ||
| 535 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 536 | ((( | ||
| 537 | {{{{instance_resource_path}/unmute}}} | ||
| 538 | ))) | ||
| 539 | |=(% colspan="1" %)(% colspan="1" %) | ||
| 540 | ((( | ||
| 541 | |||
| 542 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 543 | ((( | ||
| 544 | Unmutes the call segment in the conference room. | ||
| 545 | |||
| 546 | {{info}} | ||
| 547 | This action is only available on servers that have conference rooms enabled. | ||
| 548 | {{/info}} | ||
| 549 | |||
| 550 | {{note}} | ||
| 551 | This action can only be performed on call segments that are in conference rooms. | ||
| 552 | {{/note}} | ||
| 553 | |||
| 554 | (% style="line-height: 1.42857;" %)**Errors:** | ||
| 555 | |||
| 556 | * 404 Not Found: Returned if any of the ancestors in the instance resource path could not be found. | ||
| 557 | * 500 Internal Server Error(% style="line-height: 1.42857;" %): Returned if the specified call segment is not on a server with conference rooms enabled. | ||
| 558 | ))) | ||
| 559 | |||
| 560 | |||
| 561 | |||
| 562 | = Curl Examples = | ||
| 563 | |||
| 564 | === Get all call segments in a core server === | ||
| 565 | |||
| 566 | {{code language="bash"}} | ||
| 567 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/callSegments | ||
| 568 | {{/code}} | ||
| 569 | |||
| 570 | === (% style="color: rgb(0,0,0);" %)Get a specific call segment in a core server(%%) === | ||
| 571 | |||
| 572 | {{code language="bash"}} | ||
| 573 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/callSegments/804dbbc2-c4e3-47f2-96b9-b8262d542e7c | ||
| 574 | {{/code}} | ||
| 575 | |||
| 576 | === (% style="color: rgb(0,0,0);" %)Get all call segments owned by an extension(%%) === | ||
| 577 | |||
| 578 | {{code language="bash"}} | ||
| 579 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/extensions/ef2faba9-8557-49c1-9ffc-5a71f41c7a23/callSegments | ||
| 580 | {{/code}} | ||
| 581 | |||
| 582 | === (% style="color: rgb(0,0,0);" %)Get a specific call segment owned by an extension(%%) === | ||
| 583 | |||
| 584 | {{code language="bash"}} | ||
| 585 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/extensions/ef2faba9-8557-49c1-9ffc-5a71f41c7a23/callSegments/804dbbc2-c4e3-47f2-96b9-b8262d542e7c | ||
| 586 | {{/code}} | ||
| 587 | |||
| 588 | === (% style="color: rgb(0,0,0);" %)Get all call segments a specified call segment is dialing(%%) === | ||
| 589 | |||
| 590 | {{code language="bash"}} | ||
| 591 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/callSegments/804dbbc2-c4e3-47f2-96b9-b8262d542e7c/dialingToCallSegments | ||
| 592 | {{/code}} | ||
| 593 | |||
| 594 | === Get a specific call segment a specified call segment is dialing === | ||
| 595 | |||
| 596 | {{code language="bash"}} | ||
| 597 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/callSegments/804dbbc2-c4e3-47f2-96b9-b8262d542e7c/dialingToCallSegments/63844df4-c8f5-4917-9948-30f6251fc763 | ||
| 598 | {{/code}} | ||
| 599 | |||
| 600 | === Get the call segment that is dialing a specified call segment === | ||
| 601 | |||
| 602 | {{code language="bash"}} | ||
| 603 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/callSegments/804dbbc2-c4e3-47f2-96b9-b8262d542e7c/dialingFromCallSegment | ||
| 604 | {{/code}} | ||
| 605 | |||
| 606 | === Get the call segment linked to a specified call segment === | ||
| 607 | |||
| 608 | {{code language="bash"}} | ||
| 609 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/callSegments/804dbbc2-c4e3-47f2-96b9-b8262d542e7c/linkedCallSegment | ||
| 610 | {{/code}} | ||
| 611 | |||
| 612 | === Transfer the call segment the specified call segment is bound to === | ||
| 613 | |||
| 614 | {{note}} | ||
| 615 | See notes in the transfer action path above, concerning which call segment to specify when performing a transfer action. | ||
| 616 | {{/note}} | ||
| 617 | |||
| 618 | {{code language="bash"}} | ||
| 619 | curl --user manager:manag3rpa55word -i -H "Content-Type: application/json" -X POST -d '{"destinationNumber": "18005555555", "attended" : false}' http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/callSegments/804dbbc2-c4e3-47f2-96b9-b8262d542e7c/transfer | ||
| 620 | {{/code}} | ||
| 621 | {{/layout-cell}} | ||
| 622 | {{/layout-section}} | ||
| 623 | {{/layout}} | ||
| 624 | |||
| 625 | {{layout}} | ||
| 626 | {{layout-section ac:type="two_right_sidebar"}} | ||
| 627 | {{layout-cell}} | ||
| 628 | {{warning}} | ||
| 629 | This page is currently being written. Although the information below is probably accurate, it may not be complete or may have errors. | ||
| 630 | {{/warning}} | ||
| 631 | |||
| 632 | {{info}} | ||
| 633 | The information on this page applies to **iSymphony 3.2+**. | ||
| 634 | {{/info}} | ||
| 635 | |||
| 636 | {{note}} | ||
| 637 | This resource is restricted by licensing. See the resource and action path information below for more details. | ||
| 638 | {{/note}} | ||
| 639 | |||
| 640 | = (% style="color: rgb(0,0,0);" %)Description(%%) = | ||
| 641 | |||
| 642 | The live call segment REST resource provides access to information about call segments in the system, including call segments bound to an extension, waiting in a queue, or related to other call segments. This resource provides actions to transfer call segments to other destinations. | ||
| 643 | |||
| 644 | {{info}} | ||
| 645 | This resource does not provide any sub resources, but does provide references to other call segments, as the relationships between call segments represent call state between two endpoints. | ||
| 646 | {{/info}} | ||
| 647 | {{/layout-cell}} | ||
| 648 | |||
| 649 | {{layout-cell}} | ||
| 650 | {{panel title="On this page:"}} | ||
| 651 | |||
| 652 | |||
| 653 | {{toc maxLevel="2" indent="1"/}} | ||
| 654 | {{/panel}} | ||
| 655 | {{/layout-cell}} | ||
| 656 | {{/layout-section}} | ||
| 657 | |||
| 658 | {{layout-section ac:type="single"}} | ||
| 659 | {{layout-cell}} | ||
| 660 | (% style="color: rgb(0,0,0);" %) | ||
| 661 | |||
| 662 | |||
| 663 | = (% style="color: rgb(0,0,0);" %)JSON Representation(%%) = | ||
| 664 | |||
| 665 | {{code}} | ||
| 666 | { | ||
| 667 | "id": "804dbbc2-c4e3-47f2-96b9-b8262d542e7c", | ||
| 668 | "type": "INTERNAL", | ||
| 669 | "callerId": { | ||
| 670 | "id": "c9450235-0f6d-4e0f-bb3b-3fef010d8617", | ||
| 671 | "name": "Michael Y", | ||
| 672 | "number": "4224" | ||
| 673 | }, | ||
| 674 | "did": "s", | ||
| 675 | "onHold": false, | ||
| 676 | "recording": false, | ||
| 677 | "incoming": true, | ||
| 678 | } | ||
| 679 | {{/code}} | ||
| 680 | |||
| 681 | (% style="line-height: 1.4285715;" %) | ||
| 682 | |=((( | ||
| 683 | Property | ||
| 684 | )))|=((( | ||
| 685 | Type | ||
| 686 | )))|=((( | ||
| 687 | Description | ||
| 688 | ))) | ||
| 689 | |((( | ||
| 690 | {{{id}}} | ||
| 691 | )))|((( | ||
| 692 | String | ||
| 693 | )))|((( | ||
| 694 | The id of the call segment. | ||
| 695 | ))) | ||
| 696 | |(% colspan="1" %)(% colspan="1" %) | ||
| 697 | ((( | ||
| 698 | type | ||
| 699 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 700 | ((( | ||
| 701 | String | ||
| 702 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 703 | ((( | ||
| 704 | The Type of the call segment. Values are (% style="font-family: monospace;" %)Internal(%%) (Call Segment is bound to an internal extension), and External (Call Segment is bound to an external source). | ||
| 705 | |||
| 706 | {{info}} | ||
| 707 | If the system cannot determine the extension a call segment is bound to (i.e. the extension is not configured in iSymphony), the type will be set to External. | ||
| 708 | {{/info}} | ||
| 709 | ))) | ||
| 710 | |(% colspan="1" %)(% colspan="1" %) | ||
| 711 | ((( | ||
| 712 | callerId:id | ||
| 713 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 714 | ((( | ||
| 715 | String | ||
| 716 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 717 | ((( | ||
| 718 | The id of the call segment's caller id object. | ||
| 719 | ))) | ||
| 720 | |(% colspan="1" %)(% colspan="1" %) | ||
| 721 | ((( | ||
| 722 | callerId:name | ||
| 723 | |||
| 724 | {{{}}} | ||
| 725 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 726 | ((( | ||
| 727 | String | ||
| 728 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 729 | ((( | ||
| 730 | The caller id name of the call segment. | ||
| 731 | ))) | ||
| 732 | |(% colspan="1" %)(% colspan="1" %) | ||
| 733 | ((( | ||
| 734 | {{{callerId:number}}} | ||
| 735 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 736 | ((( | ||
| 737 | String | ||
| 738 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 739 | ((( | ||
| 740 | The caller id number of the call segment. | ||
| 741 | ))) | ||
| 742 | |(% colspan="1" %)(% colspan="1" %) | ||
| 743 | ((( | ||
| 744 | did | ||
| 745 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 746 | ((( | ||
| 747 | String | ||
| 748 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 749 | ((( | ||
| 750 | The number the caller used to enter the phone system, or null if the call segment was created in response to a dial, or no DID could be determined for the call. | ||
| 751 | ))) | ||
| 752 | |(% colspan="1" %)(% colspan="1" %) | ||
| 753 | ((( | ||
| 754 | onHold | ||
| 755 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 756 | ((( | ||
| 757 | Boolean | ||
| 758 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 759 | ((( | ||
| 760 | Specifies if the current call segment is on hold or not. | ||
| 761 | ))) | ||
| 762 | |(% colspan="1" %)(% colspan="1" %) | ||
| 763 | ((( | ||
| 764 | recording | ||
| 765 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 766 | ((( | ||
| 767 | Boolean | ||
| 768 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 769 | ((( | ||
| 770 | Specifies if the call segment is currently being recorded or not. | ||
| 771 | ))) | ||
| 772 | |(% colspan="1" %)(% colspan="1" %) | ||
| 773 | ((( | ||
| 774 | incoming | ||
| 775 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 776 | ((( | ||
| 777 | Boolean | ||
| 778 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 779 | ((( | ||
| 780 | Species if the call segment is being dialed by another call segment (i.e. receiving a call) | ||
| 781 | ))) | ||
| 782 | |||
| 783 | = Root Resource Paths = | ||
| 784 | |||
| 785 | Paths used to access sets of the resource, in relation to parent resources. | ||
| 786 | |||
| 787 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 788 | ((( | ||
| 789 | {{{communication_manager/rest/live/coreServers/[{core_server_id} | getByName/{core_server_slug}]/callSegments}}} | ||
| 790 | ))) | ||
| 791 | |(% class="highlight-grey" data-highlight-colour="grey" %)(% class="highlight-grey" data-highlight-colour="grey" %) | ||
| 792 | ((( | ||
| 793 | **Description** | ||
| 794 | )))|((( | ||
| 795 | Provides access to all call segments in a specified core server. | ||
| 796 | |||
| 797 | {{info}} | ||
| 798 | Excludes any call segments that are not related to an extension that is bound to a licensed/full user, or have not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 799 | {{/info}} | ||
| 800 | |||
| 801 | **Parameters:** | ||
| 802 | |||
| 803 | * core_server_id: the id of the parent core server\\ | ||
| 804 | * core_server_slug: the slug of the parent core server | ||
| 805 | |||
| 806 | **Errors:** | ||
| 807 | |||
| 808 | * 404 Not Found: Returned if no core server with the given id or slug exists | ||
| 809 | ))) | ||
| 810 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 811 | ((( | ||
| 812 | **GET** | ||
| 813 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 814 | ((( | ||
| 815 | Gets all call segments in the specified core server. | ||
| 816 | ))) | ||
| 817 | |(% colspan="1" %)(% colspan="1" %) | ||
| 818 | ((( | ||
| 819 | |||
| 820 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 821 | ((( | ||
| 822 | |||
| 823 | ))) | ||
| 824 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 825 | ((( | ||
| 826 | {{{communication_manager/rest/live/coreServers/[{core_server_id} | getByName/{core_server_slug}]/extensions/[{extensions_id} | getByName/{extension_number}]/callSegments}}} | ||
| 827 | ))) | ||
| 828 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 829 | ((( | ||
| 830 | **Description** | ||
| 831 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 832 | ((( | ||
| 833 | Provides access to all call segments bound to a specified extension. | ||
| 834 | |||
| 835 | {{info}} | ||
| 836 | Excludes any call segments that are not related to an extension that is bound to a licensed/full user, or have not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 837 | {{/info}} | ||
| 838 | |||
| 839 | **Parameters:** | ||
| 840 | |||
| 841 | * core_server_id: the id of the parent core server\\ | ||
| 842 | * core_server_slug: the slug of the parent core server | ||
| 843 | * extension_id: the id of the parent extension | ||
| 844 | * (% style="font-family: monospace;" %)extension_number(%%): the extension number of the parent extension | ||
| 845 | |||
| 846 | **Errors:** | ||
| 847 | |||
| 848 | * 404 Not Found: Returned if no core server with the given id or slug exists | ||
| 849 | * 404 Not Found: Returned if no user with the given id or username exists | ||
| 850 | * 403 Forbidden: Returned if the extension is not bound to a licensed/full user | ||
| 851 | ))) | ||
| 852 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 853 | ((( | ||
| 854 | **GET** | ||
| 855 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 856 | ((( | ||
| 857 | Gets all call segment bound to a specified extension. | ||
| 858 | ))) | ||
| 859 | |(% colspan="2" %)(% colspan="2" %) | ||
| 860 | ((( | ||
| 861 | |||
| 862 | ))) | ||
| 863 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 864 | ((( | ||
| 865 | {{{communication_manager/rest/live/coreServers/[{core_server_id} | getByName/{core_server_slug}]/callSegments/{call_segment_id}/dialingToCallSegments}}} | ||
| 866 | ))) | ||
| 867 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 868 | ((( | ||
| 869 | **Description** | ||
| 870 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 871 | ((( | ||
| 872 | Provides access to all call segments the specified call segment is dialing. | ||
| 873 | |||
| 874 | {{info}} | ||
| 875 | Excludes any call segments that are not related to an extension that is bound to a licensed/full user, or have not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 876 | {{/info}} | ||
| 877 | |||
| 878 | **Parameters:** | ||
| 879 | |||
| 880 | * core_server_id: the id of the parent core server\\ | ||
| 881 | * core_server_slug: the slug of the parent core server | ||
| 882 | * call_segment_id: the id of the parent call segment | ||
| 883 | |||
| 884 | **Errors:** | ||
| 885 | |||
| 886 | * 404 Not Found: Returned if no core server with the given id or slug exists | ||
| 887 | * 404 Not Found: Returned if no user with the given id or username exists | ||
| 888 | * 403 Forbidden(% style="line-height: 1.4285715;" %): Returned if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 889 | ))) | ||
| 890 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 891 | ((( | ||
| 892 | **GET** | ||
| 893 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 894 | ((( | ||
| 895 | Gets all call segments the specified call segment is dialing. | ||
| 896 | ))) | ||
| 897 | |||
| 898 | = Instance Resource Paths = | ||
| 899 | |||
| 900 | Paths used to access a specific instance of the resource. | ||
| 901 | |||
| 902 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 903 | ((( | ||
| 904 | {{{{root_resource_path}/{call_segment_id}}}} | ||
| 905 | ))) | ||
| 906 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 907 | ((( | ||
| 908 | **Description** | ||
| 909 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 910 | ((( | ||
| 911 | Provides access to a specified call segment, by call segment id. | ||
| 912 | |||
| 913 | {{info}} | ||
| 914 | This resource will not be available if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 915 | {{/info}} | ||
| 916 | |||
| 917 | **Parameters:** | ||
| 918 | |||
| 919 | * root_resource_path: One of the root resource paths for this resource. See Root Resource Paths above | ||
| 920 | * call_segment_id: the id of the call segment to access | ||
| 921 | |||
| 922 | **Errors:** | ||
| 923 | |||
| 924 | * 404 Not Found: Returned if any of the ancestors in the root resource path could not be found | ||
| 925 | * 404 Not Found: Returned if no call segment with the specified call segment id could be found | ||
| 926 | * 403 Forbidden: Returned if any of the parents specified in the root resource path are restricted | ||
| 927 | * 403 Forbidden: Returned if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 928 | ))) | ||
| 929 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 930 | ((( | ||
| 931 | **GET** | ||
| 932 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 933 | ((( | ||
| 934 | Gets the specified call segment. | ||
| 935 | ))) | ||
| 936 | |(% colspan="2" %)(% colspan="2" %) | ||
| 937 | ((( | ||
| 938 | |||
| 939 | ))) | ||
| 940 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 941 | ((( | ||
| 942 | {{{communication_manager/rest/live/coreServers/[{core_server_id} | getByName/{core_server_slug}]/callSegments/{call_segment_id}/dialingFromCallSegment}}} | ||
| 943 | ))) | ||
| 944 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 945 | ((( | ||
| 946 | **Description** | ||
| 947 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 948 | ((( | ||
| 949 | Provides access to the call segment that is dialing the specified call segment. | ||
| 950 | |||
| 951 | {{info}} | ||
| 952 | This resource will not be available if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 953 | {{/info}} | ||
| 954 | |||
| 955 | **Parameters:** | ||
| 956 | |||
| 957 | * root_resource_path: One of the root resource paths for this resource. See Root Resource Paths above | ||
| 958 | * call_segment_id: the id of the parent call segment | ||
| 959 | |||
| 960 | **Errors:** | ||
| 961 | |||
| 962 | * 404 Not Found: Returned if any of the ancestors in the root resource path could not be found | ||
| 963 | * 404 Not Found: Returned if no call segment with the specified call segment id could be found | ||
| 964 | * 404 Not Found: Returned if the specified call segment is not being dialed by another call segment | ||
| 965 | * 403 Forbidden: Returned if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 966 | ))) | ||
| 967 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 968 | ((( | ||
| 969 | **GET** | ||
| 970 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 971 | ((( | ||
| 972 | Gets the call segment that is dialing the specified call segment. | ||
| 973 | ))) | ||
| 974 | |(% colspan="2" %)(% colspan="2" %) | ||
| 975 | ((( | ||
| 976 | |||
| 977 | ))) | ||
| 978 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 979 | ((( | ||
| 980 | {{{communication_manager/rest/live/coreServers/[{core_server_id} | getByName/{core_server_slug}]/callSegments/{call_segment_id}/linkedCallSegment}}} | ||
| 981 | ))) | ||
| 982 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 983 | ((( | ||
| 984 | **Description** | ||
| 985 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 986 | ((( | ||
| 987 | Provides access to the call segment that the specified call segment is linked to. | ||
| 988 | |||
| 989 | {{info}} | ||
| 990 | This resource will not be available if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 991 | {{/info}} | ||
| 992 | |||
| 993 | **Parameters:** | ||
| 994 | |||
| 995 | * root_resource_path: One of the root resource paths for this resource. See Root Resource Paths above | ||
| 996 | * call_segment_id: the id of the parent call segment | ||
| 997 | |||
| 998 | **Errors:** | ||
| 999 | |||
| 1000 | * 404 Not Found: Returned if any of the ancestors in the root resource path could not be found | ||
| 1001 | * 404 Not Found: Returned if no call segment with the specified call segment id could be found | ||
| 1002 | * 404 Not Found: Returned if the specified call segment is not linked to another call segment | ||
| 1003 | * 403 Forbidden: Returned if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 1004 | ))) | ||
| 1005 | |(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 1006 | ((( | ||
| 1007 | **GET** | ||
| 1008 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 1009 | ((( | ||
| 1010 | Gets the call segment that the specified call segment is linked to. | ||
| 1011 | ))) | ||
| 1012 | |||
| 1013 | = Action Paths = | ||
| 1014 | |||
| 1015 | Actions that can be performed on this resource. | ||
| 1016 | |||
| 1017 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 1018 | ((( | ||
| 1019 | {{{{instance_resource_path}/transfer}}} | ||
| 1020 | ))) | ||
| 1021 | |=(% class="highlight-grey" data-highlight-colour="grey" %)(% class="highlight-grey" data-highlight-colour="grey" %) | ||
| 1022 | ((( | ||
| 1023 | **Description** | ||
| 1024 | )))|((( | ||
| 1025 | Transfers the call segment, that is bound to the specified call segment. | ||
| 1026 | |||
| 1027 | {{info}} | ||
| 1028 | This action will not be available if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 1029 | {{/info}} | ||
| 1030 | |||
| 1031 | {{note}} | ||
| 1032 | The call segment that is specified in the path is not the call segment that will be transferred. The call segment that is bound to the specified call segment (e.g. linked call segment or dialing from call segment) will be transferred. | ||
| 1033 | |||
| 1034 | For example: | ||
| 1035 | |||
| 1036 | If extension 100 and 200 are on a linked call, and you wish to transfer the user behind extension 200 to another destination, you must execute the transfer action on extension 100's call segment. | ||
| 1037 | {{/note}} | ||
| 1038 | |||
| 1039 | (% style="line-height: 1.4285715;" %)**Parameters:** | ||
| 1040 | |||
| 1041 | * instance_resource_path: One of the instance resource paths for this resource. See Instance Resource Paths above | ||
| 1042 | |||
| 1043 | **Errors:** | ||
| 1044 | |||
| 1045 | * 404 Not Found: Returned if any of the ancestors in the instance resource path could not be found | ||
| 1046 | * 403 Forbidden(% style="line-height: 1.4285715;" %): Returned if the specified call segment is not related to an extension that is bound to a licensed/full user, or has not been bound to another call segment that is related to an extension that is bound to a licensed/full user. | ||
| 1047 | * 422 Unprocessable Entity: Returned if no destination number value was provided(% style="line-height: 1.4285715;" %) | ||
| 1048 | |||
| 1049 | * 422 Unprocessable Entity: Returned if no attended value was provided | ||
| 1050 | * 422 Unprocessable Entity: Returned if the attended value provided is not a boolean value | ||
| 1051 | ))) | ||
| 1052 | |=(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 1053 | ((( | ||
| 1054 | **JSON** | ||
| 1055 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 1056 | ((( | ||
| 1057 | {{code}} | ||
| 1058 | { | ||
| 1059 | "destinationNumber": "18005555555", | ||
| 1060 | "attended" : false | ||
| 1061 | } | ||
| 1062 | {{/code}} | ||
| 1063 | |||
| 1064 | **Properties:** | ||
| 1065 | |||
| 1066 | |=((( | ||
| 1067 | Property | ||
| 1068 | )))|=((( | ||
| 1069 | Type | ||
| 1070 | )))|=((( | ||
| 1071 | Description | ||
| 1072 | ))) | ||
| 1073 | |(% colspan="1" %)(% colspan="1" %) | ||
| 1074 | ((( | ||
| 1075 | {{{destinationNumber}}} | ||
| 1076 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 1077 | ((( | ||
| 1078 | String | ||
| 1079 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 1080 | ((( | ||
| 1081 | The number to transfer to. | ||
| 1082 | ))) | ||
| 1083 | |(% colspan="1" %)(% colspan="1" %) | ||
| 1084 | ((( | ||
| 1085 | attended | ||
| 1086 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 1087 | ((( | ||
| 1088 | Boolean | ||
| 1089 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 1090 | ((( | ||
| 1091 | Specifies if the transfer should be attended or not. | ||
| 1092 | |||
| 1093 | {{info}} | ||
| 1094 | Attended transfers should no be performed, if the call source is not an extension. | ||
| 1095 | {{/info}} | ||
| 1096 | ))) | ||
| 1097 | |||
| 1098 | ** | ||
| 1099 | ** | ||
| 1100 | ))) | ||
| 1101 | |=(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %)(% class="highlight-grey" colspan="1" data-highlight-colour="grey" %) | ||
| 1102 | ((( | ||
| 1103 | **POST | ||
| 1104 | ** | ||
| 1105 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 1106 | ((( | ||
| 1107 | Transfers the call segment, that is bound to the specified call segment. | ||
| 1108 | ))) | ||
| 1109 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 1110 | ((( | ||
| 1111 | {{{{instance_resource_path}/kick}}} | ||
| 1112 | ))) | ||
| 1113 | |=(% colspan="1" %)(% colspan="1" %) | ||
| 1114 | ((( | ||
| 1115 | **Description** | ||
| 1116 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 1117 | ((( | ||
| 1118 | Kicks the call segment from it's conference room. | ||
| 1119 | |||
| 1120 | {{info}} | ||
| 1121 | (% style="list-style-type: square;" %) | ||
| 1122 | * This action is only available for call segments that are in conference rooms. | ||
| 1123 | * This action is only available on servers that have conference rooms enabled. | ||
| 1124 | {{/info}} | ||
| 1125 | |||
| 1126 | **Errors:** | ||
| 1127 | |||
| 1128 | * 404 Not Found: Returned if any of the ancestors in the instance resource path could not be found. | ||
| 1129 | * 500 Internal Server Error: Returned if the core server does not have conference rooms enabled. | ||
| 1130 | ))) | ||
| 1131 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 1132 | ((( | ||
| 1133 | {{{{instance_resource_path}/mute}}} | ||
| 1134 | ))) | ||
| 1135 | |=(% colspan="1" %)(% colspan="1" %) | ||
| 1136 | ((( | ||
| 1137 | **Description** | ||
| 1138 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 1139 | ((( | ||
| 1140 | Mutes the call segment in it's conference room. | ||
| 1141 | |||
| 1142 | {{info}} | ||
| 1143 | * This action is only available for call segments that are in conference rooms. | ||
| 1144 | * This action is only available on servers that have conference rooms enabled. | ||
| 1145 | {{/info}} | ||
| 1146 | |||
| 1147 | **Errors:** | ||
| 1148 | |||
| 1149 | * 404 Not Found: Returned if any of the ancestors in the instance resource path could not be found. | ||
| 1150 | |||
| 1151 | * 500 Internal Server Error: Returned if the core server does not have conference rooms enabled. | ||
| 1152 | ))) | ||
| 1153 | |=(% colspan="2" %)(% colspan="2" %) | ||
| 1154 | ((( | ||
| 1155 | {{{{instance_resource_path}/unmute}}} | ||
| 1156 | ))) | ||
| 1157 | |=(% colspan="1" %)(% colspan="1" %) | ||
| 1158 | ((( | ||
| 1159 | **Description** | ||
| 1160 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 1161 | ((( | ||
| 1162 | Unmutes the call segment in it's conference room. | ||
| 1163 | |||
| 1164 | {{info}} | ||
| 1165 | * This action is only available for call segments that are in conference rooms. | ||
| 1166 | * This action is only available on servers that have conference rooms enabled. | ||
| 1167 | {{/info}} | ||
| 1168 | |||
| 1169 | **Errors:** | ||
| 1170 | |||
| 1171 | * 404 Not Found: Returned if any of the ancestors in the instance resource path could not be found. | ||
| 1172 | |||
| 1173 | * 500 Internal Server Error: Returned if the core server does not have conference rooms enabled. | ||
| 1174 | ))) | ||
| 1175 | |||
| 1176 | |||
| 1177 | |||
| 1178 | = Curl Examples = | ||
| 1179 | |||
| 1180 | === Get all call segments in a core server === | ||
| 1181 | |||
| 1182 | {{code language="bash"}} | ||
| 1183 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/callSegments | ||
| 1184 | {{/code}} | ||
| 1185 | |||
| 1186 | === (% style="color: rgb(0,0,0);" %)Get a specific call segment in a core server(%%) === | ||
| 1187 | |||
| 1188 | {{code language="bash"}} | ||
| 1189 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/callSegments/804dbbc2-c4e3-47f2-96b9-b8262d542e7c | ||
| 1190 | {{/code}} | ||
| 1191 | |||
| 1192 | === (% style="color: rgb(0,0,0);" %)Get all call segments owned by an extension(%%) === | ||
| 1193 | |||
| 1194 | {{code language="bash"}} | ||
| 1195 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/extensions/ef2faba9-8557-49c1-9ffc-5a71f41c7a23/callSegments | ||
| 1196 | {{/code}} | ||
| 1197 | |||
| 1198 | === (% style="color: rgb(0,0,0);" %)Get a specific call segment owned by an extension(%%) === | ||
| 1199 | |||
| 1200 | {{code language="bash"}} | ||
| 1201 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/extensions/ef2faba9-8557-49c1-9ffc-5a71f41c7a23/callSegments/804dbbc2-c4e3-47f2-96b9-b8262d542e7c | ||
| 1202 | {{/code}} | ||
| 1203 | |||
| 1204 | === (% style="color: rgb(0,0,0);" %)Get all call segments a specified call segment is dialing(%%) === | ||
| 1205 | |||
| 1206 | {{code language="bash"}} | ||
| 1207 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/callSegments/804dbbc2-c4e3-47f2-96b9-b8262d542e7c/dialingToCallSegments | ||
| 1208 | {{/code}} | ||
| 1209 | |||
| 1210 | === Get a specific call segment a specified call segment is dialing === | ||
| 1211 | |||
| 1212 | {{code language="bash"}} | ||
| 1213 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/callSegments/804dbbc2-c4e3-47f2-96b9-b8262d542e7c/dialingToCallSegments/63844df4-c8f5-4917-9948-30f6251fc763 | ||
| 1214 | {{/code}} | ||
| 1215 | |||
| 1216 | === Get the call segment that is dialing a specified call segment === | ||
| 1217 | |||
| 1218 | {{code language="bash"}} | ||
| 1219 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/callSegments/804dbbc2-c4e3-47f2-96b9-b8262d542e7c/dialingFromCallSegment | ||
| 1220 | {{/code}} | ||
| 1221 | |||
| 1222 | === Get the call segment linked to a specified call segment === | ||
| 1223 | |||
| 1224 | {{code language="bash"}} | ||
| 1225 | curl --user manager:manag3rpa55word -i -H "Accept: application/json" http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/callSegments/804dbbc2-c4e3-47f2-96b9-b8262d542e7c/linkedCallSegment | ||
| 1226 | {{/code}} | ||
| 1227 | |||
| 1228 | === Transfer the call segment the specified call segment is bound to === | ||
| 1229 | |||
| 1230 | {{note}} | ||
| 1231 | See notes in the transfer action path above, concerning which call segment to specify when performing a transfer action. | ||
| 1232 | {{/note}} | ||
| 1233 | |||
| 1234 | {{code language="bash"}} | ||
| 1235 | curl --user manager:manag3rpa55word -i -H "Content-Type: application/json" -X POST -d '{"destinationNumber": "18005555555", "attended" : false}' http://localhost:58080/communication_manager/rest/live/coreServers/ca5de6c4-17bd-46ce-95a2-8b29c7812ca4/callSegments/804dbbc2-c4e3-47f2-96b9-b8262d542e7c/transfer | ||
| 1236 | {{/code}} | ||
| 1237 | |||
| 1238 | === Kicks the specified call segment from it's conference room === | ||
| 1239 | |||
| 1240 | {{code language="bash"}} | ||
| 1241 | curl --user manager:manag3rpa55word -i -H "Content-Type: application/json" -X POST -d '{}' http://localhost:58080/communication_manager/rest/live/coreServers/getByName/default/conferences/8f907b96-77aa-49ed-b5de-990ce5c8e7e7/callSegments/ac3a4f88-b853-4998-a375-6fef458f7769/kick | ||
| 1242 | {{/code}} | ||
| 1243 | |||
| 1244 | === (% style="color: rgb(0,0,0);" %)Mute the specified call segment in it's conference room(%%) === | ||
| 1245 | |||
| 1246 | {{code language="bash"}} | ||
| 1247 | curl --user manager:manag3rpa55word -i -H "Content-Type: application/json" -X POST -d '{}' http://localhost:58080/communication_manager/rest/live/coreServers/getByName/default/conferences/8f907b96-77aa-49ed-b5de-990ce5c8e7e7/callSegments/ac3a4f88-b853-4998-a375-6fef458f7769/mute | ||
| 1248 | {{/code}} | ||
| 1249 | |||
| 1250 | === Unmutes the specified call segment in it's conference room === | ||
| 1251 | |||
| 1252 | {{code language="bash"}} | ||
| 1253 | curl --user manager:manag3rpa55word -i -H "Content-Type: application/json" -X POST -d '{}' http://localhost:58080/communication_manager/rest/live/coreServers/getByName/default/conferences/8f907b96-77aa-49ed-b5de-990ce5c8e7e7/callSegments/ac3a4f88-b853-4998-a375-6fef458f7769/unmute | ||
| 1254 | {{/code}} | ||
| 1255 | |||
| 1256 | |||
| 1257 | |||
| 1258 | |||
| 1259 | {{/layout-cell}} | ||
| 1260 | {{/layout-section}} | ||
| 1261 | {{/layout}} |