Action: Connect to SIP trunk

Instead of connecting calls directly to phone numbers, you can also use our system to connect to a Session Initiation Protocol (SIP) trunk. This option provides you with greater flexibility and control over your telecommunication system. Here's how to do it:

Use the 'connect' action to connect a call to your SIP trunk. The mechanism is similar to connecting to a phone number, but in this case, you'll provide the SIP URI of your trunk instead of a phone number.

Format

{
  "connect": "sip:voip.example.com",
  "callerid": "+46766861234", // Optional
  "next": "https://yourapp.example/elks/calls", // Optional
}

Result

POST https://yourapp.example/elks/calls
Parameter Description
callid The unique id of the call in our systems.
result The result of the connect. Can be ”success”, ”failed” or ”busy”.

Restrictions

To use this feature, your SIP servers will need to be whitelisted. Please contact our support.

Firewall Rules

You will need to modify your firewall settings to allow traffic on port 5060. To maintain security, we suggest limiting this to only accept traffic from our servers. The specific server details can be found at this link: Server Details. Please consult with your IT team to implement these changes.