From Askozia Handbook
Jump to: navigation, search

The services of AskoziaPBX include missed call notifications, voicemail, conferencing, fax archive and phone book. How to configure them, is explained in this chapter.


To receive notifications for missed calls and voicemail via e-mail you need to configure an SMTP-Client. SMTP (Simple Mail Transfer Protocol) is used to send e-mails via the Internet. SMTP clients communicate with a SMTP server which sends the e-mails. An e-mail address is required for the configuration.

The host name of the server usually follows the scheme: smtp.serverName.countryID. By default port 25 is used. Optionally, a different port can be specified in the text box right of the host address (common when using encrypted e-mail access). The other information needed for authentication like E-Mail Address, Username and Password you have received when setting up your e-mail address. If you are doing this for a company, simply ask your system administrator for this information.

For most e-mail servers auto should be the right authentication method. If authentication with auto fails, other methods are available. These are PLAIN (Username and password are transferred unencrypted), LOGIN (like PLAIN, username and password are transferred separately though), CRAM-MD5 (using RFC 2195 for authentication), external (the authentication takes place outside of the SMTP protocol usually using TLS). For encryption TLS (Transport Layer Security) and SMTPS are available. You can disable certificate checking because some servers may not be included in AskoziaPBX's database causing authentication to fail.

SMTP-Client configuration

After entering the SMTP information, it is recommended to use the test e-mail function to check the correctness of the entries. Enter your e-mail address in the text box below and click on e-mail me. Now you should have an e-mail in your mailbox which tells you about the status. In case the test e-mail did not reach you, double check your SMTP settings.

Test succesfull

Click Save to finish the configuration.


In this section, the global configuration for all mailboxes is explained. If you would like to activate or deactivate a mailbox for a specific phone go to the Call Notifications and Voicemail section of the respective phone account.

Notification e-mails can also be personalized. From Address is by default the same e-mail address which was also used for the configuration of the SMTP client in Notifications. If you would like to have a different sender's e-mail address be displayed in notification e-mails enter the address in the text box. The language for notification e-mails can also be adjusted. More than 20 languages are currently available.

Standard voicemail notifications

To create a customized notification text, check User defined e-mail text. Two additional text boxes for Subject and e-mail Body will appear in the menu.

User-defined voicemail notifications

You can use different variables for your e-mail text. The spelling of the variables is essential because if spelled incorrectly they simply do not work. The following variables are available:

  • VM_MAILBOX - extension of voicemail box
  • VM_NAME - name of voicemail recipient
  • VM_DURATION - duration of the message
  • VM_CALLERID - caller ID of the person leaving the message
  • VM_DATE - date and time, the following scheme is used: year-month-day(time)

Missed Calls

At this point a notification for missed calls can be set.

Settings for missed calls

Like in the settings for voicemail notifications you can use the variables, shown in the picture.

  • With From you can decline the sender´s adress
  • Use Subject to personalize your subject line


Here you can setup the notifications for incoming Faxes.

Settings for fax notifications

For the notifications for incoming faxes you can also use the variables, like shown in the picture.

  • With From you can decline the sender´s adress
  • Use Subject to personalize your subject line

Click Save to finish the configuration.


Click on Conferencing in the menu bar to edit or add a conference room.

By default, one conference room is already available under the extension 2663. It can be made available from the outside in the provider account settings. Further conference rooms can be added by clicking on Askozia add.png.

Overview of conference rooms

Adding a new conference room requires a Room Number . This is the extension under which the conference room is available. Additionally, a PIN (personal identification number) can be assigned. In this case, every participant is asked to enter the PIN when entering the conference room. Conference rooms, which have a PIN are marked with a Askozia lock.png in the overview.

A conference room can be configured for public access via the Internet. Check allow this number to be reachable over the Internet. You can also use an optional alias.

Conference room settings

Name Announcement activates an announcement, played whenever a user joins or leaves the conference room. When entering the conference room, users are asked to say their name and to confirm the recording with the #-key. Afterwards the recording can be replayed, recorded again or accepted. After the recording is accepted, the name of the new conference participant is played to the other users. Leaves the user the conference room, the announcement is also played.

Talker detection signalises Call Control CTI users which conference participant is speaking.

Talker optimisation improves the conference quality and reduces transcoding overhead by muting participants who are currently not speaking.

Click Save to finish the configuration.

Call Recording Archive

The Call Recording Archive is available when automatic call recording is activated under Advanced/Call Recording.

Call Recording Archive

The call recording archive shows all recorded calls. It states date, time, source extension, target extension, callerIDs and length of the recording. To listen to recordings or download them click on Askozia save.png, click on Askozia delete.png to delete recordings.

Use the drop-down menus Extension, Call Duration, Filter and Period to select search criteria for recordings. Click on Filter to update the recording list. Download archive allows you to download the archive as a ZIP file. Empty call recording archive deletes the entire archive.

Fax Archive

All virtual faxes received are sent to the recipient via e-mail but also stored in the Fax Archive. You can download all faxes in the archive or delete them with Askozia delete.png.

Fax Archive

Phone Book

AskoziaPBX supports different kinds of phone books, in particular internal LDAP, external LDAP, and simple XML.

LDAP stands for Lightweight Directory Access Protocol. LDAP or a directory server usually provides a central address or phone book to clients, IP phones in particular, within a network.

The following subsections introduce the different kinds of phone books supported by AskoziaPBX.

Internal LDAP

Askozia allows to set up a phone book by means of an internal LDAP server running within the PBX. The internal LDAP server is much faster than Simple XML and supports a variety of phone books. The following video introduces the internal LDAP server.

The following video shows how the resulting phone book appears on a variety of IP phones supported by AskoziaPBX.

Select internal LDAP for setting up a phone book using the internal LDAP server of AskoziaPBX.

Internal LDAP selection

For internal LDAP servers, its Settings are only provided as reference and can not be changed manually. Anonymous access to the internal LDAP server is also not possible.

  • Host: IP of the internal LDAP server.
  • Port: Port of the internal LDAP server.
  • Base: The node in LDAP where all phone book entries are connect to.
  • User: The node in LDAP where the user is connected to, which has read-only access to the LDAP
    • cn: common name
  • Password: The user password that is sent to the phones. Phones, or anyone who requires read-only access to Askozia’s internal LDAP, need to log in with the user name and password.
  • Common name: The common name, cn, is to enter in the phone settings. The common name is a concatenation of first name, name and company (company in brackets if specified)
  • Name attributes: givenName surname cn
    • givenName: first Name
    • surname: last Name
  • Number attributes: telephonenumber mobile homePhone
    • telephonenumber: work number
    • mobile: mobile number
    • homePhone: home number
  • Relevant auto-configured values:
    • Number Filter: (&(objectClass=person)(cn=%))
    • Name Filter: (&(objectClass=person)(|(mobile=%)(homePhone=%)(telephoneNumber=%)))
    • Display Name: %cn
Internal LDAP settings (read-only)

Changes are only accepted and saved through the CSV file. If changes are made through an LDAP client, these changes are lost when you restart the system or click on Save as the LDAP server is rebuilt each time from the CSV file.

Click on Upload CSV to upload a CSV file containing only the contact data in the specified format. The header is added automatically and not to be included in the CSV file. Each entry can include multiple numbers and needs to be entered in the following format.


Under CSV phonebook file, the CSV file can be downloaded and edited by clicking on Download, or deleted by clicking on Delete.

Under Contacts, all entries of the CSV file are displayed.

Internal LDAP, CSV management

External LDAP

To use the LDAP integration of AskoziaPBX, complete the following settings.

  • Host: is the IP address and the port of the LDAP server.
  • User: Enter user name. Leave this field empty if an authentication isn't required. (e.g. 'cn=admin,dc=example,dc=com')
  • Passwort: Enter password, if required.
  • Authentication: Authentication method used for login. The drop down menu offers none, simple and digest-md5.
  • Base: The name of the base object entry relative to which the search is to be performed. E.g. 'ou=Addressbooks, o=sampledomain. In this case, search begins at the group Addressbooks in sample domain.
  • Scope: A search scope defines how deep to search within the search base.
    • Base Level - indicates a search of the base object only.
    • One level - indicates a search of objects immediately subordinate to the base object, but does not include the base object itself.
    • Subtree level - indicates a search of the base object and the entire subtree of which the base object distinguished name is the topmost object.
  • Number Filter: Defines in which fields the search should be started first. Search filter (default: '(&(objectClass=person)(telephoneNumber=%))')

% will be replaced with the incoming Caller ID.

  • Name Filter: Search filter (default: '(&(objectClass=person)(cn=%))') % will be replaced with the name.

(|(givenName=%)(sn=%)) ->all entered keys are searched in givenName" or in "sn".

  • LDAP Common Name Definiert den Namen des Datenbankfeldes auf dem LDAP-Server, welches den Rufnamen enthält.
  • LDAP First Name The field (on LDAP side) which includes the first name (e.g. 'cn').
  • LDAP Last Name The field (on LDAP side) which includes the Caller ID name (e.g. 'sn').
  • LDAP Number The field (on LDAP side) which includes the Caller ID name (e.g. 'telephoneNumber').
  • CallerID: User LDAP for incoming Caller ID substitution. The incoming Caller Name will be replaced with the Name in the LDAP directory if a number matches.
  • Phonebook: The LDAP configuration will be used for provisioned phones. They will be able to search within the LDAP directory.
Working configurations

Simple XML

A XML files is used to create a phone book.

Askozia automatically sends all entries of the phone book to the VoIP phones which are registered with Askozia. Clicking on Askozia add.png adds a new entry. With Askozia delete.png, entries can be deleted. Clicking on Askozia edit.png allows configuration for each entry.

Phone book
Phone book entry

It's possible to upload CSV-files as phone book entries. For this, data have to be entered in the CSV-file with the following format "Number1;Name1".

Upload CSV-files