> This page is for version Generative (default).
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Contact center integration

This section takes you through how to integrate your contact center platform with Ada Voice. If you don’t see your contact center platform listed here, you can contact your Ada team to determine the best way to integrate. Ada Voice can integrate with any contact center platform.

#### Integrate Voice with your SIP infrastructure

This section takes you through how to integrate Ada with your SIP infrastructure.

#### Setting up your Ada SIP domain

* If you are using your own Twilio account with Ada Voice, configure a Twilio SIP domain for your AI Agent to use. For more information, see Set up your Twilio account in [Get started with Voice](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/get-started-with-voice) at Ada’s Help Docs.
* If your Voice subscription package includes Twilio your Ada team will set up your SIP domain for you. You will need to provide them with the following information:
  * **The domain name for your SIP address:** This will be used for the SIP domain that will be created for you, which will follow the format `<your_domain_name>.sip.twilio.com`. This needs to be a unique domain name that is not currently being used in Twilio.
  * **IP Addresses for your SIP domain’s Access Control List (ACL):** An ACL is a security mechanism that enhances network security by allowing only specified IP addresses to access your SIP domain. In the context of SIP communications, this means defining trusted IP addresses—such as those associated with your SIP infrastructure—to ensure that only authorized signaling and media traffic is permitted to interact with your SIP domain.

#### Integrating Ada in your SIP infrastructure

You must allow all of Twilio's following IP address ranges and ports on your firewall for SIP signaling traffic. Please also note that these IP addresses are provided for firewall configuration purposes only and not all of these IP addresses will host active gateways at a given time. Customers should also avoid sending traffic directly to these IP addresses and instead use your SIP domain.

**Global Media IP Gateway**

The Public Connections Destination IP Ranges and Port Ranges are now identical across all locations:

| **Secure Media (ICE/STUN/SRTP) Edge Locations**                                                                                                                       | **Protocol** | **Source IP** | **Source Port** | **Destination IP Ranges** | **Destination Port Range** |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------------- | --------------- | ------------------------- | -------------------------- |
| sydney (**au1** )sao-paulo (**br1** )dublin (**ie1** )frankfurt (**de1** )tokyo (**jp1** )singapore (**sg1** )ashburn (**us1** )umatilla (**us2** )roaming (**gll** ) | UDP          | ANY           | ANY             | 168.86.128.0/18           | 10,000 - 60,000            |

---

**Regional Signaling IP Gateways**

***Port***

5061 (TLS)

***North America Virginia Gateways***

```jsx
1    54.172.60.0/30 which translates to:
2    54.172.60.0
3    54.172.60.1
4    54.172.60.2
5    54.172.60.3
6 
```

***North America Oregon Gateways***

```jsx
1    54.244.51.0/30 which translates to:
2    54.244.51.0
3    54.244.51.1
4    54.244.51.2
5    54.244.51.3
6
```

***Europe Ireland Gateways***

```jsx
1    54.171.127.192/30 which translates to:
2    54.171.127.192
3    54.171.127.193
4    54.171.127.194
5    54.171.127.195
6
```

***Europe Frankfurt Gateways***

```jsx
1    35.156.191.128/30 which translates to:
2    35.156.191.128
3    35.156.191.129
4    35.156.191.130
5    35.156.191.131
6
```

***Asia-Pacific Tokyo Gateways***

```jsx
1    54.65.63.192/30 which translates to:
2    54.65.63.192
3    54.65.63.193
4    54.65.63.194
5    54.65.63.195

```

***Asia-Pacific Singapore Gateways***

```jsx
1    54.169.127.128/30 which translates to:
2    54.169.127.128
3    54.169.127.129
4    54.169.127.130
5    54.169.127.131
6
```

***Asia-Pacific Sydney Gateways***

```jsx
1    54.252.254.64/30 which translates to:
2    54.252.254.64
3    54.252.254.65
4    54.252.254.66
5    54.252.254.67
6
```

***South America São Paulo Gateways***

```jsx
1    177.71.206.192/30 which translates to:
2    177.71.206.192
3    177.71.206.193
4    177.71.206.194
5    177.71.206.195
6
```

#### Send data to Ada using SIP User-to-User (UUI) header

When sending SIP to Ada, you ***must*** send the end user’s phone number in the SIP UUI header:

* The UUI header information must be sent in Ascii encoding format.
* It must also follow the format Ada Voice expects:

```jsx
phone_number=+14035555555
```

You can send additional metadata to Ada Voice, such as name, language, account number — or any other information you choose — as key-value pairs using the SIP UUI header.

Any data sent will be available as a purple metavariable in Ada to help personalize the conversation.

#### Transferring calls from Ada to your SIP infrastructure

If an end user using your AI Agent needs to escalate to a human agent, you can hand them off using a SIP REFER transfer to your SIP infrastructure.

1. In your Ada [**AI Agent Handoff**](https://docs.ada.cx/docs/generative/set-up-your-ai-agent-s-knowledge-and-behavior/manage-your-ai-agent-s-behavior/manage-how-your-ai-agent-hands-customers-off-to-live-agents#edit) use the [**Transfer Call block**](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/create-and-adapt-content-for-voice-conversations) and select **SIP address** from the **Transfer to** drop down menu.
2. In the **SIP address** field, enter the SIP address that you want to transfer the call to.
3. Select the checkbox beside **Include a User-to-User header when transferring to the SIP address**.
4. Click **+Add another row**.
5. For **Key**, enter the key name `phone_number`.
6. For **Value**, select the `phone_number` metavariable.
7. Click **+Add another row**.
8. Provide any additional key value pairs that you want sent via the UUI header.

#### Integrate Voice with Aircall

This section takes you through how to transfer calls between Ada and
Aircall.

#### Get calls into Ada\[#UUID-f619f691-3089-cd33-6ce6-8bc5cfbf038f_bridgehead-idm4539852419910434010484939836]

To have your AI Agent handle inbound calls originating in Aircall, configure an [Aircall Smartflow](https://support.aircall.io/hc/en-gb/p/ai-support/#/sections/15408624592669) that connects calls to your Ada Twilio Application:

1. If you have not done so already, configure a Twilio Application for your AI Agent to use. For more information, see **Set up your Twilio account** in [Get started with Voice](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/get-started-with-voice) at Ada’s Help Docs.
2. Set up the widget in an **[Aircall Smartflow](https://support.aircall.io/hc/en-gb/p/ai-support/#/sections/15408624592669)** to transfer the call to your Ada Twilio Application.
   * In Aircall, open the Smartflow Editor for the phone number(s) you want to route to Ada.
   * Drag and drop the **Ada Voice smartflow widget** into your flow where you want your AI Agent to engage with end users.
     * Your Aircall team will need to enable this widget for you.
3. Enter your Twilio Application details in Aircall.
   * In the **Ada Voice Smartflow widget**’s settings, paste the Twilio Application ID for your AI Agent. You can find this in Ada under Channels > Voice > Configuration after you create a Twilio Application for your AI Agent to use.
   * You will need an Application Key - you can obtain this from your Ada Team.
   * Publish your Smartflow.

When a call reaches the Ada Voice Smartflow widget in your Aircall Smartflow, it’s automatically routed to your AI Agent in Ada.

#### Escalate calls directly to agents using Aircall\[#UUID-f619f691-3089-cd33-6ce6-8bc5cfbf038f_bridgehead-idm4538472888177634010485330589]

If your AI Agent determines an end user needs human assistance, you can transfer the call back to an Aircall team.

1. In your Ada [**AI Agent Handoff**](https://docs.ada.cx/docs/generative/set-up-your-ai-agent-s-knowledge-and-behavior/manage-your-ai-agent-s-behavior/manage-how-your-ai-agent-hands-customers-off-to-live-agents#edit) use the [**Transfer Call block**](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/create-and-adapt-content-for-voice-conversations/#UUID-a5baa6c5-e3da-e273-08e3-2da0b460c955_section-idm4516056577880033652597058235) and select **Aircall** as the transfer option in the **Transfer to** dropdown.
2. For **Destination type** choose **None**, **Number**, **Team**, or **User**.
   * If you selected **None** as the **Destination type**, you do not need to provide any additional information. When this **Transfer Call** block runs, Ada drops from the call, the call continues in Aircall, and the **Aircall Smartflow** will continue from where the **Ada Voice Smartflow widget** was used.
   * If you selected **Number** as the **Destination type**, you will need to provide a line ID for a number in Aircall. You can find the line ID in the URL path of the Aircall number page, *ex. dashboard.aircall.io/numbers/line_id/call-distribution*. When this **Transfer Call** block runs, Ada drops from the call, the call continues in Aircall, and Aircall makes a ring to the number you specified in the **Transfer Call** block.
   * If you selected **Team** as the **Destination type**, you will need to provide a team ID for a team in Aircall. You can find the team ID in the URL path of the Aircall team page, *ex. dashboard.aircall.io/teams/team_id*. When this **Transfer Call** block runs, Ada drops from the call, the call continues in Aircall, and Aircall makes a ring to the team you specified in the **Transfer Call** block.
   * If you selected **User** as the **Destination type**, you will need to provide a user ID for a user in Aircall. You can find the user ID in the URL path of the Aircall user page, *ex. dashboard.aircall.io/users/user_id/general*. When this **Transfer Call** block runs, Ada drops from the call, the call continues in Aircall, and Aircall makes a ring to the user you specified in the **Transfer Call** block.

#### Integrate Voice with Amazon Connect

This section takes you through how to transfer calls between Ada and Amazon Connect.

#### Get calls into Ada

You will continue to receive phone calls using an Amazon Connect provisioned phone number, and you will transfer phone calls from Amazon Connect to your Ada AI Agent’s phone number using the [Amazon Connect Transfer to phone number](https://docs.aws.amazon.com/connect/latest/adminguide/transfer-to-phone-number.html) module.

1. If you have not done so already, configure a Twilio phone number for your AI Agent to use. For more information, see **Set up your Twilio account** in [**Get started with Voice**](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/get-started-with-voice/) at Ada’s Help Docs.

2. Log into your Amazon Connect account.

3. [Create a new flow](https://docs.aws.amazon.com/connect/latest/adminguide/create-contact-flow.html) in Amazon Connect for inbound phone calls that you want to transfer to Ada.

4. In order to track the end user across Amazon Connect and your Ada AI Agent, you will need to create an [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) function in the AWS Instance associated with your Amazon Connect account. This function will retrieve an Ada Call UUID for the call from Ada prior to the call being transferred to Ada.

   1. Navigate to the Console Home of the AWS instance that is associated with your Amazon Connect account. It should look like this:
   ![](/_fern-files/_img/81ae8cbce8e284fbf550ee65968f8c4739ec04ddeec787d299d2e6d36a54d78e.webp)
   3. Navigate to **Lambda**. *(Note: You might need to use Search to find it if it isn’t listed under your Recently visited.)*
   4. Click **Create Function** on your Lambda homepage.
   5. Enter the following property values under your Lambda’s **Basic information**:
   * **Function name:** Ada-Get-Call-ID

   * **Runtime:** Python 3.12

   * **Architecture:** x86_64
   ![](/_fern-files/_img/66f03f807dbe65599ca6ca8ef937749321431a436b95ce85474973db58f3de1b.webp)
   8. Click **Create function**.
   9. Once created, you will see an editor where you are able to create a new function. Enter the following — replace `bot-handle` with your AI Agent’s handle:
   ```python
   import json
   import urllib.request
   from urllib.error import HTTPError

   def lambda_handler(event, context):
       url = f"https://bot-handle.ada.support/voice/transfers/"

       for attempt in range(3):
           try:
               response = urllib.request.urlopen(url)
               uuid = response.read().decode('utf-8')
               return {
                   'uuid': uuid,
               }
           except Exception as e:
               # Retry on any other exception
               if attempt == 2:  # After 3rd attempt, raise the exception
                   raise e
   ```
   11. Click the **Deploy** button.

5. After creating, allow your Amazon Connect instance to access the Lambda.

   1. Go to Amazon Connect on AWS dashboard
   2. Click on the instance
   3. Click “Flows” on the left sidebar
   4. Scroll down to "AWS Lambda” section
   5. Add function created above

6. Use the [**Invoke an AWS Lambda function**](https://docs.aws.amazon.com/connect/latest/adminguide/invoke-lambda-function-block.html) block to call your newly created AWS Lambda function and to retrieve the `uuid` from Ada for your call. Enter the following property values:
   * **Function ARN:** Use the function created above
   * **Timeout:** 8
   * **Response validation:** Set to JSON

7. Use the [**Transfer to phone number**](https://docs.aws.amazon.com/connect/latest/adminguide/transfer-to-phone-number.html) block to transfer the call to Ada. Enter the following property values:
   * **Transfer via:** Select **Phone number**, select **Set manually**, and provide your AI Agent’s phone number.
   * **Set timeout:** Select **Set manually** 30.
   * Set **Resume flow after disconnect** section to **Yes.**
     * With this enabled, once the call is transferred to Ada, if Ada is unable to resolve a conversation and it needs to be escalated then Ada will disconnect from the call and the Amazon Connect flow will resume where it left off.
   * Select **Send DTMF:**
     * Select **Set Dynamically**
       * **Namespace:** External
       * **Key:** uuid

#### Escalate calls directly to agents using Amazon Connect

If an end user using your AI Agent needs to escalate to a human agent, Ada will disconnect from the call and your Amazon Connect flow will resume where you left off.

1. In your Ada [AI Agent Handoff](https://docs.ada.cx/docs/generative/set-up-your-ai-agent-s-knowledge-and-behavior/manage-your-ai-agent-s-behavior/manage-how-your-ai-agent-hands-customers-off-to-live-agents#edit) use the [Transfer Call block](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/create-and-adapt-content-for-voice-conversations) and select **Amazon Connect** from the **Transfer to** drop down menu.
2. In the **Amazon Connect destination queue** field enter the queue ID of the queue in Amazon Connect that you want to transfer the phone call to.

![](/_fern-files/_img/bbc895fdab96586795fb00924f10de3456d0a4153f56a0a7c866c8248ec125d1.webp)

3. In Amazon Connect, after the **Transfer to phone number** block that you set-up in **Step 9** of **Get calls into Ada** above, you will need to invoke another [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html) function. This function will retrieve a `destinationQueue` value for the call — you can use this to determine which queue in Amazon Connect to route the call to.

   1. Navigate to the Console Home of the AWS instance that is associated with your Amazon Connect account. It should look like this:
   ![](/_fern-files/_img/81ae8cbce8e284fbf550ee65968f8c4739ec04ddeec787d299d2e6d36a54d78e.webp)
   3. Navigate to **Lambda**. *(Note: You might need to use Search to find it if it isn’t listed under your Recently visited.)*
   4. Click **Create Function** on your Lambda homepage.
   5. Enter the following property values under your Lambda’s **Basic information**:
   * **Function name:** Ada-Get-Destination-Queue
   * **Runtime:** Python 3.12
   * **Architecture:** x86_64
   ![](/_fern-files/_img/d6d5e8177c03812c092ccfb97778a856a541a9e362f5bae746bf332d98f0d794.webp)
   8. Click **Create function**.
   9. Once created, you will see an editor where you are able to create a new function. Enter the following — replace `bot-handle` with your AI Agent’s handle:
   ```python
   import json
   import urllib.request
   from urllib.error import HTTPError

   def lambda_handler(event, context):
       uuid = event['Details']['Parameters']['uuid']
       url = f"https://bot-handle.ada.support/voice/transfers/{uuid}/"

       for attempt in range(3):
           try:
               response = urllib.request.urlopen(url)
               destinationQueue = response.read().decode('utf-8')
               return {
                   'destinationQueue': destinationQueue,
               }
           except HTTPError as e:
               if e.code == 404:
                   # Handle 404 error: no destinationQueue available
                   return {
                       'destinationQueue': None,
                       'error': 'Destination queue not found (404)'
                   }
               # Retry on other errors except 404
               if attempt == 2:  # After 3rd attempt, raise the exception
                   raise e
           except Exception as e:
               # Retry on any other exception
               if attempt == 2:  # After 3rd attempt, raise the exception
                   raise e
   ```
   11. Click the **Deploy** button.

4. After creating, allow your Amazon Connect instance to access the Lambda:

   1. Go to Amazon Connect on AWS dashboard
   2. Click on the instance
   3. Click “Flows” on the left sidebar
   4. Scroll down to "AWS Lambda” section
   5. Add function created above

5. Use the [**Invoke an AWS lambda function**](https://docs.aws.amazon.com/connect/latest/adminguide/invoke-lambda-function-block.html) block to call your newly created AWS Lambda function and to retrieve the `destinationQueue` from Ada for your call. Enter the following property values:
   * **Destination Key:** uuid
   * **Value:** Set dynamically
     * **Namespace:** External
     * **Key:** uuid
   * **Timeout:** 3
   * **Response validation:** JSON
   ![](/_fern-files/_img/6421babb14d7281e1e64a8a38186a29622143a2fe27b8a5a8fa3172884a3415f.webp)

6. Use the `destinationQueue` value that is returned in this Lambda function to determine what queue to send the end user to.

#### Integrate Voice with Twilio Flex

#### Get calls into Ada

* If you want your AI Agent to answer all calls that are made to a phone number, the best option is to configure your AI Agent to use that phone number. For more information, see [Set up your Twilio account](/generative/docs/channels/voice/voice-onboarding#UUID-e17eb05a-42bb-6a3d-e842-36988f98b48c_section-idm4568353819620833638835749351).
* If you don't want your AI Agent to answer all calls that are made to a phone number, then you can choose to just forward certain calls from Twilio Flex to Ada using Twilio Studio and a SIP INVITE transfer:

  1. You will need to set-up a SIP domain for your AI Agent to use. In order to do this, see **Set up your Twilio account** in [Get started with Voice](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/get-started-with-voice) at Ada's Help Docs.
  2. You will also need the following, which your Ada team can provide to you:
  * Ada Voice SIP Proxy address
  * Voice SIP Proxy secret key
  * Sender name
  4. In Twilio Studio, in the UUI header, add a `phone_number` field, and set the value to the end user’s phone number.
  5. Go to **Twilio** > **Services**, and use the secret key and sender name you got from Ada to generate an authentication signature by defining a function:
  ```js
  const crypto = require('crypto');

  // Helper function to get rounded time
  function getRoundedTime() {
  const now = new Date();
  now.setUTCMinutes(Math.floor(now.getUTCMinutes() / 10) * 10);
  now.setUTCSeconds(0, 0);
  return Math.floor(now.getTime() / 1000);
  }

  // Function to generate authentication signature
  function generateAuthenticationSignature(twilioCallId, secret) {
  const roundedTime = getRoundedTime();
  const message = `${twilioCallId}|${roundedTime}`;
  console.log("Rounded Time: ", roundedTime);
  if (!secret) {
  throw new Error('VOICE_SIP_PROXY_SECRET not found.');
  }
  const hmac = crypto.createHmac('sha3-256', secret);
  hmac.update(message);
  const hmacSignature = hmac.digest('hex');
  sender = "TEST_TFLEX"
  return `${twilioCallId}|${hmacSignature}|${sender}`;
  }

  // Twilio Function
  exports.handler = function (context, event, callback) {  
  let authSignature = ""
  try {
  const twilioCallId = event.CallSid; 
  const secret = context.VOICE_SIP_PROXY_SECRET 
  authSignature = generateAuthenticationSignature(twilioCallId, secret);
  } catch (error) {
  console.error('Error generating authentication signature:', error.message);
  }
  const response = new Twilio.Response();
  console.log('Authentication Signature:', authSignature);
  response
  .setStatusCode(200)
  .appendHeader('Content-Type', 'application/json')
  .setBody({
      everything: encodeURIComponent(authSignature),
  });

  return callback(null, response);
  };
  ```
  7. Use a [**Run Function**](https://www.twilio.com/docs/studio/widget-library/run-function) widget to pass the output from the above to a linked **Connect Call To** widget.
  8. In the [**Connect Call To**](https://www.twilio.com/docs/studio/widget-library/connect-call) widget, you will need to set the SIP address using Ada Voice SIP Proxy address that your Ada Team provided to you.

#### Escalate calls directly to agents using Twilio Flex

If an end user using your AI Agent needs to escalate to a human agent, you can hand them off using a SIP INVITE transfer to Twilio Flex. You can pass information about the end user and the conversation using the User-to-User header, such as the queue that you want to send the end user to or the language of the end user.

To do this, make sure you have the following:

* A SIP domain on Twilio.
  * This is an additional SIP domain to the one you set up for your AI Agent. When your AI Agent is handing off a call, this is the SIP domain that your AI Agent will transfer the call to. You will configure this SIP domain so that when a call is transferred to it a new Twilio Studio flow will initiate.
* An instance of Twilio Flex.

1. Set up a basic trigger in Twilio Studio

   1. Go to **Studio** > **Flows** > **Create new flow**, and give your flow a name, e.g., `voice-twilio-flex-flow`.
   2. Create a simple branch off of incoming calls, and add a Say or Play block to it. Here's an example, where incoming calls get the message "Transfer from Ada complete":
   ![](/_fern-files/_img/2044df7e7ac1a3f283cd9cf0b2e791301b0d4827b24cc276fa0d891f676b48b6.webp)
   Make sure you save and publish your flow.
   5. Configure your SIP domain to forward incoming calls to this flow.
   1. You can do this by going to your SIP domains configuration settings.
   2. Under **Call Control Configuration**, select **Twilio Studio** from the drop down menu located beside **A CALL COMES IN**.
   3. In the drop down menu beside that, select the name of your Twilio Studio flow.
   ![](/_fern-files/_img/abfc0cdb89653e621cd3ac19a4e5307a7ec8f1a895f736d1e288d9f2cace15d8.webp)
   8. In your Ada [AI Agent Handoff](https://docs.ada.cx/docs/generative/set-up-your-ai-agent-s-knowledge-and-behavior/manage-your-ai-agent-s-behavior/manage-how-your-ai-agent-hands-customers-off-to-live-agents#edit) use the [Transfer Call block](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/create-and-adapt-content-for-voice-conversations) and select **SIP address** from the **Transfer to** drop down menu. Enter the SIP address you created for your new Twilio Studio Flow in the **SIP address** field.
   9. If the transfer is successful, you should hear the message you added; in our example, "Transfer from Ada complete."

2. Pass information in the User-to-User (UUI) header.

   1. To pass data in the SIP User-to-User header in the Ada [Transfer Call block](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/create-and-adapt-content-for-voice-conversations) select the checkbox beside **Include a User-to-User header when transferring to the SIP address**.
   2. Click **+Add another row** and provide a key value pair in the **Key** and **Value** fields.
   3. Repeat this for additional data fields you want to pass.
   4. In the flow you created, add a function to the Say/Play block, with the following attributes:
   * **Widget name**: Add a name
   * **Service**: `HEX-to-ASCII`
   * **Environment**: `ui`
   * **Function**: `/getUUIHeaders`
   * **Function URL**: `https://hex-to-ascii-3794.twil.io/getUUIHeaders`
   * **Function Parameters**: set `UUI_Headers` to `{{trigger.call.SipHeader_User-to-User}}`
   ![](/_fern-files/_img/6b132e7786267b26ca0c2d4e32c20d6183722f9afccf8113c7754e4f37d8575c.webp)
   7. Go to **Develop** > **Function sand Assets** > **Services**.
   8. Define the service and implementation of the function. Here's an example of a function that extracts the UUI headers, and decodes them from HEX if needed:
   ```js
   exports.handler = function(context, event, callback) {
   let twiml = new Twilio.twiml.VoiceResponse();

   // Check if UUI_Headers exists and contains "encoding=hex"
   if (event.UUI_Headers && event.UUI_Headers.includes("encoding=hex")) {
       // Step 2: Remove everything from the first ";" onwards
   let uui = event.UUI_Headers.split(';')[0];

   // Step 3: Check if the hex encoded string starts with "XX" and remove it
   if (uui.startsWith("XX")) {
       uui = uui.substring(2);
   }

   // Step 4: Decode the hex string to ASCII
   let asciiString = hexToAscii(uui);
   console.log('Decoded UUI:', asciiString);

   // You can use the decoded string as needed; here we just return it in the response for demonstration
   twiml.say(`Decoded UUI Header: ${asciiString}`);
   } else {
       // If "encoding=hex" is not found, or UUI_Headers does not exist, return the UUI_Headers field as is
       console.log('UUI_Headers:', event.UUI_Headers);
       twiml.say('UUI Headers do not require decoding.');
       twiml.say(`UUI Header: ${asciiString}`);
   }

   return callback(null, twiml);
   };

   // Helper function to convert hex to ASCII
   function hexToAscii(hexStr) {
       var hex = hexStr.toString(); //force conversion
       var str = '';
       for (var i = 0; i < hex.length; i += 2)
           str += String.fromCharCode(parseInt(hex.substr(i, 2), 16));
       return str;
   }
   ```
   10. Click **Deploy All** to deploy your changes, and turn on the **Live logs on** toggle.
   11. Try transferring a call again like you did earlier, but this time, include some data in the User-to-User header. You should see those extracted variables in your live logs.

#### Integrate Voice with Dixa

This section takes you through how to transfer calls between Ada and Dixa.

#### Get calls into Ada

* You will continue to receive phone calls using a Dixa provisioned phone number, and you will transfer phone calls from Dixa to your Ada AI Agent’s phone number. For more information, see the Forward call section in [Create a Phone Flow](https://support.dixa.help/en/articles/26-create-a-phone-flow) at Dixa's documentation. You will also need to configure a Twilio phone number for your AI Agent to use. For more information, see **Set up your Twilio account** in [Get started with Voice](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/get-started-with-voice/) at Ada’s Help Docs.

#### Escalate calls directly to agents using Dixa

If an end user using your AI Agent needs to escalate to a human agent, you can hand them off using a SIP INVITE transfer to Dixa.

1. Get the Ada IP address allowlist from your Ada team.
2. Ask your Dixa Team to allowlist the Ada IPs, and ask them for your Dixa SIP domain.
3. In your Dixa instance, go to **Settings** > **Phone**, and configure a DID number.
4. In your Ada [AI Agent Handoff](https://docs.ada.cx/docs/generative/set-up-your-ai-agent-s-knowledge-and-behavior/manage-your-ai-agent-s-behavior/manage-how-your-ai-agent-hands-customers-off-to-live-agents#edit) use the [Transfer Call block](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/create-and-adapt-content-for-voice-conversations) and select **SIP address** from the **Transfer to** drop down menu.
5. In the **SIP address** field, enter `<DID>@<DIXA_SIP_DOMAIN>`, where:
   * `<DID>`: The destination number in Dixa that is being reached, in E164 format with a leading `+`.
   * `<DIXA_SIP_DOMAIN>`: Dixa’s SIP domain, which you got from the Dixa team.
6. Select the checkbox beside **Include a User-to-User header when transferring to the SIP address**.
7. Click **+Add another row**.
8. For **Key**, enter the key name `phone_number`.
9. For **Value**, select the `phone_number` metavariable.

If required, you can assign different phone numbers to different departments. For example, you can configure one number for handoffs related to billing issues, and another one related to sales inquiries. To learn how to do this, see [Buy a Phone Number](https://support.dixa.help/en/articles/61-buy-a-phone-number) at Dixa’s documentation.

#### Integrate Voice with Genesys Cloud

#### Get calls into Ada\[#UUID-f619f691-3089-cd33-6ce6-8bc5cfbf038f_bridgehead-idm4551920899390434013949995364]

You will continue to receive phone calls using a Genesys Cloud provisioned phone number, and you will transfer phone calls from Genesys Cloud to your Ada AI Agent using a SIP INVITE made to your AI Agent's SIP domain.

1. If you have not done so already, configure a Twilio SIP domain for your AI Agent to use. For more information, see **Set up your Twilio account** in [Get started with Voice](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/get-started-with-voice/) at Ada’s Help Docs.

2. Log into your Genesys Cloud account, then go to the [Admin tab](https://apps.usw2.pure.cloud/directory/#/admin/welcomeV2).

3. Under **Telephony**, click **Trunks**.

![](/_fern-files/_img/b4cd2050932fa1fa232b5014db1a74cb52c46071de07e859dfd215070b3f4ed8.webp)

4. On the **External Trunks** tab, click **Create New**. The Create External Trunk page opens.

![](/_fern-files/_img/83c0a020dec07a1be32f800df86599eff95d45d57dddf1b7900930d1e553a3a8.webp)

5. On the **Create External Trunk** page, fill in the following fields:

   1. Under **External Trunk Name**, enter a name (e.g.,
      `Ada Voice trunk`).
   2. Under **Type**, select **BYOC Carrier** and **Generic BYOC Carrier**.
   3. Under **Protocol**, select **TLS**.

![](/_fern-files/_img/cadf7ee5e8166687563d3c94d93615304805a3123ed3d78aeb59a76fcabd1fde.webp)

6. In the **Inbound** section, fill in the following fields:

   1. Under **Number Plan Site**, select your main Genesys site. For
      more information, see [About sites](https://help.mypurecloud.com/articles/about-sites/) at
      the Genesys Cloud Resource Center.
   2. Under **Inbound SIP Termination Identifier**, enter a name
      (e.g., `ada-voice`).
   3. You can leave the **Inbound SIP Termination Header** field
      blank.

![](/_fern-files/_img/a3842379ee9cdd8119c820c97a1e58a336b7d767e46ecf0adb965566d12a96a7.webp)

7. In the **Outbound** section, fill in the following fields:

   1. Under **Outbound SIP Termination FQDN**, enter the Twilio SIP domain that you created for your AI Agent in **Step 1**.
   2. Under **Outbound SIP DNIS**, enter `admin`.
   3. Under **SIP Servers or Proxies**, in the **Hostname or IP
      Address** field, enter your SIP domain, and in the **Port**
      field, enter `5061`. Then, click the **+** icon to add it.

![](/_fern-files/_img/b164884321e68827ddfd0f514058b64483282c07aa02f6ce3fbec5cf0447f53d.webp)

8. Under **SIP Access Control**, in the **Add an IP or CIDR address**
   field, enter each of the following CIDR addresses, one at a time,
   and click the **+** icon to add it.

   These are all of Twilio's SIP IP addresses. For more information,
   see [IP Addresses for Elastic SIP Trunking Services](https://www.twilio.com/docs/sip-trunking/ip-addresses) at
   Twilio Docs.

   ```
   168.86.128.0/18
   54.172.60.0/30
   54.172.60.0/23
   34.203.250.0/23
   54.244.51.0/30
   54.244.51.0/24
   54.171.127.192/30
   54.171.127.192/26
   52.215.127.0/24
   35.156.191.128/30
   35.156.191.128/25
   3.122.181.0/24
   54.65.63.192/30
   54.65.63.192/26
   3.112.80.0/24
   54.169.127.128/30
   54.169.127.128/26
   3.1.77.0/24
   54.252.254.64/30
   54.252.254.64/26
   3.104.90.0/24
   177.71.206.192/30
   177.71.206.192/26
   18.228.249.0/24
   ```

![](/_fern-files/_img/f46a9ac4405b55d0a396bbc159938a12994512d10146b9446e1bea202d874773.webp)

9. Click the **Protocol** section of the page to expand it. Then, under
   **User to User Information (UUI)**, do the following:

   1. Click the **UUI Passthrough** toggle so it's **Enabled**.
   2. Under **Type**, select **User-to-User PD Attribute**.
   3. Under **Encoding Format**, select **Ascii**.

![](/_fern-files/_img/b378d48fc7fc5bf056ccfa3b3ab8e90e23bc8f23faef12a748a6d14208bd3e1b.webp)![](/_fern-files/_img/61914072a0b7bf5d93b1553a933c6b31807b81b5a82e1c883b1276056f708804.webp)

10. Under **Transfer**, click the **Take Back and Transfer** and
    **Release Link Transfer (RLT)** toggles so they're both **Enabled**.

11. Click **Save External Trunk**.

#### Connect your SIP trunk to a number plan\[#UUID-f619f691-3089-cd33-6ce6-8bc5cfbf038f_bridgehead-idm4616838272318434013950727136]

1. In Genesys Cloud, go to **Telephony** > **Sites** and select your
   main site. For more information, see [About sites](https://help.mypurecloud.com/articles/about-sites/) at the
   Genesys Cloud Resource Center.

![](/_fern-files/_img/2858562b56e0e47747cb40690233903e3c79550e4701e477026b17773967e84f.webp)

2. On the **Number Plans** tab, click **New Number Plan**.

![](/_fern-files/_img/0e2ba5aeaf7524bd8d2caea34273a48730d5d3e8239f14107b9e276abdd75156.webp)

3. On the page that opens, fill in the following fields:

   1. Under **Number Plan Name**, enter a name.
   2. Under **Match Type**, select **E.164 Number List**.
   3. Under **Numbers**, enter the range of numbers that, when dialed
      from your system, will transfer to Ada Voice. These can be
      placeholders, and they can be the same number to indicate that
      the range only contains one phone number.
   4. Under **Classification**, choose a classification.

![](/_fern-files/_img/0b349c194dde5d8b9215d030f5aa3e87c1ff6d6daee5a7663f488319ab5fe942.webp)

4. Click **Save Number Plans**.

5. On the **Outbound Routes** tab, click **New Outbound Route**.

![](/_fern-files/_img/68fc64774b87babef817018f360534f583e61bd1714e0dd1d029b761b0159cb0.webp)

6. On the page that opens, fill in the following fields:

   1. Under **Outbound Route Name**, enter a name.
   2. Under **Classifications**, choose one or more classifications.
   3. Under **External Trunks**, click **Select External Trunks** and
      select the SIP trunk you created.
   4. Under **Classifications**, add a classification for your Outbound Route. This must match the Classification that you used for
      your Number Plan.

![](/_fern-files/_img/8951977cd0d9d0a5d08227fe852c302667a68694644e044f3932d08710eca9b4.webp)

7. Click **Save Outbound Routes**.

#### Create a call flow that transfers to Ada Voice\[#UUID-f619f691-3089-cd33-6ce6-8bc5cfbf038f_bridgehead-idm4630089829270434014235763721]

1. In Genesys Cloud, on the **Admin** tab, click **Architect**.

![](/_fern-files/_img/57f8444fd98dea3902f44180649ed66b433873454cffecbed267b9434ce3cdd6.webp)

2. Select the call flow you want to transfer to Ada Voice. The Inbound
   Call Flow page opens.

3. On the Inbound Call Flow page, under **Toolbox**, click **Task** to
   expand it, then drag the **Task** action into your **Starting
   Menu**. This creates the task we use to transfer end users to Ada
   Voice. The New Task pane opens.

![](/_fern-files/_img/b413e7dd9686dc59c1f9a4df2e2ef2bd8bffcdad6b586c303e253e68c2e78e2e.webp)

4. Under **Toolbox**, click **Data** to expand it, then drag the **Set
   UUI Data** action into the New Task pane, into the **Drag action
   here** box. The Set UUI Data pane opens.

![](/_fern-files/_img/897366d104ada60468444872241d77585b82ef6a036a16230f63b1044992fa51.webp)

5. In the Set UUI Data pane, under **Outgoing UUI Data**, beside the
   **Enter value** field, click the menu that has an icon of a document
   on it, and select **String Builder**.

![](/_fern-files/_img/d72204ca7b63e585834a13542f8bc72af13de76ca1a11c1039ca12b463e3b6ee.webp)

6. Click the same menu again and click **Expression**. The String
   Builder window opens. In the String Builder window, under
   **Expression**, enter this string:

   ```
   Append("phone_number=", Replace(Call.Ani, "tel:", ""))
   ```

   This is a Genesys expression that extracts the end user's number and
   adds it to the UUI header in the format Ada Voice expects (e.g.,
   `phone_number=+14035555555`).

![](/_fern-files/_img/b65cb7173ab5049c3306fba6317e858fa8ed4dd9ed4ee693b27da05c87c3bb0a.webp)

7. Click **Save** to save the string and close the String Builder
   window.

8. Under **Toolbox**, click **Transfer** to expand it, then drag the
   **Transfer to Number** action into the New Task pane, under the Set
   UUI Data action you just added. The Transfer to Number pane opens.

![](/_fern-files/_img/3619b53b27ee75dd76340e394dd8dfbfb37d4727c7eccadef99126bb69cc1ec6.webp)

9. In the Transfer to Number pane, do the following:

   1. Under **Number**, enter the number you added in your number plan
      earlier.
   2. Under **Perform release link transfer**, select **True**.

![](/_fern-files/_img/7581d83103e6e5eb15c226d45cb1e9ddf80502ead7628d5e6e19ebc9ff3dc457.webp)

10. Under **Toolbox**, click **Disconnect** to expand it, then drag the
    **Disconnect** action into the New Task pane, under the Transfer to
    Number action you just added.

11. Click **Publish**.

At this point, you should be able to call your Genesys Cloud IVR and be
successfully transferred to Ada Voice.

#### Escalate calls directly to agents using Genesys Cloud

If an end user using your AI Agent needs to escalate to a human agent, you can hand them off using a SIP REFER transfer to Genesys Cloud.

1. In your Ada [AI Agent Handoff](https://docs.ada.cx/docs/generative/set-up-your-ai-agent-s-knowledge-and-behavior/manage-your-ai-agent-s-behavior/manage-how-your-ai-agent-hands-customers-off-to-live-agents#edit) use the [Transfer Call block](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/create-and-adapt-content-for-voice-conversations) and select **SIP address** from the **Transfer to** drop down menu.
2. In the **SIP address** field, enter `<DID>@admin.byoc.usw2.pure.cloud`, where `<DID>` is the destination number in Genesys Cloud that is being reached, in E164 format with a leading `+`.
3. Select the checkbox beside **Include a User-to-User header when transferring to the SIP address**.
4. Click **+Add another row**.
5. For **Key**, enter the key name `phone_number`.
6. For **Value**, select the `phone_number` metavariable.
7. Click **+Add another row**.
8. Provide any additional key value pairs that you want sent to Genesys Cloud.

#### Integrate Voice with Zendesk Talk

This section takes you through how to transfer calls between Ada and Zendesk Talk. For more information about how to integrate an AI Agent to Zendesk Talk, you can also reference the **[Connecting an external AI agent using a SIP-IN line](https://support.zendesk.com/hc/en-us/articles/8397061704474-Connecting-an-external-AI-agent-using-a-SIP-IN-line)** article at Zendesk’s documentation.

#### Get calls into Ada

* You will continue to receive phone calls using a Zendesk Talk provisioned phone number, and you will transfer phone calls from Zendesk Talk to your Ada AI Agent’s phone number.
  * For more information, see the [**How can I forward calls to an external number from Zendesk Talk?**](https://support.zendesk.com/hc/en-us/articles/6639835509274-How-can-I-forward-calls-to-an-external-number-from-Zendesk-Talk) article or the [**Routing incoming calls with IVR article**](https://support.zendesk.com/hc/en-us/articles/4408885628698-Routing-incoming-calls-with-IVR) at Zendesk's documentation.
  * You will also need to configure a Twilio phone number for your AI Agent to use. For more information, see **Set up your Twilio account** in [**Get started with Voice**](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/get-started-with-voice/) at Ada’s Help Docs.

#### Escalate calls directly to agents using Zendesk Talk

If an end user using your AI Agent needs to escalate to a human agent, you can hand them off using a SIP INVITE transfer to Zendesk Talk.

1. Add a SIP-IN line in Zendesk Talk. For more information about how to do this, see the [**Adding a Talk SIP-IN line**](https://support.zendesk.com/hc/en-us/articles/8397091234586-Adding-a-Talk-SIP-IN-line) at Zendesk’s documentation.
   * When you are creating your SIP-IN line in Zendesk, you will need to provide Ada’s source IP addresses for INVITE requests (”CIDR network addresses”). Please reach out to your Ada team to obtain these.
   * You can create multiple SIP-IN lines for different skills or departments, and can route end users to the most appropriate department depending on the context of the conversation.
2. In your Ada [**AI Agent Handoff**](https://docs.ada.cx/docs/generative/set-up-your-ai-agent-s-knowledge-and-behavior/manage-your-ai-agent-s-behavior/manage-how-your-ai-agent-hands-customers-off-to-live-agents#edit) use the [**Transfer Call block**](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/create-and-adapt-content-for-voice-conversations) and select **SIP address** from the **Transfer to** drop down menu.
3. In the **SIP address** field, enter `<USERNAME>@<YOUR-UNIQUE-NAME-zendesk.sip.twilio.com>`, where:
   * `<USERNAME>`: A friendly username of your choice. We recommend using a unique username for Ada.
   * `<YOUR-UNIQUE-NAME-zendesk.sip.twilio.com>`: The URI for your SIP-IN line.
4. **Optional:** Pass a Zendesk Support ticket ID when making the transfer.
   * Before transferring the call to the Zendesk SIP-IN line, your Ada AI Agent can create a Zendesk Support ticket to log information about the conversation. Human agents will be shown the linked call tickets containing end user and SIP details when handling SIP-IN calls.
   * When creating the ticket, use the via_id 34 (details [here](https://developer.zendesk.com/documentation/ticketing/reference-guides/via-types/#:~:text=34,Phone%20call%20\(incoming\))). This will help identify it as a voice incoming call ticket in Zendesk.
   * Append the following to your SIP address as a query parameter: `X-Zendesk-Ticket-Id=<TICKET_NUMBER>` where:
     * `<TICKET_NUMBER>` - Is the number of the ticket you created.
   * ex. `<USERNAME>@<YOUR-UNIQUE-NAME-zendesk.sip.twilio.com>?X-Zendesk-Ticket-Id=<TICKET_NUMBER>`

#### Integrate Voice with Gladly

This section takes you through how to transfer calls between Ada and Gladly.

#### Get calls into Ada

* You will continue to receive phone calls using a Gladly provisioned phone number, and you will transfer phone calls from Gladly to your Ada AI Agent’s phone number.
  * For more information, see [**Configuration Options: Outbound calls, forwards via IVR, and transfers/conferences**](https://help.gladly.com/implementation/docs/set-up-voice-ivr#configuration-options-outbound-calls-forwards-via-ivr-and-transfersconferences) at Gladly's documentation.
  * You will also need to configure a Twilio phone number for your AI Agent to use. For more information, see **Set up your Twilio account** in [**Get started with Voice**](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/get-started-with-voice/) at Ada’s Help Docs.

#### Escalate calls directly to agents using Gladly

If an end user using your AI Agent needs to escalate to a human agent, you can hand them off using a SIP INVITE transfer to Gladly.

1. Get the Ada IP address allowlist from your Ada team.
2. Work with your Gladly team to set-up SIP forwarding. For more information, see [**Forward calls via SIP**](https://help.gladly.com/implementation/docs/set-up-voice-ivr#forward-calls-via-sip) at Gladly’s documentation.
   * You will use **IP address allow list** for authentication and will provide your Gladly team with the Ada IP addresses obtained in step 1 above.
   * Ada uses G.711 mediacodec.
   * You will need to provide Gladly with the list of phone numbers in Gladly that you will transfer calls from Ada to, and which will use SIP to receive the incoming call.
   * For each phone number, Gladly will set up a corresponding SIP address following the format `<DID>@<GLADLY_SIP_DOMAIN>`, where:
     * `<DID>`: The destination number in Gladly that is being reached, in E164 format with a leading +.
     * `<GLADLY_SIP_DOMAIN>`: A unique SIP domain created by Gladly.
3. In your Ada [**AI Agent Handoff**](https://docs.ada.cx/docs/generative/set-up-your-ai-agent-s-knowledge-and-behavior/manage-your-ai-agent-s-behavior/manage-how-your-ai-agent-hands-customers-off-to-live-agents#edit) use the [**Transfer Call block**](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/create-and-adapt-content-for-voice-conversations) and select **SIP address** from the **Transfer to** drop down menu.
4. In the **SIP address** field, enter your SIP address obtained from Gladly in step 2 following the format `<DID>@<GLADLY_SIP_DOMAIN>;transport=tls`.
5. Append `X-Gladly-Caller-Id=<ANI>` to your SIP address as a query parameter, where:
   * `<ANI>`: The end user’s phone number in E164 format with a leading +. You should use the `phone_number` metavariable in Ada for this.
   * ex. `<DID>@<GLADLY_SIP_DOMAIN>;transport=tls?X-Gladly-Caller-Id=<ANI>`
6. **Optional:** If you want to route an end user to a specific queue, you can also pass a queue identifier when transferring a call.
   * Append `X-Gladly-Routing-Selector=<topic>` to your SIP address as a query parameter, where:
     * `<topic>`: The specific queue that you want to send a call to. This is a free-form, alphanumeric string identifying the specific queue to send a call to.
     * ex. `<DID>@<GLADLY_SIP_DOMAIN>;transport=tls?X-Gladly-Caller-Id=<ANI>&X-Gladly-Routing-Selector=<topic>`

#### Integrate Voice with your Cisco CUBE

This section takes you through how to integrate Ada Voice with a Cisco CUBE.

#### Setting up your Ada SIP domain

* If you are using your own Twilio account with Ada Voice, configure a Twilio SIP domain for your AI Agent to use. For more information, see Set up your Twilio account in [Get started with Voice](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/get-started-with-voice) at Ada’s Help Docs.
* If your Voice subscription package includes Twilio your Ada team will set up your SIP domain for you. You will need to provide them with the following information:
  * **The domain name for your SIP address:** This will be used for the SIP domain that will be created for you, which will follow the format `<your_domain_name>.sip.twilio.com`. This needs to be a unique domain name that is not currently being used in Twilio.
  * **IP Addresses for your SIP domain’s Access Control List (ACL):** An ACL is a security mechanism that enhances network security by allowing only specified IP addresses to access your SIP domain. In the context of SIP communications, this means defining trusted IP addresses—such as those associated with your SIP infrastructure—to ensure that only authorized signaling and media traffic is permitted to interact with your SIP domain.

#### Integrating Ada in your SIP infrastructure

You must allow all of Twilio's following IP address ranges and ports on your firewall for SIP signaling traffic. Please also note that these IP addresses are provided for firewall configuration purposes only and not all of these IP addresses will host active gateways at a given time. Customers should also avoid sending traffic directly to these IP addresses and instead use your SIP domain.

**Global Media IP Gateway**

The Public Connections Destination IP Ranges and Port Ranges are now identical across all locations:

| **Secure Media (ICE/STUN/SRTP) Edge Locations**                                                                                                                       | **Protocol** | **Source IP** | **Source Port** | **Destination IP Ranges** | **Destination Port Range** |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------------- | --------------- | ------------------------- | -------------------------- |
| sydney (**au1** )sao-paulo (**br1** )dublin (**ie1** )frankfurt (**de1** )tokyo (**jp1** )singapore (**sg1** )ashburn (**us1** )umatilla (**us2** )roaming (**gll** ) | UDP          | ANY           | ANY             | 168.86.128.0/18           | 10,000 - 60,000            |

---

**Regional Signaling IP Gateways**

***Port***

5061 (TLS)

***North America Virginia Gateways***

```jsx
1    54.172.60.0/30 which translates to:
2    54.172.60.0
3    54.172.60.1
4    54.172.60.2
5    54.172.60.3
6 
```

***North America Oregon Gateways***

```jsx
1    54.244.51.0/30 which translates to:
2    54.244.51.0
3    54.244.51.1
4    54.244.51.2
5    54.244.51.3
6
```

***Europe Ireland Gateways***

```jsx
1    54.171.127.192/30 which translates to:
2    54.171.127.192
3    54.171.127.193
4    54.171.127.194
5    54.171.127.195
6
```

***Europe Frankfurt Gateways***

```jsx
1    35.156.191.128/30 which translates to:
2    35.156.191.128
3    35.156.191.129
4    35.156.191.130
5    35.156.191.131
6
```

***Asia-Pacific Tokyo Gateways***

```jsx
1    54.65.63.192/30 which translates to:
2    54.65.63.192
3    54.65.63.193
4    54.65.63.194
5    54.65.63.195

```

***Asia-Pacific Singapore Gateways***

```jsx
1    54.169.127.128/30 which translates to:
2    54.169.127.128
3    54.169.127.129
4    54.169.127.130
5    54.169.127.131
6
```

***Asia-Pacific Sydney Gateways***

```jsx
1    54.252.254.64/30 which translates to:
2    54.252.254.64
3    54.252.254.65
4    54.252.254.66
5    54.252.254.67
6
```

***South America São Paulo Gateways***

```jsx
1    177.71.206.192/30 which translates to:
2    177.71.206.192
3    177.71.206.193
4    177.71.206.194
5    177.71.206.195
6
```

#### Routing Calls to Ada

In order to route calls to Ada, you must make a SIP INVITE to Ada.

* The SIP INVITE `TO` SIP address should be `<DID>@<YOUR_ADA_SIP_DOMAIN>`, where:
  * **`<DID>`:** The phone number that you used to receive the call.
  * **`<YOUR_ADA_SIP_DOMAIN>`:** The Ada SIP domain for your Ada AI Agent.
* The `FROM` SIP address should be `<ANI>@<YOUR_IP_ADDRESS>` where:
  * **`<ANI>`:** The end user's phone number.
  * **`<YOUR_IP_ADDRESS>`:** The IP addresses of your SIP infrastructure.

#### Transferring Calls from Ada to your Cisco CUBE

If a caller using your AI Agent needs to escalate to a human agent, you can hand them off using a SIP REFER transfer to your SIP infrastructure.

1. In your [Ada AI Agent Handoff](https://docs.ada.cx/docs/generative/set-up-your-ai-agent-s-knowledge-and-behavior/manage-your-ai-agent-s-behavior/manage-how-your-ai-agent-hands-customers-off-to-live-agents/#edit) use the [Transfer Call block](https://docs.ada.cx/docs/generative/deploy-ada-across-channels/voice/create-and-adapt-content-for-voice-conversations/) and select SIP address from the Transfer to drop down menu.
2. In the SIP address field, enter the SIP address that you want to transfer the call to. This will generally be `<DID>@<YOUR_IP_ADDRESS>`, where:
   * **`<DID>`:** The line or extension that you want to transfer the call to.
   * **`<YOUR_ADA_SIP_DOMAIN>`:** The IP addresses of your SIP infrastructure.
3. Select the checkbox beside Include a User-to-User header when transferring to the SIP address.
4. Click +Add another row.
5. For Key, enter the key name phone_number.
6. For Value, select the phone_number metavariable.
7. Click +Add another row.
8. Provide any additional key value pairs that you want sent via the UUI header.

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).