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
email 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>&nbsp;</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