Relay.Calling

This represents the API interface for the Calling Relay Service. This object is used to make requests related to managing end to end calls.

Methods

dial

Make an outbound Call and waits until it has been answered or hung up.

Parameters

Parameter	Type	Required	Description
`call_type`	`string`	optional	The type of call. Default to `phone` as it is the only supported for now.
`from_number`	`string`	required	The party the call is coming from. Must be a SignalWire number or SIP endpoint that you own.
`to_number`	`string`	required	The party you are attempting to call.
`timeout`	`number`	optional	The time, in seconds, the call will ring before going to voicemail.

Returns

coroutine - Coroutine object that will be fulfilled with a Relay.Calling.DialResult object.

Examples

Make an outbound Call and print the call object if it was answered:

1 async def ready(client):
2   result = await client.calling.dial(from_number='+1XXXXXXXXXX', to_number='+1YYYYYYYYYY')
3   if result.successful:
4     # Call has been answered and is now active. Use 'result.call' to access the Call object.
5     print(result.call)
6   else:
7     print('Call failed or not answered.')

newCall

Create a new Call object. The call has not started yet allowing you to attach event listeners on it.

Parameters

See Relay.Calling.Dial for the parameter list.

Returns

Call - A new Relay.Calling.Call object.

Examples

Create a new Call object:

1 call = client.calling.new_call(from_number='+1XXXXXXXXXX', to_number='+1YYYYYYYYYY', timeout=30)
2 # Use the call object..