This method allows making PhoneCalls using a Callback Extension.
Table of Contents maxLevel 3 exclude Apps Using This, Quick Examples, Need Help?
Use this request to make a public call using a
If successful, the request returns the Id of the newly created PhoneCall as well as other properties.
The request is made by an App that is registered to a User account.
To create Callback PhoneCalls, issue a HTTP POST request:
HTTP-Method = "POST" URI-Fragment = "/uapi/phoneCalls/" User-Id "/callback" Query-Parameters = multiple = PhoneCall Return-Object = Array<PhoneCall>
POST /uapi/phoneCalls/@me/callback HTTP/1.1 HOST
This section describes how to format the request to the service.
The following parameters must be sent in the URI fragment.
Id of the User which owns the
All requests to list phone calls support the Standard-Request-Parameters and the custom fields parameter. All parameters are optional.
The maximum number of seconds to wait until one of the phone numbers used picks up.
Total duration of the call, in seconds.
Callback phone calls, the following restrictions apply to the PhoneCall resource sent in the Request Payload.
|extension||UAPI-Extension-Number||Must refer to a |
Must be owned by the user identified by the
Cannot be set to @self and must be specified.
|source||Array<String>||A public phone number.|
|destination||Array<String>||A public phone number.|
The caller name and number.
|nonce||String||A unique string which allows to identify the call created based on the request.|
Short extension numbers can be given as source, extension, and destination, but only when the request is made using an App registered to a User or an Organization.
The Service returns the Id of the newly created PhoneCall and the following HTTP statuses:
|200||The Id of the phone call is returned.|
|204||There is no Id to be returned.|
When it fails, the request returns the following error codes:
|400||extension_invalid||Value supplied in extension parameter is missing or invalid. The parameter must be set to the number of a |
|400||pc_duration_invalid||Value supplied in |
|400||pc_source_invalid||Value supplied in source parameter is missing or invalid. The parameter must be set to a list of extended or short extension numbers or public phone numbers.|
|400||pc_destination_invalid||Value supplied in destination parameter is missing or invalid. The parameter must be set to a list of extended or short extension numbers or public phone numbers.|
|400||pc_timeout_invalid||Value supplied in |
|400||pc_callerid_invalid||Value supplied in |
Below you can find two examples that will help you understand the request and the response.
Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 4.0 International.