AVOXI - Genesys SIP Forwarding Guide

Genesys Configuration 

When routing your inbound calls to your Genesys platform, you are required to configure some settings within your Genesys platform.  Once the destination address is set up you can then set up your number to forward/route call traffic to this source within your AVOXI platform.

Use the step by step instruction in the Genesys SIP Configuration Guide

Genesys Configuration in Genius

After you've completed your Genesys configuration you can now configure your SIP URI in Genius to forward calls. To do so simply select the Genesys tile within the SIP Marketplace in Genius.

The Add New SIP URI modal will appear to complete the configuration. Of note is the SIP Address section in this modal. 

Here you can add the Inbound SIP Termination Identifier, the appropriate Genesys Cloud IP address, and the port used when constructing the SIP URI. Use the links below for more information on on the SIP Termination Identifier and Genesys Cloud IP address. 

Inbound SIP Termination Identifier 

Genesys Cloud IP address

Setup SIP Forwarding in Genius

SIP forwarding allows AVOXI Genius Admins to forward incoming calls to your AVOXI virtual number to a SIP address or PBX. Just like a toll-free number can be forwarded to a landline or mobile telephone, it can also be forwarded to VoIP (Voice over Internet Protocol), also referred to as SIP. Forwarding to SIP works the same as call forwarding in that you can forward calls based on a specific action or preset rules. These rules can be configured or updated at any time via your AVOXI online portal.  


 

Delete

SIP TRUNKING:  Use the following SIP Trunking Configuration Guide to configure SIP for outbound termination.


 

Use the below guides and quick links to configure the SIP account. All calls should be diverted too: 

Add New SIP URI

  1. Log into your AVOXI platform at https://genius.avoxi.com
  2. Navigate to the SIP Integrations section located on the left-hand navigation bar
  3. The SIP URI tab will be open by default
  4. Click on either the relevant tile across the Marketplace or  the '+ Add SIP URI' button to the right of the filter magnifying glass
  5. The SIP URI configuration tool consists of 4 configurable fields and one auto-generated preview field.
    1. Name: Meaningful name of the new SIP URI configuration.
    2. SIP Connection: If you selected a specific tile in the Marketplace this field will be pre-selected. If you selected Add SIP URI click on 'Custom SIP'. for routingyour incoming call traffic.
    3. Protocol: A transport protocol for your SIP URI configuration. AVOXI supports UDP, TCP, and TLS(SRTP); for more information about the differences between these three protocols, please refer here!  
    4. URI: This is the configurable URI you will use to set up your forwarding. There are three components. 
      1. The caller ID format is expected from the dialed AVOXI number; the three format options are e.164 with or without a '+' and a custom DINS field.
      2. Your particular phone system uses the public domain name or IP address target. In this example, Twilio's public domain is used. 
      3. Last is the port to which your URI is listening; the default is set to 5060, but based on your solution, it may be different. 
    5. Preview: This is a preview of your full SIP URI
    6. Terminal Error Codes (Optional): SIP Response codes (between 400 - 699) entered here will result in call termination.
    7. Next you can optionally test SIP URI by clicking the drop down in section 2. 
      1. Select a number that the SIP URI test call will reach
        1. If you selected {E.164} as the call ID Format, you wills elect one of your AVOXI virtual numbers. If you entered a customer call ID format, this field will be auto populated with the corresponding IP address. 
        2. The From field will be auto populated with the AVOXI Support number.
        3. In the data center field select the AVOXI data center to host the SIP URI test call. (note: it is recommended to select the data center in the area from which this SIP URI is likely to receive inbound calls)
        4. Click Test SIP URI 
        5. The test will take between 30 seconds to 1 minute to complete
        6. The modal will be updated with the pass/fail status of the test 
        7. If the test fails the modal will be updated with the corresponding SIP error code
    8. Click 'Add New SIP URI' to save your configuration
       

Update an Existing SIP URI

This a reminder that editing an existing SIP URI configuration will change the SIP URI settings for all applicable numbers. If you still wish to proceed, please follow the below-detailed instructions.

  1. Navigate to the SIP Trunks section located on the left-hand navigation bar.
  2. Select the SIP URIs tab.
  3. Click on the "SIP URI Name" you wish to update. 
  4. Make changes to the Protocol or URI portion of your configuration on the edit page.
  5. Review the "Preview" to ensure this is displaying as required.
  6. Once satisfied, select the "Save" button to complete your configuration update.


 

Deleting an Existing SIP URI

  • On the SIP URI tab on the SIP Trunks page, click the 'Delete' button next to the SIP URI configuration you want to delete. 


 


 

  • When you are 100% sure, select the 'I understand, delete this SIP URI' option to remove it from the list.

 

Downloading SIP URI TLS Certificate

Transport Layer Security (TLS) certificates, also known as Secure Sockets Layer (SSL), work the same as HTTPS and are crucial for securing internet browser connections through data encryptions. Like HTTPS, the secure web certificate is sent when a browser tries to connect using TLS. As a customer, you can configure and manage the TLS/SRTP within your AVOXI online portal. Certificates are used for authentication and encryption.  

There is an SSL (TLS) certificate for trunk-production-us1.avoxi.com used for calls from the user to the AVOXI Genius platform and peer.avoxi.io for calls leaving AVOXI Genius. If you are running a modern operating system for your PBX, you shouldn't need to load anything extra to get a TLS connection to work, but we do offer the certificate file for edge cases.

Use the steps below to download the certificate file from your AVOXI Genius tenant if needed.

  • Navigate to the SIP Trunks section located on the left-hand navigation bar.
  • Click on the SIP URIs tab.
  • Select the three buttons located to the right of the "+Add" button
  • Click on the "Download SIP URI TLS Certificate." 

 

Adding SIP URIs to Routing Rule Targets (Numbers)

Once you have set up your new SIP URI, you can set them as targets for your forwarding rules. For example, you can set SIP URIs for call forwarding rules and teams, Virtual Attendants, and timeout targets.  

For the below example, the SIP URI is being set as a Call Forwarding rule target:

  • Navigate to the Numbers page and select the number you want to put your configured SIP URI 


  • Click 'Forwarding' tab. 
  • Use the three lines next to the "Enabled" icon to dropdown and select SIP and your preferred SIP URI.
  • Click the edit button on the rule and navigate to the 'Forward Calls To.'

  • Select SIP in the first box and then the appropriate SIP URI, click Save.
  • Navigate to the Numbers page to see that the target of that newly configured numbered is set to "Forward to SIP."

 

Bulk Update your SIP URIs Routing Rule Targets (Numbers)

With our Bulk Update functionality, users can effortlessly update the Call Forwarding rule target on multiple numbers with only a few clicks. Use the below steps to set a new or existing SIP URI as the target for your forwarding rules. 

  • Navigate to your organization's "Numbers Dashboard" using the left navigation bar's numbers icon.
  • On the "Active Numbers" tab, select the numbers you wish to update using the check box located to the left of the number.
  • Next, click the "three dots" located to the right of the "+ADD" button.
  • Select, Modify Forwarding Rules. 

 

  • Use the "Add New Rule" button to create a new routing rule. Alternatively, you can use the three lines next to the "Enabled" icon to drop down and select an existing preferred SIP URI. 


 

  • Once you are done selecting, click Save.
  • Navigate to the Numbers page to see that the target of that newly configured numbered is set to "Forward to SIP."


 

Configuration Details

Now that you have configured your SIP URIs within your AVOXI Genius account, it is essential to configure them on your communications infrastructure/platform.

INBOUND CALLING

We have Genius POPs in the US, Hong Kong, Australia, Brazil, the Middle East, the UK, Germany, and Singapore. Here are the IP Addresses from where we will be sending calls:

       
  Ports US HK AU
Firewall White list   All addresses in the column All addresses in the column 199.244.98.0/23
SIP AVOXI to Customer 5060/udp or 5060/tcp or 5061/tls 104.196.177.203
104.196.177.56        
34.96.219.253
34.92.127.143
199.244.99.84
199.244.99.85
SIP Customer to AVOXI DNS Name 5060/udp or 5060/tcp or 5061/tls trunk-production-us1.avoxi.com trunk-production-hk1.avoxi.com trunk-production-au1.avoxi.com
SIP Customer to AVOXI IPs 5060/udp or 5060/tcp or 5061/tls 35.231.51.152
35.231.63.162
34.92.174.171
34.96.245.147        
199.244.99.86 
199.244.99.87              
TURN 80/udp 35.196.133.248
104.196.96.192
35.190.137.142

34.96.206.113
34.92.130.145
34.92.190.82
34.96.234.90
31.150.105.215


199.244.99.80
199.244.99.81
199.244.99.82
199.244.99.83
199.244.99.88
Media 16384-25999 udp 34.73.213.42
34.73.56.126
34.74.129.35
34.74.26.164
34.74.55.73
34.74.74.172
34.75.17.11
34.75.197.236
34.75.227.126
34.75.42.140
34.75.49.119
34.75.61.225
34.75.97.143
35.185.23.34
35.190.170.102
35.196.156.208
35.196.163.148
35.196.177.134
35.196.59.183
35.196.97.117
35.227.42.112
35.227.70.158
35.231.143.46
35.231.244.203
35.237.150.40
35.237.210.244
35.237.212.40
35.237.221.3
35.243.176.215
35.243.199.92
35.243.241.228
104.196.165.15
34.150.67.194
34.150.89.83
34.92.121.200
34.92.127.48
34.92.192.51
34.92.230.37
34.92.230.42
34.92.48.216
34.92.74.10
34.92.83.126
34.96.137.99
35.220.131.218
35.220.179.43
35.220.179.55
35.241.116.163
35.241.87.227
All other IP addresses in 199.244.98.0/23 range


  Ports BR ME UK
Firewall White list   199.244.98.0/23 199.244.98.0/23 199.244.98.0/23
SIP AVOXI to Customer 5060/udp or 5060/tcp or 5061/tls 199.244.99.148
199.244.99.149
199.244.99.20
199.244.99.21
199.244.99.212
199.244.99.213
SIP Customer to AVOXI DNS Name 5060/udp or 5060/tcp or 5061/tls trunk-production-br1.avoxi.com trunk-production-me1.avoxi.com trunk-production-uk1.avoxi.com
SIP Customer to AVOXI IPs 5060/udp or 5060/tcp or 5061/tls 199.244.99.150
199.244.99.151
199.244.99.22
199.244.99.23
199.244.99.214
199.244.99.215
TURN 80/udp 199.244.99.144
199.244.99.145
199.244.99.146
199.244.99.147
199.244.99.152
199.244.99.16
199.244.99.17
199.244.99.18
199.244.99.19
199.244.99.24
199.244.99.208
199.244.99.209
199.244.99.210
199.244.99.211
199.244.99.216
Media 16384-25999 udp All other IP addresses in 199.244.98.0/23 range All other IP addresses in 199.244.98.0/23 range All other IP addresses in 199.244.98.0/23 range



Ports DE SG
Firewall White list
154.65.66.0/23
154.65.66.0/23
SIP AVOXI to Customer 5060/udp or 5060/tcp or 5061/tls 154.65.66.84
154.65.66.85
154.65.66.212
154.65.66.213
SIP Customer to AVOXI DNS Name 5060/udp or 5060/tcp or 5061/tls trunk-production-de1.avoxi.com trunk-production-sg1.avoxi.com
SIP Customer to AVOXI IPs 5060/udp or 5060/tcp or 5061/tls 154.65.66.86
154.65.66.87
154.65.66.214
154.65.66.215
TURN 80/udp 154.65.66.80
154.65.66.81
154.65.66.82
154.65.66.83
154.65.66.84
154.65.66.88
154.65.66.208
154.65.66.209
154.65.66.210
154.65.66.211
154.65.66.216
Media 16384-25999 udp All other IP addresses in 154.65.66.0/23 range All other IP addresses in 154.65.66.0/23 range
Delete

WARNING: If you do not whitelist the designated IPs listed under Configuration Details, you may run into signaling problems and audio issues.

Configuring Third-Party Platforms 

Use the below quick links to view the relevant configuration guide:

 

On Demand SIP URI Testing  

Use the SIP URI Testing feature to perform on demand tests of you SIP URIs. 

  1. On the SIP URIs tab the Status column will allow you to perform an on demand test and see the results from any previous test
  2. Simply click the Make Test Call icon
  3. The tests will take approximately 30 seconds to 1 minute to complete
  4. The results of the test will automatically be updated 
  5. To view the test details click on the status icon 
  6. In the event of a failure you can open a support case with our AVOXI experts from the pop up modal

Forwarding to SIP FAQs

  • Will all inbound calls be diverted to all the signed and active SIP devices and programs now? Each AVOXI number is configured separately but honors all current forwarding rules.


 

  • Will the outbound portion of an international call be cheaper when forwarding to SIP? Yes,  we do not charge termination rates to SIP


 

  • If nobody answers the call using a SIP device, will the call be redirected - if so, to where? It depends on the timeout destination and forwarding rules configuration in Genius.


 

  • If the call is busy, will it be diverted to voicemail, where a caller can leave a message? Yes, only if setup in Genius either through timeout destination or rules configuration.


 

  • What is the difference between UDP, TCP, and TLS(SRTP)? By default, VoIP calls forwarded over AVOXI's network have been done through a UDP (User Datagram Protocol) connection. This is the industry standard and the connection type most commonly recommended for VoIP users. However - due to personal preference, familiarity, local restrictions, or business needs – some customers would like to have calls forwarded using a TCP (Transmission Control Protocol). Learn more here! 


 

  • Does AVOXI Genius support TLS? Yes, if configured, both TLS and SRTP encrypt calls between you and AVOXI. TLS/SRTP can be used for both inbound and outbound voice services (Originating and Terminating). TLS, or transport layer security protocol, is the top and most potent layer responsible for securing SIP voice and media messages. This protocol uses cryptographic encryption to provide end-to-end security. TLS is best for encryption, authentication, data integrity, and secure SIP trunking. The Secure Real-time Transport Protocol (SRTP) is a security framework that extends the Real-time Transport Protocol (RTP). It's mainly intended to be used in VoIP communications to secure the actual media – the little 'packets' of data that run over the highway set up by the signaling. 


 

 

 










Give feedback about this article

Was this article helpful?

Have more questions? Submit a request

Updated:

April 4th, 2024

Author:

Criss Soto

Updated By:

Jeff Cook

KB ID:

898317

Page Views:

3997

Tags:

genesys, routing

Can’t find what you’re looking for?

Contact our award-winning customer care team.