Skip to content

Latest commit

 

History

History
49 lines (40 loc) · 5.1 KB

CreateCall.md

File metadata and controls

49 lines (40 loc) · 5.1 KB
Raw

CreateCall

Properties

Name Type Description Notes
to str The destination to call (must be an E.164 formatted number (e.g. `+15555551212`) or a SIP URI (e.g. `sip:user@server.example`)).
var_from str A Bandwidth phone number on your account the call should come from (must be in E.164 format, like `+15555551212`) even if `privacy` is set to true.
privacy bool Hide the calling number. The `displayName` field can be used to customize the displayed name. [optional]
display_name str The caller display name to use when the call is created. May not exceed 256 characters nor contain control characters such as new lines. If `privacy` is true, only the following values are valid: `Restricted`, `Anonymous`, `Private`, or `Unavailable`. [optional]
uui str A comma-separated list of 'User-To-User' headers to be sent in the INVITE when calling a SIP URI. Each value must end with an 'encoding' parameter as described in <a href='https://tools.ietf.org/html/rfc7433&#39;&gt;RFC 7433</a>. Only 'jwt' and 'base64' encodings are allowed. The entire value cannot exceed 350 characters, including parameters and separators. [optional]
application_id str The id of the application associated with the `from` number.
answer_url str The full URL to send the <a href='/docs/voice/webhooks/answer'>Answer</a> event to when the called party answers. This endpoint should return the first <a href='/docs/voice/bxml'>BXML document</a> to be executed in the call. Must use `https` if specifying `username` and `password`.
answer_method CallbackMethodEnum [optional] [default to CallbackMethodEnum.POST]
username str Basic auth username. [optional]
password str Basic auth password. [optional]
answer_fallback_url str A fallback url which, if provided, will be used to retry the `answer` webhook delivery in case `answerUrl` fails to respond Must use `https` if specifying `fallbackUsername` and `fallbackPassword`. [optional]
answer_fallback_method CallbackMethodEnum [optional] [default to CallbackMethodEnum.POST]
fallback_username str Basic auth username. [optional]
fallback_password str Basic auth password. [optional]
disconnect_url str The URL to send the <a href='/docs/voice/webhooks/disconnect'>Disconnect</a> event to when the call ends. This event does not expect a BXML response. [optional]
disconnect_method CallbackMethodEnum [optional] [default to CallbackMethodEnum.POST]
call_timeout float The timeout (in seconds) for the callee to answer the call after it starts ringing. If the call does not start ringing within 30s, the call will be cancelled regardless of this value. Can be any numeric value (including decimals) between 1 and 300. [optional] [default to 30]
callback_timeout float This is the timeout (in seconds) to use when delivering webhooks for the call. Can be any numeric value (including decimals) between 1 and 25. [optional] [default to 15]
machine_detection MachineDetectionConfiguration [optional]
priority int The priority of this call over other calls from your account. For example, if during a call your application needs to place a new call and bridge it with the current call, you might want to create the call with priority 1 so that it will be the next call picked off your queue, ahead of other less time sensitive calls. A lower value means higher priority, so a priority 1 call takes precedence over a priority 2 call. [optional] [default to 5]
tag str A custom string that will be sent with all webhooks for this call unless overwritten by a future <a href='/docs/voice/bxml/tag'>`<Tag>`</a> verb or `tag` attribute on another verb, or cleared. May be cleared by setting `tag=&quot;&quot;` Max length 256 characters. [optional]

Example

from bandwidth.models.create_call import CreateCall

# TODO update the JSON string below
json = "{}"
# create an instance of CreateCall from a JSON string
create_call_instance = CreateCall.from_json(json)
# print the JSON string representation of the object
print(CreateCall.to_json())

# convert the object into a dict
create_call_dict = create_call_instance.to_dict()
# create an instance of CreateCall from a dict
create_call_from_dict = CreateCall.from_dict(create_call_dict)

[Back to Model list] [Back to API list] [Back to README]