Nokia OTA configuration API
Introduction
Configuration of VoIP settings on mobile devices is a barrier to take-up of VoIP services on mobiles. aql has six years of experience in over the air (OTA) configuration of Nokia handsets, and our Nokia OTA configuration API will give you the tools to manage this service.
Simple OTA for Nokia devices
OTA – Setup Simplicity
aql can provide a simple programmatic API and an autoresponder keyword on our highly memorable shortcode 64446. Users texting this keyword will receive your VoIP account setup details. Each configuration message is charged at the rate of six text message credits at our premium (UK) message rate. For more information on our text messaging services, please see aql.com, or contact us to discuss in more detail.
Further Information
Use an HTTP request to generate and send a custom over the air VoIP configuration message.
Specify your OTA message and send it using HTTP POST.
Our system will create the OTA message and transmit it to its destination. This API has been tested to work with the following handsets:
- Nokia E60
- Nokia E61
- Nokia E70
- Nokia N80i
More recent Nokia handsets should also function as per expected, though these have not been tested extensively by aql.
Example implementation as an HTML form
Parameter | Notes |
---|---|
faxnumber | The Fax Number in international form (e.g. 441133203040) |
name | The “Friendly Name” to associate with the fax number |
The email address to associate with the fax number | |
format | The file format to be used when emailing faxes [pdf|tif] |
Your HTTP post request should be made to
http://gw1.aql.com/ota-config/index.php
<form action=http://gw1.aql.com/ota-config/index.php method=post>
<table>
<tr>
<td>Username</td>
<td><input type=text name=strUser length=12 maxlength=12 value=”></td>
</tr>
<tr>
<td>Password</td>
<td><input type=password name=strPass length=12 maxlength=12 value=”></td>
</tr>
<tr>
<td>Repeat password</td>
<td><input type=password name=strPass2 length=12 maxlength=12 value=”></td>
</tr>
<tr>
<td>Host name</td>
<td><input type=text name=strHostname value=”></td>
</tr>
<tr>
<td>VoIP number</td>
<td><input type=text name=strVoipNumber value=”></td>
</tr>
<tr>
<td>VoIP password</td>
<td><input type=text name=strVoipPass value=”></td>
</tr>
<tr>
<td>Mobile number<br></td>
<td><input type=text name=strMobileNumber value=’447′></td>
</tr>
<tr>
<td>SIP proxy address</td>
<td><input type=text name=strProxy value=’sip.aql.com’></td>
</tr>
<tr>
<td>SIP proxy port</td>
<td><input type=text name=strProxyPort value=’1234′></td>
</tr>
<tr>
<td>SIP proxy type</td>
<td><input type=radio name=tcp_proxy value=true checked=checked>TCP<br
<input type=radio name=tcp_proxy value=false>UDP</td>
</tr>
<tr>
<td>SIP URI</td>
<td><input type=text name=strURI value=’sip.aql.com:5060;transport=UDP’></td>
</tr>
<tr>
<td>Profile name</td> aql.com Powering a connected society 01133 20 30 40
<td><input type=text name=strProfileName value=’VoIP’></td>
</tr>
<tr>
<td> </td>
<td><input type=submit name=submit label=go></td>
</tr>
</table>
</form>
HTTP post request data format
Parameter | Type | Required | Length | Description |
---|---|---|---|---|
strUser | Alphanumeric | Yes | Your reseller account username. Also used as the originator of the configuration message | |
strPass | Alphanumeric | Yes | Your reseller account password | |
strPass2 | Alphanumeric | Yes | Your reseller account password | |
strHostname | Alphanumeric | Yes | sip.aql.com | |
strVoipNumber | Alphanumeric | Yes | Your six-digit VoIP number (e.g. 604111) | |
strVoipPass | Alphanumeric | Yes | Your VoIP password (604111-password-ab123) | |
strMobileNumber | Alphanumeric | Yes | 447987654321 | |
strProxy | Alphanumeric | Yes | sip.aql.com | |
strProxyPort | Alphanumeric | Yes | 5056 | |
tcp_proxy | Alphanumeric | Yes | Proxy transport type (TCP or UDP) | |
strURI | Alphanumeric | Yes | Registrar hostname[:Registrar port number][;transport=Registrar transport type] | |
strProfileName | Alphanumeric | Yes | Profile title (e.g. VoiceOverIP) |
Confirming settings on a Nokia E60 handset
Phone setting | Source variable |
---|---|
Profile name | $strProfileName |
Service profile | IETF |
Default access point | Choose from the access points that you have defined |
Public user name | sip:$strVoipNumber@$strHostname |
Use compression | No |
Registration | When needed |
Use security | No |
Proxy server
Phone setting | Source variable |
---|---|
Proxy server address | sip:$strProxyAddress |
Realm | $strHostname |
User name | $strVoipNumber |
Password | $strVoipPass |
Allow loose routing | No |
Transport type | $tcp_proxy |
Port | $strProxyPort |
Registrar server
Phone setting | Source variable |
---|---|
Registrar serv.addr. | $strURI |
Realm | $strHostname |
User name | $strVoipNumber |
Password | $strVoipPass |
Transport type | can be defined in $strSIPURI, defaults to 5060 |
Port | can be defined in $strSIPURI, defaults to UDP |