Call Initiation Web Service API

Support
2016-08-29 11:12

Call Initiation Web Service

Tel2 offers customers a way to setup a phone call using a secure web service query.  This can be very useful for programmers/developers of custom applications or for call centres etc. who wish to initiate a phone call without having to dial a number through a traditional handset or phone system.

Essentially, the web service query allows any Tel2 customer to setup a call between 2 parties.  These parties can be Tel2 phone lines or they can be external phone numbers anywhere in the world.  The service works by first dialing the 'A Party' (or User) and then once that call is answered a 2nd call is then setup to the 'B Party' number and when answered the calls are bridged together.  Obviously the call will only be successful if the A Party picks up the call first.

The Tel2 account user that authenticates the call will be charged for the 2 legs of the call.  If one of those legs is to a Tel2 phone number then there will be no charge on that leg of the call.  If both legs of the call are to Tel2 phone numbers then both legs will be free of charge.  Tel2 only charges for calls that leave our network to other networks.

Usage:

URL:  https://now.tel2.co.uk/webservices/connectcall

Parameters:

user  -  Tel2 phone number/user that is initiating the call (e.g. 442034567890)
password  -  Tel2 password for that particular phone line (e.g. mypassword)
aparty  -   The phone number you wish to initiate the call from (as you would normally dial the number).  If the aparty is ommitted then the 'user' is used as the aparty number.
bparty  -   The phone number you wish to terminate the call to (as you would normally dial the number)

NOTES:
1. The user field *must* be a phone number in the normal login format Tel2 use such as 442034567890. Account numbers are not permitted and other number formats are not supported (such as 02034567890).
2. The password is that loaded against the phone line (not the account) - although the line may share the same password as the account if the line has not been given a serparate password.

3. The aparty and bparty phone numbers should be entered in the normal format you would use to dial a phone number from your handset (e.g. 02034567890 for a domestic UK call or 0012345678910 for an international call)

Examples:

1. Setting up a call between a UK Domestic number and an international number:

https://now.tel2.co.uk/webservices/connectcall?user=442039876543&password=mypassword&aparty=02034567890&bparty=0012345678910

2. Setting up a call between a Tel2 number where the user is the same as the A Party:

https://now.tel2.co.uk/webservices/connectcall?user=442039876543&password=mypassword&bparty=02034567890

If you have any further queries about this service then please contact our support team.

Average rating: 0 (0 Votes)

You cannot comment on this entry