Connecting DIDlogic numbers to Retell AI

This document provides technical instructions for integrating the Retell 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 Retell 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).
   
6. 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 plus icon and then “Connect to your number via SIP trunking” to open the configuration dialogue. (image)
3. Enter basic configuration with the following information:
   Phone Number: The E.164 formatted phone number to connect (e.g., +31203694169)
   Termination URI: Address that will be used for outgoing calls (e.g., sip.nl.didlogic.net). It can be found under your SIP account
   (image)
   SIP Trunk User Name: Username for SIP authentication (by default, your SIP login)
   SIP Trunk Password: Password for SIP authentication
   Nickname: Label for your number
   (image)
4. Click Save to finalise the configuration. It should appear in your “Phone Numbers” section (image)

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, which is available in their official documentation.

Once you have created the agent, assign it to the phone number, using “Inbound call agent” or “Outbound call agent” parameter

(image)

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. Navigate to your numbers on the DIDLogic website and locate which one will be used by Retell
   
2. Click “Edit” and on the menu “Forward to:” choose “SIP URI”.
3. Enter your number and “sip.retellai.com” separated by @
   It should look like this: “31203694169@sip.retellai.com” (image)
4. 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 (image)

Outgoing Calls

Once a phone number is configured via SIP trunking and assigned to an AI agent, that agent is capable of initiating outbound calls. There are several ways of this process:

1. Singular phone call: In “Phone numbers”, click on your imported phone number, then click “Make an outbound call” on the top right (image)
2. Enter the number to which the call should be addressed, add headers if needed, and press “Call”. (image)
3. You can monitor your entire call history in the “Call History” tab in the sidebar. (image)
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 “Batch Call” just below “Phone Numbers” on your sidebar (image)
5. Press the “Create a batch call” button and enter the configuration (image)
6. Upload the CSV file of recipients and press “Send” (image)
7. It will appear in the “Batch Call” menu (image)
8. API Integration: Calls, chats, agents, phone numbers can be managed via the Retell API.

Detailed implementation guides, code examples, and specifications for API are available in the official documentation.