<Number>

TL;DR

<Dial> a specific number on the system or externally.

Need Help? Let's Talk

Join our Discord community - we're here to help.

Description

Connect the caller to another subscriber line or to an external telephony account. Eg.

Example

 <?xml version="1.0" encoding="UTF-8"?>
 <Response>
   <Dial>
     <Number>61000</Number>
   </Dial>
 </Response>

Cloudonix will ring a connected subscriber (SIP registered or Registration-Free) whose MSISDN matches the specified number. Alternatively, Cloudonix will try to dial out through a configured outbound trunk in the following cases:

• The session object for this call has an LCR route plan in its routes field. If an LCR route plan exists, it will be invoked and the call will fail if the plan has no valid connections.
• The <Dial> element containing this element has the trunks attribute that contains a valid list of trunks (see the trunks documentation for details).
• There is no active Cloudonix subscriber in the application's domain with the specified MSISDN and the domain profile property redirect-unknown-to-border is not set to false.

In case subscriber identifier matches an existing active Cloudonix subscriber (whether using classic SIP registration or Registration-Free), and neither the application nor the session overrode that behavior (as specified above), Cloudonix will try to dial that subscriber using classic SIP registration (if exists) or Registration-Free dialing (if configured for the domain), in that order of preference. If the subscriber cannot be reached, Cloudonix will reject the call, calling the Dial's action handler (if one is set) and contiuing to execute the voice application as specified in the CXML documentation.