Description

This article describes the number formatting functionality available on the inbound settings of your SIP Connections.

Video Walk-through

Configuration

The SIP Connections section is located on the left pane when signed into your account. This section allows you to whitelist the different SIP connections of your phone systems. They can be assigned to DID's to allow for inbound calling and assigned to Outbound Voice Profiles for allowing outbound calling.

Click on this button below and it will directly get you to the SIP Connections section.

Step by Step Guide

You can create a SIP Connection by clicking the green "+ Add SIP Connection" button on the right side of the web page.

If you already have a SIP Connection, go straight ahead and click the inbound settings icon, where the arrow is pointing on the right side of the web page.

1. Inbound

You'll now see a settings section appear with the number format functionality we're interested in, specifically DNIS (dialed number) and ANI (originating number)

  1. Dialed Number Information Service (DNIS) is designed to allow the recipient of a telephone call the know the phone number originally dialed for an incoming phone call.
  2. Automatic number identification (ANI) is a feature of a telecommunications network for automatically determining the origination telephone number on toll calls for billing purposes.

Some phone systems prefer to accept specific number formats on their inbound calls, we describe the different number formats below which are configurable from the drop-down menus.

  • +E.164 - When selected, Telnyx will include, in the SIP INVITE, the number with the + included in front of the country code.
  • E.164 - When selected, Telnyx will include, in the SIP INVITE, the number without the + included in front of the country code.
  • National (10 digits) - When selected, Telnyx will include, in the SIP INVITE, the local 10 digit format of the country.
  • SIP Username - When selected, Telnyx will include, in the SIP INVITE, the username of the SIP Connection. This is only available for credential authentication based connections and only for the DNIS.
  • +E.164 / National (10 digits) - This option is only available to configure on the ANI. Depending on the callers number and country of origin, will depend on what Telnyx sends.

    Example: If the dialed number is US based and the origin number is also US based, then the SIP INVITE will contain 10 digit ANI number format. However, if the dialed number is US based but the origin is not US based but International, then Telnyx will send the ANI as +E.164 number format.
  • E.164 / National (10 digits) - This option is only available to configure on the ANI. Depending on the callers number and country of origin, will depend on what Telnyx sends.

    Example: If the dialed number is US based and the origin number is also US based, then the SIP INVITE will contain 10 digit ANI number format. However, if the dialed number is US based but the origin is not US based but International, then Telnyx will send the ANI as E.164 number format.


ANI Number Format Options

DNIS Number Format Options

2. Outbound

When making outbound calls through Telnyx, we support all number format types. In particular, we allow for the use of localization. This feature, when enabled with the country of interest, will allow the user to dial out with the associated exit code of that country and allow the user to dial local numbers of that country also, without having the include the exit + country code.

Special Note

With Telnyx, if you choose to build a WebRTC application, you can create a credential authentication based connection. Once created, you will be provided with, or can edit yourself, a username and password.

You can then specify the DNIS number format as the SIP Username such that when inbound calls arrive to our network toward your DID's associated with the SIP Connection, we'll send the username of the SIP Connection in the SIP INVITE.

Lastly, don't forget to select the VP8/9 codecs in the expert settings of the inbound section of the SIP Connection. This allows Telnyx to send the SIP INVITE to your WebRTC application with these codecs in the media parameters, which are ideal for video!

Can't find what you're looking for? Click the chat bubble at your lower right-hand corner and talk to the support team!

Did this answer your question?