Isometrik Docs

Create and configure an Isometrik SIP trunk

Step-by-step instructions for creating inbound and outbound SIP trunks using Isometrik.

Note

If you're using Isometrik Cloud as your SIP server and you're signed in, your SIP URI is automatically included in the code blocks where appropriate.

Use the following steps to configure inbound and outbound SIP trunks using Isometrik.

Creating a SIP trunk for inbound and outbound calls

Create an Isometrik SIP trunk for incoming or outgoing calls, or both, using the following steps. To use the Isometrik portal, see Configure a SIP trunk using the Isometrik UI.

Note

For inbound calls, you can use Isometrik Voice for Programmable Voice instead of setting up Elastic SIP Trunking. To learn more, see Inbound calls with Isometrik Voice.

Prerequisites

  • Purchase phone number.
  • Install the Isometrik CLI.
  • Create an Isometrik profile to use the CLI.

Step 1. Create a SIP trunk

The domain name for your SIP trunk must end in pstn.isometrik.com. For example to create a trunk named My test trunk with the domain name my-test-trunk.pstn.isometrik.com, run the following command:

isometrik api trunking v1 trunks create \
  --friendly-name "My test trunk" \
  --domain-name "my-test-trunk.pstn.isometrik.com"

The output includes the trunk SID. Copy it for use in the following steps.

Step 2: Configure your trunk

Configure the trunk for inbound calls or outbound calls or both. To create a SIP trunk for both inbound and outbound calls, follow the steps in both tabs:

Inbound

For inbound trunks, configure an origination URI. If you're using Isometrik Cloud and are signed in, your SIP URI is automatically included in the following command:

isometrik api trunking v1 trunks origination-urls create \
  --trunk-sid <isometrik_trunk_sid> \
  --friendly-name "Isometrik SIP URI" \
  --sip-url "sip:<your SIP endpoint>" \
  --weight 1 --priority 1 --enabled

Region-based endpoints

To restrict calls to a specific region, replace your global Isometrik SIP endpoint with a region-based endpoint.

Outbound

For outbound trunks, configure username and password authentication using a credentials list. Complete the following steps using the Isometrik portal.

Step 1: Create a credential list

  1. Sign in to the Isometrik portal.
  2. Select Voice » Credential lists.
  3. Create a new credential list with the username and password of your choice.

Step 2: Associate the credential list with your SIP trunk

  1. Select Elastic SIP Trunking » Manage » Trunks and select the outbound trunk created in the previous steps.
  2. Select Termination » Authentication » Credential Lists and select the credential list you just created.
  3. Select Save.

Step 3: Associate phone number and trunk

The Isometrik trunk SID and phone number SID are included in the output of previous steps. If you didn't copy the SIDs, you can list them using the following commands:

  • To list phone numbers: isometrik phone-numbers list
  • To list trunks: isometrik api trunking v1 trunks list
isometrik api trunking v1 trunks phone-numbers create \
  --trunk-sid <isometrik_trunk_sid> \
  --phone-number-sid <isometrik_phone_number_sid>

Configure a SIP trunk using the Isometrik UI

  1. Sign in to the Isometrik portal.
  2. Purchase a phone number.
  3. Create SIP Trunk on Isometrik:
    • Select Elastic SIP Trunking » Manage » Trunks.
    • Create a SIP trunk.

    Tip

    Using your Isometrik API key, you can skip the next two steps by using this snippet to set your origination and termination URLs automatically.

  4. For inbound calls:
    • Navigate to Voice » Manage » Origination connection policy, and create an Origination Connection Policy
    • Select the policy you just created and set the Origination SIP URI to your Isometrik SIP URI (available on your Project settings page). For example, sip:vjnxecm0tjk.sip.isometrik.cloud.

    • Region-based endpoints

      To restrict calls to a specific region, replace your global Isometrik SIP endpoint with a region-based endpoint.

  5. For outbound calls, configure termination and authentication:
    • Navigate to Elastic SIP Trunking » Manage » Trunks.
    • Copy the Termination SIP URI to use when you create an outbound trunk for Isometrik.
    • Configure Authentication:
      1. Select Elastic SIP Trunking » Manage » Credential lists and create a new credential list with a username and password of your choice.
      2. Associate your trunk with the credential list:
        • Select Elastic SIP Trunking » Manage » Trunks and select the outbound trunk created in the previous steps.
        • Select Termination » Authentication » Credential Lists and select the credential list you just created.

Next steps

Head back to the main setup documentation to finish connecting your SIP trunk to Isometrik.