How to add a phone book entry?

On your web site's Contact Us page, you probably want to provide an easy way for visitors to add your contact number into their Contacts list without quitting the browser. The Add Phone Book Entry WTAI URL allows you to do just that. The following link prompts a user to add the phone number +18001234567 as ABC Corp in their phone Contacts list :

        <6a7href="wtai://wp/ap;+18001234567;ABC Corp">
          Add our contact number
     77>

Adding a Contacts list entry from a web site

The complete syntax of the WTAI URL allows you to use a WML variable to capture the return status value of the operation. Table lists the possible return values.

wtai://wp/ap;[phone number];[contact name]![variable name]

Table The status codes after the Add Phone Book Entry operation

Status code	Description
0	Success
-1	Unspecified error
-100	The contact name parameter is too long or unacceptable
-101	The phone number is invalid
-102	The phone number is too long
-103	The phone entry cannot be written
-104	The phone book is full

The corresponding function in WMLScript is addPBEntry:

var flag = WTAPublic.addPBEntry ("+18001234567", "ABC Corp");

So far, I have covered the WTAI public library URLs and functions, which all Nokia devices support. Some phones might support extended WTAI libraries, which provide functions for call management, SMS texting, and more Contacts list operations. You need to check your phone manual and the Forum Nokia web site (http://forum.nokia.com) to find out exactly what WTAI calls are supported on your device.