The purpose of this article is to provide an overview of the Numbers / My Numbers Page found in the Telnyx Portal along with a brief description of all the options available.
Main Numbers / My Numbers Page
On this page, you will see all of your procured numbers. They will show up in the order that you have purchased them by default. You can also sort your numbers by order date, phone number, connection, and billing method.
*Do note that you can have up to 100 numbers per page as well by clicking the appropriate button.*
More specific filtering can be set by the filters found in the appropriate section:
Connection or Application: This is by which connection SIP connection you have established, which numbers you have set to Forward only, or by which Call Control application you have them set to.
Number (Partial or Full): Input any quantity of digits and it will filter by the ones entered.
Status: This is based on the procurement status of the number. Among these are if they are pending purchase, port status, and if they are emergency only.
Voice Billing Method: Either normal billing by minutes or by the channel billing method.
Tag: Custom tags that you can add per number. You can set these to filter your numbers by name, organization, or however you want to filter them out.
Emergency Status: Set to disabled, active, provisioning, or de-provisioning.
Note: These filters do not apply to the export csv button and only filter the numbers on the user interface.
Bulk Edit Numbers
If you want to update multiple numbers at once, you can utilize the bulk edit feature on this page.
Simply select the numbers you would like to update, then click on Bulk Edit. From here you can change the wanted settings as you see fit.
*NOTE: If you wish to edit more than 100 numbers at a time, you can select all the currently available numbers on the screen. A prompt will show up below the bulk edit to match all numbers applied with your filters.
The maximum cap for this is 1,000. If you wish to edit more than 1000 numbers, you will have to do this sequentially.
Each number has it’s own settings than you can configure by clicking on the gear icon on the right.
We will go over these section by section:
Here you can set up emergency services use. This will incur a monthly fee for the number.
Once enabled, you can add an address to have it setup for e911 services. When dialing to 911 from this number, the local PSAP will be able to see the callers ID and the address you associated with the DID.
*NOTE: If you dial 911 without having emergency services enabled on your DIDs, you will incur a $100 fee per call that is made. Please ensure that the caller ID is sent out in +E.164 format.
Here you can change your connection and message profile assignment.
You can set your connection or application to any of the SIP connections you have setup in your SIP Connections section, set the number to be Forward Only, or to which Call Control application that you’ve configured.
You can also set which Messaging Profile you want the number to be configured to, if the number is SMS Capable at the time of purchase.
From here you can set the traffic type of the number, either A2P or P2P. More info on which you would want to choose can be found here.
In this section you can also see some important statistics about the number and it’s messaging capabilities such as what kind of messaging it supports (SMS and/or MMS), and the health of the number. The health is determine on delivery of messages for failed messages, it does not take into account opt outs.
You can add a custom tag to each number. This can help identify the number from your list as well as have an easy way to filter based on your own custom parameters.
Tagging is key to a multi-tenant environment and allows you to easily download call detail record reports from your reporting section.
Here you can setup some additional settings for each number.
Billing Group allows you group numbers in the reporting section & ledger records to have easier ways to filter the cost based on the numbers assigned. In other words if you have multiple clients underneath your organization and each have their own separate numbers, you can set them to each be under a different billing group. Then in the reporting section you can see exactly how much each of your client owes individually.
Voice Billing Method configures on how you want the number to be billed for incoming calls. You can set this to either Pay Per Minute or Channel Billing. Channel billing information can be found here.
You can enable CNAM Listings and Caller ID Name here. More information on the differences can be found here.
Forwards To just does that; it allows you to configure the number forward for this individual number. After entering a number, you can set the forward to either Always or On-Failure. Always makes incoming calls forward to the number entered whenever you would call this number. On-Failure sets it to do so only when the number can not be reached.
Expert Configuration enables more complicated settings.
Translated Number lets you setup custom number translations in the SIP headers, ideal for ATA's that require a different value in the INVITE/TO header in the SIP INVITE for inbound calls.
Telnyx will automatically detect your media IP address by monitoring the RTP packets received during the first seconds after media establishment on the media IP address:port pair and adjust it automatically if it differs from the pair announced by you during call establishment. This option can be disabled using the option Disable RTP Auto Adjust.
The same behavior can be extended to the whole duration of the call by selecting the option Accept any RTP packets.
You can enable the number to have a Tech Prefix to differentiate between other incoming numbers. This setting only works with IP/FQDN based SIP Connections and will not apply to numbers associated with a SIP credentials based Connection.
SIP Connection A: IP Authentication with tech prefix 8888.
SIP Connection B: IP Authentication with tech prefix 1234.
If SIP Connection A dials a number associated with SIP Connection B, where B has the tech prefix feature enabled on the number, the incoming call will be prefixed with 1234+number.
When the feature is disabled on the number, the tech prefix associated with SIP Connection B will not be included in the SIP INVITE.
Note: If you have translated number enabled with a value of 4444 and you also have tech prefix enabled, the resulting SIP INVITE would look like 1234+4444+number.
Setup the settings to be able to store recordings of the calls you make using the number. You can set it to use either WAV or MP3 file systems as well as configure if it’s Single Channel or Dual Channel. Recordings will be made available here.