See also:

• Function reference
• How do I ... ? example scenarios

NTS / Numbers For Incoming Calls

We can provide phone numbers which can be redirected to your landline, mobile or SIP server. Your customers can then phone these numbers and you answer the calls using your normal phone.

We can supply:

• 01 and 02 numbers for every area code in the UK
• 03 numbers
• 080 (ie freephone) numbers
• 084 numbers
• 087 numbers
• 09 numbers

There are a range of routing options as listed below. It is possible to combine multiple features in order to build the solution you want:

• redirecting directly to another phone number (with optional extension to navigate a remote IVR)
• redirecting to a SIP address - can include SIP authentication
• huntgroups (called routeplans) - routing to multiple destinations (several modes of operation)
• time of day routing (called day parting) - route to different places depending on day and time
• IVR menus - present a list of options for callers to choose
• voicemail - record a message and (optionally) have it emailed to you
• fax to email - set up a number as a fax number and have faxes emailed to you as TIFF or PDF files
• an outgoing announcement - play a sound to the caller and then hang up
• 2 stage IDA (use one of your numbers to call out while presenting a different phone number)

Optional in-call features include:

• call recording (mono and stereo) with in-call pause/resume and optional email option
• mid-call transfer - divert the caller to someone else or confer with a colleague whilst the caller is on hold
• tones - ringing music / generate local ringing tone
• whispers - play sounds to the caller and called party
• dialled number as callerID - helps you see when people are calling via your alternative numbers
• realtime routing via an HTTP/HTTPS POST to query the destination
• end of call IVR - useful for conducting an after-call survey
• audio - adjust audio volume
• webhooks - push call events in real time to your HTTP/HTTPS endpoint
• callee verify - useful with huntgroups to prevent a mobile’s voicemail grabbing the call

API Concepts

Many of the routing options involve the creation of an object (eg a huntgroup/routeplan) and then changing the routing of a phone number to point to that object.

For example, if we are providing you with an 0330 number and you want calls to that to ring your landline for 10 seconds and if unanswered then divert to your mobile, you would

• create a routeplan with the two destination numbers and a 10 second timeout on the first one; the API will return a routeplanID
• call telecoms_num_route to redirect your 0330 number to the appropriate routeplanID

A selection of the routing features can route to other routing features, allowing you to combine the functionality of each. For example, you can set up day parting to send calls directly to a single number at certain times of the day/week, a routeplan at other times, an IVR menu at different times and outside of that, go to voicemail.

There is no limit to how many of your numbers you can route to the same IVR, routeplan, day parting etc.

How it fits together (ie what can point to what)

Phone numbers that we supply can be configured to point to any of the routing features, but several of the routing features can point to other routing features, namely:

• huntgroups
• time of day routing
• IVR menus

Routeplans can point to:

• destination phone numbers (with optional extensions)
• destination SIP addresses
• voicemail
• announcements
• time of day routing
• IVR menus

Day partings can point to:

• destination phone numbers (with optional extensions)
• huntgroups
• voicemail

IVR menus can (when the caller selects an option) point to:

• destination phone numbers (with optional extensions)
• destination SIP addresses
• huntgroups
• time of day routing
• voicemail
• announcement
• force hangup
• another IVR menu (eg for a sub-menu, go back to previous or repeat the current menu)