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

ParameterNotes
faxnumberThe Fax Number in international form (e.g. 441133203040)
nameThe “Friendly Name” to associate with the fax number
emailThe email address to associate with the fax number
formatThe 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

ParameterTypeRequiredLengthDescription
strUserAlphanumericYes Your reseller account username. Also used as the originator of the configuration message
strPassAlphanumericYes Your reseller account password
strPass2AlphanumericYes Your reseller account password
strHostnameAlphanumericYes sip.aql.com
strVoipNumberAlphanumericYes Your six-digit VoIP number (e.g. 604111)
strVoipPassAlphanumericYes Your VoIP password (604111-password-ab123)
strMobileNumberAlphanumericYes 447987654321
strProxyAlphanumericYes sip.aql.com
strProxyPortAlphanumericYes 5056
tcp_proxyAlphanumericYes Proxy transport type (TCP or UDP)
strURIAlphanumericYes Registrar hostname[:Registrar port number][;transport=Registrar transport type]
strProfileNameAlphanumericYes Profile title (e.g. VoiceOverIP)

Confirming settings on a Nokia E60 handset

Phone settingSource variable
Profile name$strProfileName
Service profileIETF
Default access pointChoose from the access points that you have defined
Public user namesip:$strVoipNumber@$strHostname
Use compressionNo
RegistrationWhen needed
Use securityNo

Proxy server

Phone settingSource variable
Proxy server addresssip:$strProxyAddress
Realm$strHostname
User name$strVoipNumber
Password$strVoipPass
Allow loose routingNo
Transport type$tcp_proxy
Port$strProxyPort

Registrar server

Phone settingSource variable
Registrar serv.addr.$strURI
Realm$strHostname
User name$strVoipNumber
Password$strVoipPass
Transport typecan be defined in $strSIPURI, defaults to 5060
Portcan be defined in $strSIPURI, defaults to UDP