<Sip>

TL;DR

<Dial> an arbitrary <Sip> URI.

Need Help? Let's Talk

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

Description

Connect the caller to an external SIP address.

Example

 <?xml version="1.0" encoding="UTF-8"?>
 <Response>
   <Dial>
     <Sip>sip:61000@example.com</Sip>
   </Dial>
 </Response>

Attributes

The content of the verb must be a valid SIP address. It can include the sip: prefix and may have additional URL parameters, where setting the transport parameter controls the SIP transport used for the SIP INVITE and any other parameters are passed as is.

Format: [sip:]{user}@{domain}[:{port}][;transport={udp|tcp|tls}[;{param-name}={param-value}[…]]]

The following attributes are supported:

Attribute Name	Allowed Values	Default Value
username	any set of characters	None
password	any set of characters	None
domain	origin or destination	origin

Cloudonix will try to connect the call to the specified SIP address using classic SIP dialing.

If the optional username and password attributes are both provided, Cloudonix will answer SIP authoriztion challanges with the specified authentication details.

In the SIP INVITE message that will be sent to the specified remote host, the To address will be sent exactly as specified in the <Sip> content, while the From address will by default be sent as the caller's ID in the application's Cloudonix domain, i.e. sip:{CALLER}@{DOMAIN}. The From address can be further controlled by:

• The caller username can be changed by setting the enclosing <Dial> verb's callerId attribute.
• The caller's domain can be changed to match the domain of the <Sip> destination by setting the domain attribute on the <Sip> noun to destination.