Digium A-Series Phones provide a Contacts application that allows searching and dialing from a list of parties. Â On the phone, the application supports both locally added contacts as well as remote lists of contacts. This page focuses on the use of remote lists of contacts.
You may also wish to visit the A-Series IP Phones for Asterisk Overview for additional information and links to related articles.​
Loading a Contact List
Remote retrieval, as a part of the phone's configuration file, is controlled with the AUTOUPDATE CONFIG MODULE configuration section with the Auto Pbook Url configuration parameter, e.g.:
Â
Configuration Example <<VOIP CONFIG FILE>>Version:2.0000000000
   Â
<AUTOUPDATE CONFIG MODULE>
Auto Pbook Url    :http://server.example.com/phoneprov/phonebook.xml
<<END OF FILE>>
  |
|---|
Configuration Example <<VOIP CONFIG FILE>>Version:2.0000000000
   Â
<AUTOUPDATE CONFIG MODULE>
Auto Pbook Url    :http://server.example.com/phoneprov/phonebook.xml
<<END OF FILE>>
  |
|---|
Contacts XML skeleton
A basic Contacts XML structure is defined below. Please note that Contacts are constructed in XML therefore the syntax must be validated before uploading into the phones. Digium phones do not point out XML errors if you uploaded a contact file and the phone is not showing them up, most likely there is a invalid entry. Please use an XML editor or other tool to confirm the syntax.Â
 Â
Contact XML Structure  <?xml version="1.0" encoding="UTF-8"?>
<AsteriskIPPhoneDirectory>
    <DirectoryEntry>
        <Name></Name>
        <Telephone></Telephone>
        <Mobile></Mobile>
        <Other></Other>
        <Ring></Ring>
    </DirectoryEntry>
</AsteriskIPPhoneDirectory>
  |
|---|
Contact XML Structure  <?xml version="1.0" encoding="UTF-8"?>
<AsteriskIPPhoneDirectory>
    <DirectoryEntry>
        <Name></Name>
        <Telephone></Telephone>
        <Mobile></Mobile>
        <Other></Other>
        <Ring></Ring>
    </DirectoryEntry>
</AsteriskIPPhoneDirectory>
  |
|---|
Here is a contact XML exampleÂ
Â
Contact XML Example  <?xml version="1.0" encoding="UTF-8"?>
<AsteriskIPPhoneDirectory>
    <DirectoryEntry>
        <Name>Bob Jones</Name>
        <Telephone>2564286000</Telephone>
        <Mobile>2565558000</Mobile>
        <Other>8005551234</Other>
        <Ring>1</Ring>
    </DirectoryEntry>
    <DirectoryEntry>
        <Name>Susan Smith</Name>
        <Telephone>2564286100</Telephone>
    </DirectoryEntry>
</AsteriskIPPhoneDirectory>
  |
|---|
Contact XML Example  <?xml version="1.0" encoding="UTF-8"?>
<AsteriskIPPhoneDirectory>
    <DirectoryEntry>
        <Name>Bob Jones</Name>
        <Telephone>2564286000</Telephone>
        <Mobile>2565558000</Mobile>
        <Other>8005551234</Other>
        <Ring>1</Ring>
    </DirectoryEntry>
    <DirectoryEntry>
        <Name>Susan Smith</Name>
        <Telephone>2564286100</Telephone>
    </DirectoryEntry>
</AsteriskIPPhoneDirectory>
  |
|---|
Contact XML element definitionsÂ
| | |
|---|
Mobile | string | Specifies a mobile number to be dialed for this contact. |
Name | string | Specifies the name of the contact. |
Other | string | Specifies an additional, other number to be dialed for this contact. |
Ring | Integer, 1-9, Defaults to 2 | Sets the ringing type, from 1-9, of the phone for calls received from numbers matching this contact. Defaults to 2. |
Telephone | string | Specifies the number to be dialed for this contact. |
Â