Connecting DIDlogic numbers to ElevenLabs

This document provides technical instructions for integrating the Vapi AI platform with DIDLogic. The objective is to configure a SIP trunk to route incoming and outgoing calls between a DIDLogic phone number and a Vapi AI agent.

Purchase a number on the DID Logic platform

Before placing or receiving a call, you must have an active phone number associated with your DIDLogic account. If you already have one, you can skip this section.

To purchase a number:

1. Log in to your DID Logic account
2. Click BUY on the top menu
   
3. Select the country and region where you wish to purchase a number
4. Choose a specific number or numbers and click the Add to Cart button
   
5. The Cart page opens, confirming the selection and completion of the checkout process for the DID(s).
   

Once you have purchased the DID, it will be reflected in the PURCHASED tab.

Note:

Some numbers may require proof of local address and other documents before they can be activated. To activate these numbers, upload the requested documents and wait for approval from the DID Logic Provisioning team.

Create a SIP account

1. Navigate to the SIP tab in the top menu
2. Click the Create SIP account button
   
3. Specify the SIP account name, set the SIP account password, and select one of the DIDs on your account as the Caller ID
4. You can optionally restrict access by specifying authorised IP addresses, maximum call length, channels, and maximum call cost. If these parameters are not configured, the global account limits will apply
   
5. Click Create.

After the SIP account is successfully created, it will appear on the list of SIP accounts

Please note that your 5-digit SIP account username is generated automatically and displayed in the SIP user name column.

Setting up Phone Number via SIP Trunking

1. Go to the Phone Numbers section located on the left side of the screen
   
2. Click on the “Create Phone Number” to open the configuration dialogue.
3. Click “BYO SIP Trunk Number” and then select the “SIP Trunk Credential” field
   
4. In this field, select “Create SIP Trunk”
   
5. You will be redirected to a new page with integrations
6. Navigate down to the “Phone Number Providers” section and select “SIP trunk”
   
7. Click on “Configure New SIP Trunk”
   
8. Enter basic configuration with the following information:
   Name: Label for the trunk
   IP Address / Domain: Address that will be used for outgoing calls. Since Vapi SIP signalling servers are located in the US, we recommend using addresses for sip.nyc.didlogic.net [192.241.183.87] and sip.lax.didlogic.net [185.118.62.77] which can be found HERE
   Outbound Protocol: Select it to TCP/UDP/TLS
   
9. Below the gateway configuration, navigate to the “Authentication (Optional)” window and enter the following info:
   Username: Username for SIP authentication (by default, your SIP login)
   Password: Password for SIP authentication
   
10. Click “Save SIP Trunk” to finalise the configuration. And return back to the “Phone Numbers” section
11. Now you will be able to select the created SIP trunk
12. Enter the phone number and label, then press “Import SIP Phone Number”
    

Creating and Configuring the AI Agent

Once your phone number has been successfully imported, the next step is to create and configure the AI agent that will handle the calls.

To ensure access to the most up-to-date and detailed information, we recommend using their official guide, available in their official documentation.

Once you have created the agent, assign it to the phone number by navigating to “Phone Numbers” and selecting your agent for both inbound and/or outbound calls. After you have assigned the agent, press “Save”

Incoming calls

In order for your agent to receive calls to your number, you need to go to DIDLogic and configure the SIP URI.

Steps to configure incoming call routing to a valid SIP URI:

1. Locate “API keys” on the sidebar and copy “Private Key”
   
2. Navigate to your numbers on the DIDLogic website and locate which one will be used by Vapi
   
3. Click “Edit” and on the menu “Forward to:” choose “SIP URI”.
4. Enter your number and private key separated by @, and at the end, add “.sip.vapi.ai”
5. It should look like this: “31203694169@123a-123a-123a-123a-123a.sip.vapi.ai”
6. Press the “Add “button, and it should appear just below. Make sure to place this destination first in order, if you already have another destination configured
   

Outgoing Calls

Once a phone number is configured and assigned to an AI agent, the agent can initiate outbound calls. There are several ways of this process:

1. Singular phone call: In “Phone numbers”, click on your phone number and navigate to the “Outbound Calls” window
   
2. Select the destination country and enter the number, then press “Make a Call”
   
3. You can monitor your entire call history in the “Call Logs” tab in the sidebar.
   
4. Batch Call: Alternatively, you can initiate multiple outbound calls at once, making it ideal for campaigns or notifications. To access this feature, navigate to the “Outbound Calls” window and select “Call Many Numbers (Upload CSV)”
   
5. Upload the CSV file of recipients and press “Make a Call”
   
6. API Integration:
   Detailed implementation guides, code examples, and specifications for API are available in the official documentation.