Address Book
From Bizfon Wiki
Contents |
Purpose
The address book stores associations of numbers with names, speed dial entries and types.
Numbers are generally telephone numbers. The PBX does not support SIP URI numbers in the address book. Numbers may contain readability characters. The PBX internally converts the numbers into purified numbers, so that matches with other numbers become more easy and consistent. If your domain has selected a specific dial plan scheme (for example, North American dial plan), the PBX also internally automatically converts the number into a consistent presentation. If the PBX requires that a name must be presented as one string (for example, in the SIP display name), it will automatically put a space character between the first and the last name if both names are not empty.
Names consist of the first name and the last name. The purpose of this separation is to make searches easier; sometimes the user searches for first and sometimes for the last name. Otherwise the PBX treats the names transparently. Names should be encoded in UTF-8 format. The web browser usually performs the necessary conversations, so that the end user does not have to deal with this problem.
Speed Dial
The speed dial entry is a two-digit star code (for example, *12). The range should be in the lower feature code range, so that they do not overlap with the other feature codes that are available on the system. If there is an overlap, the speed dial numbers have a higher priority.
Speed dial numbers are useful if you want to store numbers that you are using frequently, especially if your telephone does not support an address book. Used in the domain mode, they also might be useful to hide the number that is being dialed (however, that kind of security is very weak).
Black List and White List
An address book entry also has a type flag. This flag can be set to "white", "black" or unset. If it is "white", that address book entry is on the white list, if it is black, it is on the black list. The white list usually contains the contacts that are trusted and therefore get a preferred treatment. The black list usually contains the list of contacts that are known and unwanted. For example, it makes sense to put a family member's number on the white list, while the caller-ID of an aggressive sales person might end up in the black list.
If that flag is set to "white", the number is part of the white list. That means, when a caller has the type "white", he will never be intercepted by the auto attendant to record the name.
Callers on the white list are allowed to receive a call back when the extension becomes available.
If a caller is on the black list, the behavior of the PBX depends on the settings of the user for anonymous call treatment. If the caller should be blocked, then the PBX will block that call. Otherwise the PBX will always ask the person to leave his name before calling the extension.
Callers on the black list will also no be allowed to camp on an extension.
Personal Address Book
The address book entries in the personal address book are only visible to the user.
To see the personal address book, you must be logged in as user in the web interface of the PBX. In this screen, you can edit and delete address book entries by clicking on the edit and delete button.
If you want to add an address book entry, you can manually add this entry from the web interface. You may also load a CSV-file into the system (see below).
You can also add a number to the address book by dialing the black list and white list star code. If the number does not exist, the PBX will automatically create an address book entry for this number.
Domain Address Book
The domain address book entries are visible to all members of the domain. That means they can search the domain address book and calls coming to that domain will automatically see the name of the calling party.
All names in a domain are automatically included in names searches in the domain.
You can also use the address book to indicate which DID number has been dialed. If you add an address book entry that matches the specific DID, the PBX will add the display name to the caller-ID, and the phone then can display the text associated with the caller-ID.
Address Book Import
Most address management programs support the export of a CSV (comma separated value) file. The PBX can read this format, if the below guidelines are kept.
- The field separator must be a semicolon.
- The first column must contain the first name; the second column must contain the last name.
- The third column must have the number. The number must have numeric characters. The characters "-", "(", ")", " " (space), "/" and "." are ignored and may be included for readability. The first character may be a '+', so that global telephone numbers may be used. For example, the numbers "(978) 543 6545" and "+49 (30) 386-12345" are valid numbers, while the text "WIRELESS CALLER 9785436534" is not a valid number.
- The fourth column may have a speed dial number. The number must contain a star character in the beginning. If the star code was already used by another entry, the PBX will clear the other star code entry during the import process.
- The text must be encoded in UTF-8 format.
Because the number must have numeric characters, it is ok if the first contains the field description. For example, most programs use a name like "Number" to identify the column, and because that name is not a phone number the system will not include that row in the address book.
The following example shows an address book that can be imported:
First Name;Last Name;Number;Speed Dial John;Doe;(555) 555 1212 Jane;Doe;(555) 555 1213;*12 Bill;Doe;(555) 555 1234;*14 "A;B;C";;(123) 543 3453
