NTS Telephony Function Reference

Sub-sections


End-user Functions

Number Allocation (end-user functions)

Functions for allocating and deallocating numbers to and from an account.

telecoms.num.browsefetch a list of sample numbers available for allocation (useful in conjunction with the shopping cart functions in the next section)
 
telecoms.num.reservation.listfetch a list of numbers that you have temporarily reserved but not yet subscribed to (allocated to an account)
 
telecoms.num.reserveput a temporary reservation on a number that is available for use (eg while building the contents of a shopping cart)
telecoms.num.unreserveremove the temporary reservation on a number (eg if removing a number from a shopping cart before checking out)

Number Allocation (shopping cart functions)

Functions for creating and managing a shopping cart for buying numbers and adding to your account.

telecoms.cart.checkoutComplete the purchase of items in the shopping cart; takes payment, raises invoice and adds numbers to your account in one call
telecoms.cart.createcreate a new empty shopping cart instance
telecoms.cart.deletedelete a shopping cart instance
telecoms.cart.editadd, remove or change things in your shopping cart
telecoms.cart.getfetch the detail of a shopping cart instance
telecoms.cart.listfetch a list of all current shopping cart instances

Number Validation functions

Functions for checking/testing the validity of remote phone numbers

telecoms.num.validatecheck whether a phone number is in a valid number range and optionally check whether routing to it as a destination is allowed
 
telecoms.ddi.checkcheck whether a phone number is in service (ie actually belongs to someone)
 
telecoms.telecaptcha.createcheck whether a phone number is in service and is owned/allocated to a specific person by calling them and exchanging a PIN

Misc functions

telecoms.num.svcopt.listList the service packages available on a number or number type

Number Routing

Manage the routing of your numbers.

telecoms.num.listlist your numbers and where they currently point
telecoms.num.routepoint a number somewhere (to another number, a route plan, a day parting, etc)
 
telecoms.num.note.addadd a short note to a number
 
telecoms.num.ref.deldelete the ref string for a number
telecoms.num.ref.setset a ref string for a number (max 45 chars); the cust ref string can optionally be fetched with the call data

Routeplans

Manage call hunt groups.

telecoms.routeplan.createcreate a route plan
telecoms.routeplan.deletedelete a route plan
telecoms.routeplan.editedit an existing route plan
telecoms.routeplan.listlist your route plans

Day Parting

Manage your time of day routing setup.

telecoms.dayparting.createcreate a new day parting
telecoms.dayparting.deletedelete a day parting
telecoms.dayparting.editedit an existing day parting
telecoms.dayparting.getfetch detail of a day parting
telecoms.dayparting.listlist your day partings

IVR Menus

Manage your IVR menus.

telecoms.ivr.createCreate an IVR menu
telecoms.ivr.deleteDelete an IVR menu
telecoms.ivr.editEdit an existing IVR menu
telecoms.ivr.getFetch the detail of a specific IVR menu
telecoms.ivr.listFetch a list of your IVR menus

Voicemail

Manage your voicemail mailboxes.

telecoms.voicemail.mailbox.createcreate a voicemail mailbox
telecoms.voicemail.mailbox.deletedelete a mailbox
telecoms.voicemail.mailbox.editedit a mailbox
telecoms.voicemail.mailbox.listlist your mailboxes

Sound files

Manage soundclips for use in in-call features.

telecoms.soundclip.createcreate (upload) a new soundclip for use with IVR, whispers (announcements) etc
telecoms.soundclip.deletedelete a soundclip
telecoms.soundclip.editchange a soundclip or its related attributes
telecoms.soundclip.getdownload a soundclip from the system
telecoms.soundclip.listlist your soundclips
 
telecoms.soundclip.roletype.listlist the roles available for use with soundclips

In Call Features

Manage in call features such as call recording, whispers, caller announcements etc.

telecoms.facility.attr.deldelete a facility attribute
telecoms.facility.attr.listlists attributes applicable to a facility (eg for announcements, an attribute defines which announcement is tied to a number)
telecoms.facility.attr.setset a facility attribute
 
telecoms.facility.attr.type.listlist facility attribute types

In Call Features (enabling / disabling)

Manage the facilities available on a number or account; facilies are required for the in-call features to work.

telecoms.facility.cancelcancel a facility (a facility being mobile routing, day parting, voicemail, etc)
telecoms.facility.checkchecks what facilities are available on a specific number
telecoms.facility.listallallows you to list all facility types available
telecoms.facility.listlists your facilities

CDRs / Call Data

telecoms.calldata.totals.getfetch call usage totals
 
telecoms.calldata.detail.getfetch call detail
 
telecoms.callrec.deletedelete a call recording

Call Rates and Breakout Information

telecoms.rates.ingressget ingress rates for calls in to particular number types
telecoms.rates.egressget egress rates for a given destination number
 
telecoms.location.egress.listreturns a list of different egress types/locations
 
telecoms.location.infoget info on a location (eg you give it a number and it tells you it's a french mobile, etc)

Advanced Call Stat Analysis

For summarising call patterns, call centre performance etc.

telecoms.calldata.cliprofile.generatefor advanced stats (feature not currrently available via skycom site but the API calls are available)
 
telecoms.calldata.cliprofile.selgroup.createcreate a selector group for advanced stats
telecoms.calldata.cliprofile.selgroup.deletedelete a selector group
telecoms.calldata.cliprofile.selgroup.editedit a selector group
telecoms.calldata.cliprofile.selgroup.getget the detail of a selector group
telecoms.calldata.cliprofile.selgroup.listlist your selector group

Number Range Management (for registered telcos only)

telecoms.numrange.editedit characteristics of number ranges
telecoms.numrange.listlist the number ranges an account owns

Supplier Functions

Number Allocation (for suppliers)

Functions for allocating and deallocating numbers to and from an account.

telecoms.num.allocadd a number to your account or sub-account (will only let you do this if you have your own Ofcom-supplied number ranges registered on our system)
telecoms.num.deallocremove a number from your account or sub-account (will only let you do this if the number you are removing is in one of your own Ofcom-supplied number ranges registered on our system)
telecoms.num.editchange how a number is allocated to an account (change package, service type, supported inbound transport types)
telecoms.num.resumeundo the suspension of a number
telecoms.num.suspendsuspend a number; this stops a number from working, stops the end user from being able to do anything with it and stops any further standing charges

Number Allocation (shopping cart functions)

Functions for creating and managing a shopping cart for buying numbers and adding to your account.

telecoms.cart.assignassigns a current un-checked-out shopping cart from your master account to a customer account to allow the checkout process to be completed by the newly signed up customer