User Manual

Last updated: May 30, 2019

Online management and logging in

You can find Compass at www.apollo.compass-stack.com.

You need to enter your username and password and press ‘Log on’ to enter the site.

My settings

Here you find information about your settings and the availability of the phone.

Personal information

Here you can adjust your password and email address.

Phone

Here you can find which phone you are currently logged on to and see which extensions and external numbers are associated with your account. If you have write permissions to the company, you are also able to change the phone you are logged on to.

The voicemail section will tell you if you have any messages waiting in your voicemail boxes.

You are able to reach the voicemail box by phone by doing either:

  • Call 1233 with a logged on user and enter the PIN code when prompted
  • Call the phone number for which the voicemail box is set, press * during the welcome message and enter the PIN code when prompted

The structure of the voicemail menu is as follows:

  • Main menu - You have X new and Y old messages. If there are any messages, they are played. If not, the settings menu is played.
  • During playback of a message you have the following choices:
    • 2 Pause
    • 4 Rewind message 5 seconds
    • 5 Replay message
    • 6 Fast forward message 5 seconds
    • * Message menu
  • After playing a message the message menu plays. Here you have the following choices:
    • 4 Previous message
    • 5 Repeat message
    • 6 Next message
    • 8 Delete message
    • 9 To settings menu
    • * Help
    • # Main menu
  • These are the choices in the settings menu:
    • 1 Play welcome message
    • 2 Record welcome message
    • 5 Change PIN code
    • * Main menu

Call forwarding

Here you can manage forwarding of incoming calls, e.g. forward immediately (Always), when you are busy (Busy), could not answer the phone (No Answer) or are not reachable (Unavailable). By setting the ring time you decide how long the phone rings before following the No Answer call forward. Checking the CLI transparent box will display the original caller ID at the destination, instead of the caller ID of the forwarding party.

Dial plan switches

This list contains up to 10 dial plan switches present in your company. If there are more, you can click through to the overview page. Next to the switch is a pencil icon, which allows you to change the setting of the dial plan switch.

Queues

Here you can find the queues to which you have been added, e.g. the type of phone calls you can expect (for example sales or support).

Service codes

You can change your telephony settings by dialling service codes. Service codes always start with an asterisk (*), followed by the desired service code and followed by the settings, depending on the requested service code. You can also configure these service codes as speed dials with the function keys of your phone, if programming function keys is supported for your type of phone. Below you can find the currently implemented service codes and their explanation.

*1: Log on and log off from your phone

By dialling *1, you can log on to your phone. If you were not logged on, you will hear a voice, asking you to enter your extension, followed by the pound key (#). If you have configured a PIN code for your extension, you will be requested to enter the code as well. If the PIN code is correct, you will hear a voice indicating you have been logged on.

If a PIN code is not configured for your extension, you will not be asked for it either. When the entered extension is known within your company, a voice will directly tell you you have been logged on.

Whenever you enter an invalid extension, you will be informed of this and the phone will be hung up immediately. If you enter a correct extension, but an invalid PIN code, you may retry your PIN code up to two times. Therefore, if you enter an invalid PIN code three times in a row, the phone will be hung up.

If you were already logged on to the phone and dial *1, you will be logged off of your phone. This will also be indicated by the voice, saying “goodbye”.

*48: Log in and log out from a queue

You can dial a service code, starting with *48, to log in or log out from a queue within your company. The service code has to be followed by another asterisk and the queue short code. This queue short code can be configured by your administrator.

By default, when you log in to a queue, your identity will be configured in a way that your personal call forwards will not be followed in case you receive a call from the queue. Next to that, your identity will have priority 1 in the queue. This implies that your phone will ring immediately, according to the queue strategy, when an outside caller enters the specified queue.

It is possible to change these default settings by appending more parameters when dialling the service code. All parameters are separated by asterisks (*). As mentioned, the first setting is mandatory and is the queue short code. The second setting is optional and is used to indicate whether your personal call forwards should be followed. A one (1) tells to follow them, a zero (0) lets the platform know you do not want your forwards to be followed.

With the last setting, you can control with which priority you will enter the queue. This priority can be either 1, 2 or 3. The priority indicates the amount of use of the queue that should be reached, before incoming calls will be attempted to be delivered on your phone.

The optional settings can only be configured when you are currently logged out from the queue. If you pass extra settings whilst you are already logged in to the queue, you will be logged out from the queue. The extra settings will be ignored.

Below are a few examples to clarify the use of *48:

*48*8 If you are logged on to the queue with short code 8, you will be logged off. If you are not currently a member of the queue, you will be added to it with priority 1 and have your personal call forwards disabled if you receive calls from this queue.

*48*2*1 Log in to the queue with short code 2 with priority 1. Your personal forwards will be followed when you receive calls from that queue.

*48*4*0*2 Log in to the queue with short code 4 with priority 2. Your personal call forwards will not be followed.

*49: Queue pause

If you temporarily don’t want to receive any calls from a queue, it is possible to ’pause’ that particular queue. You will remain a member, but no new calls will be offered to your phone. It is possible to pause multiple queues at the same time.

Pause is activated by dialling a service code, starting with *49, followed by another * and a queue short code. This sequence will mark you as paused in the corresponding queue. If you are already paused in the corresponding queue, this sequence will unpause you for the corresponding queue. If you dial *49 without a short code, you will be unpaused in all queues you are a member of.

*49*8 Pause queue with short code 8. Your identity will no longer receive new calls from the queue.

*49*27 Pause queue with short code 27.

*49*27 When you dial the same service code again, you will be unpaused in this queue. If there are any callers waiting you will receive new calls within seconds.

*49 Unpause all queues.

*55: Set dial plan switch

In order to set or check the status of a dial plan switch you can dial a service code starting with *55. This code needs to be followed by * and the number of the dial plan switch, then another * and the setting of the switch. The number of the switch and the possible settings can be configured by your administrator, who is also capable of configuring a quick dial on your phone. Here are a few examples in order to provide some clarification:

*55*9 When dialling dial plan switch 9, a prompt will identify the current setting of switch 9. This setting is a number.

*55*9*(number between 0 and 9) Change the setting of the dial plan switch to the entered number. Choose 0 for setting 10. Your administrator can configure the dial plan for each individual setting.

*8: Pickup of a call coming in on another phone

When the phone of a colleague within your company is ringing, you are able to take over the call and pick up on your own phone. There are two ways of doing this:

*8(extension of ringing phone) This is to take over the call from the ringing phone. There is an instant connection with the caller.

*8 This is to take over a random call within your company. This option is useful when you are not sure which phone exactly is ringing. When multiple phones are ringing, a random call is picked up.

It is possible the administrator of your organisation has limited the use of call pickup. If this is the case, you are only able to pick up certain calls: calls that are coming in with users that are in the same group as you.

XMPP chat

For connecting to XMPP chat you can use any XMPP client.

Clients

Desktop clients:

Mobile clients:

For more clients we suggest having a look at xmpp.org/software/clients.html

Configuration

Please use these settings to set up your XMPP client:

If only a username and a password is requested and there is no separate XMPP server input field, use a so called user address, Jabber ID or JID:

  • Username/JID: your-username@uc.apollo.compass-stack.com
  • Password: your-password

If username and hostname are separate input fields:

  • Username: your-username
  • Hostname / XMPP server: uc.apollo.compass-stack.com
  • Password: your-password

If your organisation makes use of a company domain (your username looks like ‘user@example.com’ instead of ‘user@uc.apollo.compass-stack.com’), you might need to set a Connect Server in your client’s settings:

  • Connect Server: uc.apollo.compass-stack.com

Note: after 20 incorrect login attempts, the source IP address will be blocked from logging in to XMPP for 10 minutes.

Warning: in organisations with many users (hundreds or more) the contact list might not contain all contacts because of a platform limitation.

Administrator Manual

Online Management and Login

You can find Compass at apollo.compass-stack.com.

You need to enter your username and password and press Login to enter the site.

User Levels

There are several levels which vary according to the user’s rights and the availability of the buttons. These levels are described below.

  1. End-user: This shows the options My settings and Log out. You can adjust personal settings, see which phone is available and manage forwarding and queue settings.
  2. Organisation manager: You can manage everything within your own organisation.
  3. Reseller: You have an extra button named Organisations. Here you can select the organisation you want to manage, and use the menu Manage to adjust as needed.
  4. Root Reseller: You are able to manage all resellers.

Quick Start Guide

This quick start guide will show how to set up a new company. For a more extensive guide, including images, see the manual.

Add an Organisation

  1. Click ‘Organisations’.
  2. Select your reseller account.
  3. Click ‘Add company’.
  4. Enter the name of the organisation.
  5. Enter the short name that has been given to you. It is very important that the correct name is entered here, it cannot be changed after you click ‘Save’! The SIP domain should complete automatically. If it doesn’t please paste the short name in front of the URL. Choose the language. Click ‘Save’.
  6. The new company had been added.

Organising a Company

To be able to function a company needs at least the following elements:

  1. A User
  2. A Phone
  3. An External number
  4. An Extension
  5. A Dial plan

Add an External Number

Adding an external number is the first step. You will need an external number to enter at the next step, add a new user.

  1. Go to ‘Manage’, ‘Dial plan’, ‘External numbers’.
  2. Click ‘Add external number’.
  3. Enter the external number, description and Name shown at outbound call. Click ‘Save’.
  4. The new external number had been added.

Add a User

  1. Go to ‘Manage, ‘Users’, ‘Users’.
  2. Click ‘Add user’.
  3. Enter the data, if you also enter an Extension here, it will be automatically added. Click ‘Save’.
  4. The new user has been added.

Add a Telephone

  1. Go to ‘Manage’, ‘Phones’.
  2. Choose ‘Add phone’.
  3. Choose the Phone Model, and enter the required data. Click ‘Save’.
  4. The new telephone has been added.

Add an Extension

If a user hasn’t been given an extension when he or she was added, you can enter one here.

  1. Go to ‘Manage’, ‘Dial plan’, ‘Extensions’.
  2. Click ‘Add extension’.
  3. Enter the extension and description. Click ‘Save’.
  4. The new extension has been added.

Enter a Dial plan

Please enter a very simple dial plan at first, for example, call > user. Try to call to +3185-7739999 and also execute an incoming test call. If this doesn’t work, find out where the error lies. If this does work, you can enter a more extensive dial plan. Dial plans can be entered for both extensions and external numbers. This example features an external number.

  1. Go to ‘Manage’, ‘Dial plan’, ‘External numbers’.
  2. Choose the number you want to add a dial plan to.
  3. Enter the desired elements, for example, time-based routing, users, voice prompts or an IVR menu. You can find these elements (if they have been added before) at the right below ‘Elements’.
  4. Save the dial plan by clicking on the Save button, in the top right corner of the dial plan canvas.
  5. The dial plan has been added.

Organisations and Resellers

Only resellers can see and use the ‘Organisations’ button. It shows the list of organisations which are placed under your Reseller account.

Click on an organisation. The Manage organisation page will now show. You can manage this organisation using the Management menu. The name of the currently managed organisation will be mentioned on the left of the top menu bar.

Add an Organisation

By selecting a reseller you have write permissions to in the Organisations overview, you can add an organisation. Click Add company to go to the Add organisation page.

  • Organisation name: Enter the full name of the company
  • Short name: Enter an abbreviated or descriptive name for the company, this will for example be used as the identification for this company on phones when logged on. This name can only contain lower case letters, digits and can be between 2 and 12 characters long. Be aware that the short name can not be edited after saving.
  • Select language: A default language can be set for the company
  • Domain name: It is possible to use your company’s domain name to log in. This means usernames would look like “user@yourdomain.com”. Ownership of the domain will have to be confirmed by adding a DNS entry. This field can also be left empty.

When finished click Save.

You can add an organisation by clicking Add company. Enter the full and abbreviated name of the company. The latter should be between 2 and 12 characters long and can only contain the lowercase letters A through Z and digits. Leave the SIP domain as is. Also, select the desired default language of the new company. Finally, click Save.

Note: if you were managing another company, you should first reselect your reseller from the Organisations menu. Otherwise, you will remain at the organisation level and the option Add company will not be shown.

In order to configure a domain (example: example-domain.ext) for a Compass organisation, the following has to be set:

Host Type Priority TTL* Value (weight, port, server)
_xmpp-server._tcp.example-domain.ext SRV 100 7200 33 5269 xmpp1.apollo.compass-stack.com
_xmpp-server._tcp.example-domain.ext SRV 100 7200 33 5269 xmpp2.apollo.compass-stack.com
_xmpp-server._tcp.example-domain.ext SRV 100 7200 33 5269 xmpp3.apollo.compass-stack.com
_xmpp-client._tcp.example-domain.ext SRV 100 7200 33 5222 xmpp1.apollo.compass-stack.com
_xmpp-client._tcp.example-domain.ext SRV 100 7200 33 5222 xmpp2.apollo.compass-stack.com
_xmpp-client._tcp.example-domain.ext SRV 100 7200 33 5222 xmpp3.apollo.compass-stack.com

* You may choose your own TTL, 7200 is a safe default.

Summarizing, the end user must set:

  • 6 SRV records in total on their domain with equal priority (100) and weight (33) to hosts xmpp1, xmpp2 and xmpp3 on apollo.compass-stack.com.
  • The first 3 records in the table above are for server connections with destination XMPP server with port 5269. This is required for XMPP Federation, so (sending) XMPP servers know which (receiving) XMPP servers to deliver messages to for your domain.
  • The last 3 are for client connections with destination XMPP client with port 5222. This is required so XMPP clients know which XMPP servers they should connect to.

Note:

  • If these DNS entries don’t exist, certain features will not function well or not at all.
  • Compass checks the DNS settings when adding the domain to the company, and will not allow adding a domain if DNS is not correctly configured. Please consult with your DNS provider for more information.

After creating the required DNS records, you can double check the results with the “dig” command line tool (on Linux/Unix/macOS) like this:

$ dig SRV +noall +answer _xmpp-server._tcp.example-domain.ext
_xmpp-server._tcp.example-domain.ext.  7200 IN SRV 100 33 5269 xmpp3.apollo.compass-stack.com.
_xmpp-server._tcp.example-domain.ext.  7200 IN SRV 100 33 5269 xmpp1.apollo.compass-stack.com.
_xmpp-server._tcp.example-domain.ext.  7200 IN SRV 100 33 5269 xmpp2.apollo.compass-stack.com.
$ dig SRV +noall +answer _xmpp-client._tcp.example-domain.ext
_xmpp-client._tcp.example-domain.ext.  7200 IN SRV 100 33 5222 xmpp3.apollo.compass-stack.com.
_xmpp-client._tcp.example-domain.ext.  7200 IN SRV 100 33 5222 xmpp1.apollo.compass-stack.com.
_xmpp-client._tcp.example-domain.ext.  7200 IN SRV 100 33 5222 xmpp2.apollo.compass-stack.com.

Note:

  • The order of records in the output of the dig command is random.
  • 7200 is the default TTL and could be different in your results.

Edit an Organisation

A company can be edited by clicking Edit organisation on the Manage page of the company you wish to edit. The Edit organisation page loads, where you can modify the following settings:

  • Organisation name: Edit the name of the organisation
  • Music on hold: This is the default music played when a caller is put on hold and no other element within Compass has music specified
  • Default CLI: Sets the default outgoing phone number for external calls. If a user is not logged in on a phone, or only internal calls is set for a user who calls for example an emergency service number from a registered phone, this will be the phone number visible for the receiving party
  • Default Codec Profile: When set to ‘Default’, high quality audio codecs are selected. When ‘Low bandwidth’ is set, lower quality audio codecs will be provisioned. These lower quality codecs will use up less bandwidth, but audio will be of a lesser quality as well. ‘Default’ is the advised setting
  • Select language: The language set in this field will be the default language for the company. If individual users wish to use a different language, they can change this in their user settings.
  • Call-Pickup within group: When enabled, picking up a call on another user’s phone is only allowed when both users are in the same group. By default this option is disabled, which allows users to pick up any incoming call within the organisation
  • Change the domain name for this company (link): Redirects to the Edit company domain page, where a company domain can be set or edited. For more information on this subject, see the Add an Organisation On the Edit organisation page, click ‘Save’ to confirm any changes made or Cancel if you wish to discard all changes.

You can remove a company by clicking ‘Delete’ behind the company name. You will be asked to confirm the deletion.

Resellers

An overview of all resellers can be found by going to Organisations in the main menu. To sort the list by reseller, click Type to separate resellers from companies.

Adding a reseller can be done by clicking Add reseller, but keep in mind you have to be on reseller level in order to be able to see this option.

On the Add reseller page, the following options can be set:

  • Name reseller: Fill out the name of the reseller
  • Email address: The email address filled out in this field will be used as the sender address in password emails to users. Notifications about added or deleted users will be sent to this address as well.
  • Base domain: Only applies when creating white label resellers. Leave empty otherwise.
  • Web interface URL: This URL will be used as the URL to the Compass web interface in password emails to users.
  • Select language: The language selected will be the default language used for this reseller
  • No-reply email address: This will be the email address used as the sender address in voicemail and call recording emails
  • Allowed trunks: Selection of trunks that can be assigned to new or existing organisations
  • Default trunk: Trunk assigned to new organisations on creation When finished, click Add.

A note regarding email delivery: Make sure that the email domains used for the fields ‘Email address’ and ‘No-reply email address’ allow Compass to send email on behalf of those domains. This will help prevent spam filters from blocking emails. Include our SPF entry in the DNS SPF record of the domains, like so: v=spf1 include:spf.apollo.compass-stack.com ~all

If you wish to review the settings of a reseller, select the reseller in the Organisations overview and click Manage in the main menu. On the Manage page you can click Edit organisation to edit the reseller.

To permanently delete a reseller, click Delete organisation. You will be requested to confirm the deletion. In order to be able to remove a reseller, all companies within this reseller should first be deleted or moved to another reseller.

Manage

Organisation managers can manage and configure various options and set up dial plans. The dial plan will be discussed elsewhere in this manual.

If you click Dial plan you will find several options to adjust the phone system of your department according to your needs. A list appears allowing you to create new records for the elements under Dial plan. These links will take you to the Add resource screens which belong to that specific element. If you want to select the element itself, you don’t click on Dial plan but just hover your mouse over it followed by clicking on the element of your choice.

Extensions

Extensions are the 2, 3, 4 or 5 digit numbers at which you can be reached through the internal network. To avoid confusion for example with emergency telephone numbers like 112, the first number of extensions can not be 0 or 1. You can create extensions in the range from 20 to 99, 200 to 998 (with the exception of 911), 2000 to 9999 and 20000 to 99999. You create an extension for one of your colleagues. Your colleague can use this extension to log in on any phone by pressing *1 followed by the extension. Next the PIN code is prompted to be entered, but only when a PIN code is set.

By clicking on the description in the extension overview, you open the dial plan, where the desired path for an incoming call can be decided. A green check mark behind a name/extension means a dial plan has been configured for this extension.

By clicking on one of the categories the overview is sorted.

You can add a new extension by clicking ‘Add new extension’, underneath the overview. The ‘Add extension’ page loads. Enter the internal number in the ‘Extension’ field and in ‘Description’ a name corresponding to the extension, which will be visible in the overview list. This can be an extension number or a more detailed description like someone’s name. Click ‘Save’.

Creating a new extension can also be done while adding a new user (see ‘Users’). Editing an extension can be done by clicking the Edit button (pencil icon) to the right of the description of the extensions overview list. The ‘Edit extension’ page will load where changes can be made.

Deleting an extension is done by clicking the delete button (bin icon). You will be requested to confirm the deletion.

External Numbers

External numbers are phone numbers which are used to reach your company. These numbers are already provided by your telecommunication partner. You can add and remove external numbers yourself. Warning: if you remove an external number, you can no longer be reached on this number! If you have new external numbers you can add those yourself, as explained below. By clicking on the description of the number the dial plan for the external number will be opened. The dial plan is explained elsewhere in this manual.

If you click ‘Add external number’ above the overview the ‘Add external number’ page will load. Here you can enter the number in the ‘External number’ field. In the ‘Description’ field a name can be filled out which will be visible in the overview list. This could be just the number, or, if desired, a more comprehensive description.

The name (16 characters max) the receiving party of the call will see in its display is set in the ‘Name shown at outbound call’ field. When finished click ‘Save’.

You can edit an external number by clicking the Edit button (pencil icon) to the right of the description in the overview. The ‘Edit external number’ page will load where the desired changes can be made. To delete an external number click the delete button (bin icon). You will be requested to confirm the deletion. Warning: If you remove an external number you can no longer be reached on this number!

Voice Prompts

You can add your voice prompts by uploading audio files. Compass recognizes all sorts of different audio files, like .mp3 and .wav, which it converts to a usable format.

Click ‘Add prompt’ to upload a new audio file. The page ‘Add Voice prompt’ loads. By clicking ‘Select’ you are able to browse your files and select the audio file you want to upload. The name entered in the ‘Name’ field will be visible in the Voice prompt overview list. The ‘Description’ is where you enter the content of the voice prompt (for example: ‘Good afternoon, welcome to Example Company). When finished click ‘Save’.

To change the name and description of the voice prompt, click the Edit button (pencil icon). The ‘Edit prompt’ page will load. Remove a voice prompt by clicking the delete button (bin icon). You will be requested to confirm the deletion.

Music on Hold

You can add new categories by clicking ‘Add music on hold’. After entering a name, click ‘Next’. The ‘Edit category music on hold’ loads, where audio files can be added. Next to the ‘New sound prompt’ field, click ‘Select’ to browse through your files and select an audio file. It is possible to add more than one file to a category. When more than one file is added to a category, files will be played in alphabetical order. When finished click ‘Save’. Categories can be edited and audio files can be added and removed by clicking the Edit button (pencil icon). The ‘Edit category music on hold’ page will load. To delete a category and its files click the delete button (bin icon). You will be requested to confirm the deletion.

Queues

You can add a new queue by clicking ‘Add queue’.

  • Name Queue: allows you to enter the name of the new queue. Use a unique name, preferably short and descriptive.
  • Strategy: queue strategy determines how the queue calls agents logged in on the queue. The following options are available:
    • Activate all phones simultaneously; all phones in the queue will ring at the same time.
    • Activate all available phones alternatively; one phone at a time will receive a call.
    • Activate all available phones alternatively and recall last phone; one phone at a time will receive a call, starting with the phone that completed a call last.
    • Choose phone least recently called by this queue; the phone least recently called will receive the call first.
    • Choose phone with least calls by this queue; the phone to have received the least calls will ring first.
    • Choose phone arbitrarily; phones will ring randomly.
  • Possible to connect to a queue:
    • If at least one agent is logged in: calls will be placed in the queue even if all agents are paused.
    • If at least one agent is not paused: calls will only be placed in the queue when at least one agent is available (unpaused).
    • Always: a call will always be placed in the queue, even when no agents are logged in.
  • Stay connected to queue:
    • While at least one agent is logged in: calls in this queue will stay in the queue while agents are available, even if they are all paused.
    • At least one agent is not paused: calls will stay in the queue while one agent is available. When all agents are paused, the call will leave the queue.
    • Always: will cause all calls to stay in the queue even if there are no agents logged in anymore.
  • Callers can escape from this queue: When enabled, a caller can press 1 to exit the queue. Compass will ignore the maximum waiting time and will immediately continue to the next step in the dial plan. For example: set a periodic announcement with a prompt stating that many agents are occupied and a caller can choose to leave a voicemail message by pressing 1, so they can be called back at another time. Make sure the queue is followed by a next dial plan element, otherwise the queue will disconnect after pressing 1.
  • Call waiting if agent is already in a call: Enabled by default. This setting is only applicable if an agent has enabled call waiting on their phone. When disabled, this setting overrules the phone’s call waiting setting and a second queue call will not be offered if an agent is already in a call.
  • Max. number of people in queue: If the filled in number of waiting callers in a queue is reached, the first new caller will not be placed in the queue. When there are no successive steps in the dial plan, the call will be disconnected.
  • Elapsed time in queue: The ring time in seconds a call is offered to available agents in the queue.
  • Maximum waiting time: Time in seconds a call can stay in the queue. When passed, the call will continue to the next step in the dial plan.
  • Weight: The weight of this queue compared to other queues. If an agent is logged in to multiple queues, a call to a queue with a higher weight will be offered first. The default is 1 and the maximum is 5 (extreme weight).
  • Gear up agents after a long waiting time: When this is set more agents will be gradually engaged depending on priority and availability. At login on a queue priority 1, 2 or 3 can be set for an agent. At first agents with priority 1 will be offered calls. When option 60/180 is set, this will be the case for the first 60 seconds. In the subsequent 180 seconds agents with priority 2 will be engaged, if agents with priority 1 are unavailable. After 240 seconds all agents including priority 3 will be offered calls, until the maximum waiting time has elapsed.
  • Music on hold: Choose from files added in the Music on hold menu which music is played for a waiting caller.
  • Periodic Announcements: Choose which prompt is repeated during the waiting time in a queue.
  • Time lapse between announcement: Sets the interval in seconds between periodic announcements. This setting will yield the Elapsed time in queue setting when not equal.
  • Interval between announcements of callers waiting and hold time: Sets an announcement stating the number of waiting callers in the queue. Any value will set the time in seconds between the callers waiting announcement and a hold time announcement when set.
  • Report estimated hold time: Set whether and when estimated hold time is reported to the waiting caller. The following options are available:
    • Each interval: coincides with the Interval between announcements of callers waiting and hold time setting
    • Only the first time: coincides only the first time with the Interval between announcements of callers waiting and hold time setting
    • Do not report: Turns off the estimated hold time announcement
  • Round hold time (seconds): The amount in seconds the estimated waiting time is rounded off. For example, if the waiting time should be rounded off to minutes, enter 60.
  • Shortcode: Code for the queue which can be used to log in and out of the queue on a phone by dialling *48*, followed by the code entered here. This code has to be a value greater than 0 and can contain a maximum of 5 numbers. When finished setting up the queue click ‘Save’.

By clicking on the name of the queue in the overview the queue page loads. Here the queue’s settings are displayed and users can be logged in and out of a queue as agents. The right list displays available users in the company not logged in to the queue, the left list displays agents in the queue.

To add a user to the queue click the add button (plus icon) in the right column, to remove an agent from the queue click the remove button (minus icon) in the left column.

Priority and whether call forwards are followed can be set for agents. When agents are logged in to a queue by default priority is set to 1 and follow call forwards is disabled.

Click ‘Save’ to save any changes.

Conference Box

You can set up a conference call using a Conference box. Provide each participant of the conference call with the number at which the conference box can be reached and if necessary the PIN code. The first person to call opens the conference call, and the other participants join in.

You can add a new Conference box by clicking ‘Add new conference box’. Enter the name of the box and if necessary the PIN code. When finished click ‘Save’.

To edit a conference box, in the Conference box overview click the Edit button (pencil icon) to the right of the name of the box you wish to edit. On the Edit Conference box page the Name and PIN code can be edited. To discard changes click Cancel, to save changes click Save.

Permanently deleting a conference box can be done by clicking the remove button (bin icon) in the conference box overview. You will be requested to confirm the deletion.

Voicemail

To add a new voicemail box, click ‘Add new voicemail’. On the Add Voicemail page a description and PIN code need to be filled out. The description can be a descriptive title, for example the name of the person or department the voicemail box will be assigned to. Entering an email address is optional, this can be set to receive the voicemail audio file in your email box.

The voicemail box settings can be edited by clicking the Edit button (pencil icon) to the right of the voicemail box’ name you wish to edit, on the overview page. The description, PIN code and email address can be changed. To discard changes click Cancel, to save changes click Save.

To permanently delete a voicemail box, in the Voicemail box overview click the remove button (bin icon) behind the box to be removed. You will be requested to confirm the deletion.

Call Forwarding

When you add a call forward, this call forward will be available in the dial plan’s Call forwarding submenu. For further details see the Dial plan section.

Add a new call forward by clicking ‘Add new call forwarding destination’.

  • Call forward towards number: Enter the phone number to which the call forward has to be directed. This can be an internal or external extension or for example a mobile phone number.
  • Description: Enter a descriptive name for the call forward.
  • Ring time (seconds): lets you choose how long the call will be offered to the destination of the forward, before reverting back to the dial plan. Setting ring time at 0 will not revert to the dial plan.
  • Extension: When filled out, a new extension will be created. Its function is to forward to the destination number, therefore it could be used as a quick dial. For example, if the destination for the forward is someone’s mobile number, only the extension has to be dialled in order to reach the person on mobile. The extension can also be used to add a more extensive dial plan.
  • Call forward CLI transparent: When enabled the original caller ID will be sent to the destination, instead of the caller ID of the forwarding party.
  • Confirm received call: When enabled the destination will be prompted to confirm answering the forwarded call by pressing a key on the phone. When denied, the call will return to the dial plan. If no other option is set, it will be terminated.

When finished setting these options, click Save.

To edit a call forward, click the Edit button (pencil icon) in the overview. To discard changes click Cancel, to save changes click Save.

If you wish to permanently delete a call forward, click the remove button (bin icon) in the overview. You will be requested to confirm the deletion.

Dial plan switch

When dial plan switches have been added to a dial plan in your company, this overview gives you a list of all the switches, their short code and current setting. For further details on how to add a dial plan switch, see the Branches section.

To change the setting of a dial plan switch via the web interface, click the Edit button (pencil icon) to the right of the switch’s name. On the Edit Dial plan switch page is an overview of all the available settings, with the current setting selected. Select the desired setting and click Save. In the Dial plan switch overview, the current setting is visible. Deleting a dial plan switch can be done by going to the extension’s dial plan in which the switch is located. Click the X icon in the dial plan switch block to remove it from the dial plan and click Save.

Users and Groups

In this section you will find groups, departments and users that have been created in the company. You will be able to create, modify and delete these items as well as set up user rights. Users in departments and groups can be allowed to pick up incoming phone calls on each other’s phones by dialling *8.

In the main menu, navigate to the Manage tab. Click Users in the submenu to go directly to the Add users and groups page to create groups, departments or users. Or to get an overview and more options for each individual item, select the Users submenu and then click on the item you want to work on.

Groups

The function of Groups is to group together a selection of users. Users can belong to multiple groups. For example, cross-department project teams.

Groups can be used to limit the reach of a *8 call pickup by first setting up groups of users that should be able to pick up each others calls, and then enabling Call-Pickup within group for a company.

To add a new group, click Add group. Fill out a descriptive name for the group and click Save.

Go to the Group information page by clicking on the group in the Groups overview. Here users can be added to the selected group by clicking the add button (plus icon) next to their username in the Non-members of the group list. Removing members is done by clicking the remove button (minus icon) next to the username in the Members of the group list. Use the Filter field to do a quick search for a user and when finished click Save to keep the changes made.

If you wish to change the name of the group, click Edit group on the Group information page. This can also be done by clicking the Edit button (pencil icon) to the right of the group name in the Groups overview.

Removing a group can only be done from the Groups overview, by clicking on the remove button (bin icon) behind the group name. You will be requested to confirm deleting the group.

Departments

In the departments overview you can see all departments within the company. The function of departments is similar to that of groups, only this is meant to group together all the users who are for instance in the physical Support department within your organisation.

To add a new department, click Add department in the Departments overview. On the Add department page fill out a descriptive name for the department and when finished click Save.

Go to the Department information page by clicking on the department in the Departments overview. Here users can be added to the selected department by clicking the add button (plus icon) next to their username in the Non-members of the department list. Removing members is done by clicking the remove button (minus icon) next to the username in the Members of department list. Use the Filter field to do a quick search for a user and when finished click Save to keep the changes made.

If you wish to change the name of the department, click Edit department on the Department information page. This can also be done by clicking the Edit button (pencil icon) to the right of the department name in the Departments overview.

Removing a department can only be done from the Departments overview, by clicking on the remove button (bin icon) behind the department name. You will be requested to confirm deleting the department.

User

The Users overview will give you an alphabetical list of all the users in the selected organisation.

Go to Add user to add a new user to the organisation. Be aware that adding users could affect monthly charges. On the Add user page the following can be filled out:

  • Full name: Fill out the full name of the user
  • Select language: Select the desired language of the user. This will overrule the company default language setting for text on the web interface and prompts on the phone
  • Username: Will be generated while typing the Full name, but can also be customized. Can not contain capitals. This is the name that will be used to log in to Compass and is visible on a phone’s display on which the user has logged in
  • Password: Type a custom password with which the user can log in to Compass web interface. Has to be left empty when password is auto generated
  • Email: Fill out the email address of the user. This is the address the auto generated password will be sent to, this field is mandatory when Send login credentials is checked
  • Send login credentials: Check this option when you want the password to be auto generated. An email address should be filled out.
  • Extension: If the user needs to have its own internal extension assigned, this is where it can be created. It can not be an existing extension, the new extension will be created upon adding the user
  • Description: When assigning an extension to the user, the description is a short descriptive name given to the extension, which will be visible in the Extension overview. When no extension is assigned, this field can be left empty
  • PIN code for login: Optional 1-4 number long code used for logging a user in on a phone securely
  • Outbound number: When set to Internal calls only (default), the user is not able to call to an external number, only to extensions within the company. When set to an external number, the user is able to make calls outside of the company. The number selected will be set as the caller ID. This option is only available if an external number has been added to the company.

When finished filling out the desired options for the user, click Save.

To see a user’s basic information and to set more options, click a user’s name in the overview to go to the User information page. This page contains the user’s name, email address, username, language and its identities.

The user can be edited by clicking Edit user on the User information page. On the Edit user page the Full name, email address, PIN code for login on a phone, language, and additional features can be changed. The features incur extra monthly charges, and can be changed after clicking the ‘Edit features’ button. If the desired changes have been made click Save, or Cancel to discard.

The user’s identities can be edited by clicking the Edit button (pencil icon) to the right of the identity’s name on the Users overview page. To get more information on the options available for an identity, see the Identities section.

Change password will allow the user’s password to be changed without the need to know the current password. This can, for example, be used by administrators to generate a new password when the current one has been lost. If the user has set an email address, a new auto generated password can be sent to this address by checking the Generate new and email option. If you prefer to set a custom password, fill out and repeat the new password in the designated fields.

A user can have certain rights within an organisation. These determine what a user can view and edit and on which level. Go to Set up user-rights to view and change these rights for the selected user. More information about setting up user rights can be found in the User rights section.

One user can have multiple identities which can be added by clicking on Add identity. This will open the Create new identity page, which will be further explained in the Identities section.

To log the selected user on and off on a phone using the web interface, go to Log in and log off phone. On the Log on to phone page, an overview of all the phones in the company is visible. The selected user can be logged in on a phone by clicking the phone name. The user’s name will appear behind the phone name when the user is logged in. Logging out is done by clicking the phone name again. The user’s name disappears when logged out.

Settings can be used to view and change the user’s personal and phone information, set identity call forwarding and view voicemail and queues information. For more information, see the Settings section.

If you wish to permanently delete a user click the remove button (bin icon) behind the user’s name in the Users overview. You will be requested to confirm deletion.

Additional features

Users can be edited to enable additional features. These features incur monthly charges. Contact your reseller for more information.

The following features are currently available:

  • Call control API: Enable the REST API calls that allow external applications to perform call control. Refer to the REST schema to see the exact calls that become available when enabling this feature.

User rights

User rights can be set by going to the user’s User information page and clicking Set up user-rights. Rights can only be set by users with write rights within the company or reseller.

The following levels of user rights are available:

  • Company rights: User can manage its own company. For example create and manage dial plans, users, groups and departments.
  • Reseller rights: In addition to the above, the user can also create and manage companies.
  • Super reseller rights: In addition to the above, the user can also create and manage resellers.

If for example you want to grant a user company rights, select the Set up Company rights check box and click Next. On the next page, Company rights for user, select the company on which you want to grant the user rights. On the Set up company rights for user page, click the drop down list behind Apply rights and to select either Unauthorized for mortal user rights, View for read rights and Change for full read and write rights for the user in the selected company. Click Save to set the selected rights, or Cancel to discard.

Identities

The first identity of a user is its primary identity and is created when the user is created. When a user with multiple identities logs in on a phone, all of its identities are visible on the display and, according to the type of phone used, each identity has its own line. Be aware that the maximum number of identities created in Compass might not coincide with the maximum number of identity slots available on the phone the user is logged on to.

Additional identities for a user can be created by clicking Add identity on the selected user’s User information page, which will open the Create identity page. The following options can be set when creating a new identity:

  • Name identity: Fill out the name of the identity
  • Description: Fill out a descriptive name for the identity. This will be visible in the overview.
  • Extension: If the identity needs to have its own internal extension assigned, this is where it can be created. It can not be an existing extension, the new extension will be created upon adding the identity
  • Outbound number: When set to Internal calls only (default), the user is not able to call to an external number, only to extensions within the company. When set to an external number, the user is able to make calls outside of the company. The number selected will be set as the caller ID. This option is only available if an external number has been added to the company.
  • Voicemailbox: Set the voicemailbox to which incoming messages are delivered
  • Hide caller ID: When checked the caller ID of the identity will not be visible to the receiving party
  • Confirm received call: When enabled the destination will be prompted to confirm answering the forwarded call by pressing a key on the phone. When denied, the call will return to the dial plan. If no other option is set, it will be terminated.
  • Record calls: When enabled all incoming and outgoing calls of this identity will be recorded. Enabling this option will unveil three more fields. An Email recordings to field where an email address can be entered where the recordings will be sent. A disclaimer field which needs to be read and agreed upon by checking the I Agree check box.

When finished setting up the new identity, click Save.

The newly created identity is now visible in the overview on the User information page. To edit an identity, click the Edit button (pencil icon) to the right of the identity’s name. On the Edit current identity page all above options can be edited.

If you wish to permanently delete an identity, click the remove button (bin icon) behind the identity name in the identities overview on the User information page. You will be requested to confirm deletion.

Settings

The user’s settings page provides an overview of the user’s personal-, phone-, voicemail and queue information. To get to this page, select the user in the Users overview and click Settings.

The user’s email address, password, phone and identity forwards can be modified. In the Call forwarding section identity forwards can be set. The following options are available:

  • Always: Incoming calls are always immediately forwarded to the given number.
  • Busy: Incoming calls will only be forwarded when the user is already in a call.
  • No answer: Incoming calls will be forwarded when the calls are not answered. A call will be considered not answered after the set ring time has passed.
  • Unavailable: Incoming calls will be forwarded when the phone the user is registered to is unavailable. This is the case when either a user is not logged in on the phone, or the user has enabled the Do Not Disturb setting on the phone.

Incoming calls will be forwarded to the given number in the field below the forward option. This can be an internal extension, an external number for example a mobile phone number, or voicemail (1233). Additional options for identity call forwards are:

  • Ring time: The set time (seconds) determines how long the call will be offered until a call is considered not answered.
  • Call forward CLI transparent: When this option is enabled, the original caller ID will be sent to the destination, instead of the caller ID of the forwarding party.

Phones

From the Manage menu you can choose the Phones menu option to get an overview of phones in the company.

When adding a phone, you should always use auto provisioning as described below.

Setting up Auto provisioning

Compass is equipped with auto configuration of several brands and types of phones. Auto configuration takes care of configuring phones so a phone doesn’t need to be set up manually to work with Compass.

Auto configuration is fully supported for these brands:

  • Snom
  • Yealink

SIP phones that are not supported can be added to the platform, when configured as one of these types:

  • Generic SIP Phone, for physical phones with a MAC address
  • Generic SIP DECT phone for wireless phones, and
  • Generic SIP Softphone for software clients and mobile clients

After clicking the Add phone button, you are able to enter a phone name, a phone type, and its MAC address. The MAC address can usually be found on a sticker on the bottom of the phone. If the specific phone you are adding is not in the list of supported phones, select Generic SIP Phone, or Generic SIP DECT.

Depending on the chosen phone type, additional form fields may appear that allow for phone specific configuration, such as installing an expansion pad. Optionally, a VLAN ID may be provided. This is the code of the VLAN the phone should use to connect. Valid values are between 1 and 4094. Ask your network administrator for details. If unsure, leave this empty. Usually a VLAN ID is not needed. To deconfigure a VLAN setting, enter the number 0. The next time the phone collects its configuration, it won’t be in a VLAN anymore.

After entering all of the details, click Save to add the phone to the company.

You will see the added phone in the overview of configured phones. You can edit the phone by clicking on the Edit button (pencil icon) to the right of the phone details in the overview.

Settings

To change the settings of a particular phone, click on the phone’s name in the overview to see all of the phone details. Above the table with details, there are several options: Settings and Edit function keys.

General phone settings

Click Settings to see several configuration options for that specific phone.

You are able to edit the sensitivity of the earpiece, headset microphone, and phone speaker. Maximum sensitivity is 100%, and 0% means no sound at all.

It’s also possible to enable call waiting and call waiting indication. If you enable call waiting, you will be able to answer a second incoming call while already on the phone in another call. The second call will be indicated to you as configured. You can choose if you wish to answer the second call or not. If call waiting is not enabled, a second call will not be routed to your phone so you will not be disturbed.

Add custom settings enables an administrator to configure custom phone settings by entering provisioning data which is merged into our default provisioning. These settings can be configured for an individual phone, or per phone type, which applies to all phones of the specified type within the company. Custom settings will override Compass settings and incorrect input could potentially break the phone’s functionality.

Options for custom settings are, for example, change a label or display text, remap a key, or set a speed dial to be able to have a designated log in button. Enter a parameter and value in the fields, click Save when done to push the altered configuration to the selected phone. To view a phone’s provisioning configuration, click View provisioning on the phone’s Status page. If any customised settings have been applied, these will be visible at the bottom of the document.

Be aware that this is advanced functionality and should only be set by an experienced administrator.

Edit function keys

Click Edit function keys to configure the function keys on supported phones.

The amount of function keys depends on the type of the selected phone. For a Snom phone with two rows of function keys, the keys are numbered from the top left (1) to bottom right.

You can configure a function for every key. There are different types of functions to choose from:

  • Standard: the key will have the function assigned by the manufacturer.
  • Button: you can choose one of the following functions: On hold, Call transfer, Do not disturb, Redial.
  • Line: open a new line to start a call.
  • No function: the key will have no function at all.
  • Speeddial: call a number entered in the input field in this form.
  • Status: the key will serve multiple functions: The light for this key will serve as a status light for the internal number configured in the input field. If the light is off the internal number is not busy or ringing. If the light is on and doesn’t blink, the internal number is busy. If the light blinks, the internal number is ringing. If the button is pressed while the light is blinking, it functions as call pickup and the call that is ringing on the internal number is transferred to the phone and answered immediately. Additionally, pressing the key if the light is not on will call the internal number entered in the input field in this form.

Configuring function keys can be done for one phone individually, or for all phones of a particular type at the same time. To configure all phones of a particular type, choose Edit function keys directly from the Phones overview page. Choose the phone type you wish to configure. Set up configuration as you would do for an individual phone from there.

Phone status

To view the properties and details of an individual phone, click on the phone name in the Phones overview. You will see the phone’s details, a Reboot button to remotely restart the phone, and a View provisioning button. The details in this overview are usually not required for normal operation.

Editing phones

To edit a phone, click the Edit button (pencil icon) right to the phone details in the overview, or click the Edit button on the Phone status page.

You will see the following:

  • Phone name: adjust the name here if needed
  • Phone model: make corrections here if the wrong model was entered earlier
  • MAC Address: make corrections here if the wrong MAC was entered earlier
  • Expansion pads: adjust the amount of connected expansion pads
  • Codec profile: a codec profile is already defined for the company. If you require a different codec profile for this specific phone, you can configure this here. For example, if a user is working from home on a low bandwidth internet connection. Our advice is to leave this set to default.
  • Firmware version: configure which version of the firmware you would like this phone to have. Compass will attempt to upgrade this phone to the selected firmware.
  • VLAN ID: This is the code of the VLAN the phone should use to connect. If unsure, leave this empty. Usually a VLAN ID is not needed.

Dial plan

As an administrator, you can edit everything related to dial plans. The procedure is to set up all the individual elements listed under the Dial plan menu first. When all users, prompts, queues and other elements have been set up, they can be added to the dial plan’s tree-like structure. This determines when, and in which order, a particular action (play a prompt, connect to a user, etc) is taken. Dial plans can be set up for both external numbers as well as internal extensions. Go to either overview page and select the number or extension you wish to set up or edit a dial plan for.

Editor

In the dial plan editor, you can create and alter dial plans by dragging and dropping dial plan elements. The available elements are on the right hand side of the editor. There is a search field to filter elements. At the moment, these are the types of elements that are available:

  • Branches
    • Time based routing
    • IVR menu
    • Dial plan switch
    • Number recognition
  • Call forwarding
  • Conferences
  • Miscellaneous
    • End call
    • Busy
    • Prefix
    • DTMF input
  • Persons
  • Prompts
  • Queues
  • Voicemails

In the top left corner is a grey block: Call. This is the point where the call enters the dial plan. You can now click and drag a dial plan element from the right panel to drop it on the first free slot: First action.

An already placed element can be removed by hovering over the element in the dial plan and clicking the X in the top right corner of the element.

Please note that you should always manually save any changes you’ve made to the dial plan. Changes to the dial plan are not saved automatically. To save your changes click the Save button in the top right corner of the dial plan editor.

Dial plan elements

The list of elements with which a dial plan can be made consists of the created resources, such as queues, prompts, persons, and special elements such as time based routers and dial plan switches. In the next chapters we’ll describe how these elements can be used.

Branches

This category of dial plan elements contains Dial plan switch, IVR menu, Number recognition and Time based routing.

Dial plan switch

If a call should be routed differently depending on a condition set by a user, you can use a Dial plan switch. This for example allows a user to redirect callers on the technical support number to a prompt indicating a service disruption, so all of the support engineers can work on resolving the issue.

To add a Dial plan switch, drag the element to a free slot. A pop-up for the settings will appear. Then enter a name, a Dial plan switch shortcode (used to identify the switch when changing or reading the branch), and the amount of switch branches you require. When ready, save the settings. The branches should now appear in the dial plan.

Optionally, you can give each branch a name by clicking on the branch element and filling in the form field.

Now simply drag dial plan elements to the branches to configure what happens if a call is routed through that branch.

If you have created a Dial plan switch, there are two ways to read and change the current setting. First by going to the Dial plan switches page in Compass, see the Dial plan switch section. Second, by using a service code on your phone, as described in the Set dial plan Switch section. Additionally, in the dial plan of the extension containing the switch the current setting of the switch is indicated by a check mark in the block of the selected setting.

IVR menu

If a call should be routed differently based on a choice made by the caller, you can use an Interactive Voice Response (IVR) Menu. This for example allows a caller to press ‘1’ for support, and ‘2’ for sales.

To add an IVR menu, drag the element to a free slot. A pop-up for the settings will appear. Then enter a name, add a voice prompt in which the available options are explained, select how many times callers should hear the menu repeated and how long a caller has to respond with a choice. Check the dial pad keys the menu should respond to and save the settings. The dial plan should now display a branch for every selected key.

Now simply drag dial plan elements to the branches to configure what happens if a caller presses that key.

Number recognition

If a call should be routed differently depending on the number it’s calling from, you can use Number recognition. This for example allows for different dial plan branches for different countries of origin, or routing a customer directly to a specific support agent. Anonymous calls can be routed separately.

To add Number recognition, drag the element to a free slot. A pop-up for the branches will appear. Click the plus icon to add branches. Determine how many different branches the routing should have, and give them a name such as ‘Region A’, ‘Region B’, ‘Region C’, and ‘Customer X’. When ready, save the settings. The branches should now appear in the dial plan.

Click on the branch element to set which incoming numbers should be recognised. The Number list can take prefixes or complete numbers.

  • Input one prefix or number per line in the Number list.
  • Always use international format, but without the plus sign (+), minus sign (-) or spaces.
  • To match a specific number, enter the complete number including international prefix (“31201234567”).
  • To match a region, enter the international prefix and the area code (example: “3120” to match all calls from Amsterdam).
  • To match all mobile calls, enter the international prefix and the mobile number prefix (“316”).
  • To match all calls from a country, enter the international prefix number (“31”).

These things are important to consider:

  • Anonymous calls by default do not match any branch. If you wish to route anonymous calls, always have one branch with the option Caller ID blocked enabled. All anonymous calls will be routed through that branch.
  • If more than one branch matches the incoming number, the first match will determine the branch the call is routed through. For example: if the first branch matches on “31612” and the second matches on “316”, then incoming calls from number 31612345678 will be routed through the “31612” branch.
  • If the incoming number doesn’t match any manually configured branch, the call will be routed through the Default branch. This branch is always added automatically.

Do this for every branch, and make sure that every number (including anonymous) you wish to route has a match in one of the branches.

Time based routing

If a call should be routed differently depending on the time of day, day of the week, or (part of) the month, you can use Time based routing. This for example allows you to play different prompts during the day, such as ‘Good morning’ and ‘Good afternoon’.

To add Time based routing, drag the element to a free slot. A pop-up for the branches will appear. Click the plus icon to add branches. Determine how many different branches the routing should have, and give them a name such as ‘Morning’, ‘Afternoon’, ‘Evening’, and ‘Night’. When ready, save the settings. The branches should now appear in the dial plan.

Click on the branch element to set at which times that branch should be followed. Do this for every branch, and make sure that there are no gaps between the time set for each branch. So ‘Morning’ is set from 08:00 to 12:00, then ‘Afternoon’ is set from 12:00 to 18:00, etc.

Call Forwarding

If at some point in the dial plan you would like to forward the call to a different number (internal or external), you can use a forward. If a forward is used in a dial plan for an external number, and you are not forwarding to an internal extension, the external number of the dial plan will be used as the outgoing number for number recognition.

Conferences

If you would like to have a conference box in your dial plan, drag it to an open slot in the dial plan.

A conference box element will answer incoming calls automatically and ask for a PIN code if required. A conference box is a dial plan end point, meaning elements placed after a conference box will not be executed.

Miscellaneous

This category of dial plan elements contains End call, Busy, Prefix and DTMF input.

End call: if this element is encountered in the dial plan before a call is answered, the call will end with a “Temporarily not available” status. If the call was answered earlier in the dial plan, and the call continued after that, it will end with a “Normal call clearing” status.

Busy: a call encountering this element will end with a “Busy” status.

Prefix: if a call encounters this element, a configurable text will show in the display of the phone receiving the call together with the calling number. This can help to identify through which number a caller is calling. To set a prefix, drag the element in the dial plan and click on it to configure the text.

DTMF input: this element reads DTMF (digit) input from the caller. Use a fixed-length input if the amount of digits is fixed, ie. a 4-digit PIN code. If variable-length is selected, the caller ends the input using the pound sign (#). Pressing the star (*) resets the input. DTMF input from the caller can be read by using the Compass XMPP API.

You are advised to use the selected voice prompt to instruct the caller on the usage of this element; for example, mention that input can be ended with the pound sign for variable-length inputs.

Persons

You can set up a dial plan to call a particular person by dragging one of the person elements to a free slot in the dial plan. The dial plan will call the first identity configured for this person. In addition, identity forwards set for that identity will be followed. If the call is not answered directly or after following forwards, the dial plan will continue to the next configured action.

Prompts

If you would like to play a message to the caller, you can add a prompt to a free slot in the dial plan. An incoming call will be answered automatically first, before playing the audio. When the prompt has finished playing the dial plan will continue to the next configured action.

Queues

If the handling of incoming calls should be distributed over a group of users (agents) while the caller waits in line, you can use a queue. This for example allows a sales team to all receive calls to the sales number and have users wait if all sales representatives are busy handling calls. If configured, users will be informed about their position in the waiting line and the expected waiting time.

A call will only be routed to elements after a queue if:

  • callers were unable to enter the queue due to its settings
  • the caller escapes from the queue (if configured)
  • the maximum waiting time is reached

If a call is answered by an agent, the queue will be the end point of the call.

Voicemails

If you would like to offer the caller the option to leave a message, you can use a voicemail box.

A voicemail box element will answer incoming calls automatically. A voicemail box is not a dial plan end point. If a caller presses # (hash key) to finish leaving a voicemail message, the call will continue through the dial plan.

Examples

Front desk

If you would like to have all incoming calls handled by the front desk, create a front desk queue and add it to the first slot of the dial plan of the main external number. Click Save to save the dial plan. Now all incoming calls on the main external number will be offered to the front desk, where the call can be transferred to the relevant employee.

Reports

Compass offers Call Detail Records and Events reports both as download in the web interface as well as through an HTTP API.

Administrators can access ‘CDRs and Events’ in the Compass web interface on the Manage page of the company.

Developers can request the same information using our CDR and Events API documented below.

Types of reports

There are 5 types of reports available for download:

  • Company CDR: contains a record for every call that enters or leaves a company. A user calling the external number of the company that user is part of, means two records: one call leaving the company, and one entering it.
  • Queue CDR: contains a record for every call that is received by a user. A call between two users in the same company means two records.
  • User CDR: contains a record for every call that enters a queue, also if the queue call isn’t answered.
  • Call Events: contains step by step events for all calls in the company, to track exactly how a call was handled by the platform.
  • User Events: contains user actions, such as logging in and out on a phone or queue, and pausing and resuming receiving queue calls.

Company CDR

The columns in the Company CDR are:

  • call_id: a unique identification of a call. If a call is split (for example when a call is distributed amongst agent(s) in a queue) then this will generate one or more new calls with new call IDs.
  • start_time: time at which the call started. Formatted as “YYYY-MM-DD mm:hh:ss”.
  • answer_time: time at which the call was answered. Formatted as “YYYY-MM-DD mm:hh:ss”. Incoming calls can also be answered by prompts or IVR menus. Empty if the call is not answered.
  • end_time: time at which the call ended. Formatted as “YYYY-MM-DD mm:hh:ss”.
  • timezone: time zone offset relative to UTC as defined in ISO 8601. Example: “+02:00”
  • from_type: the source type. Can be either external or identity.
  • from_id: the identification of the identity. Only used if from_type is “identity”, otherwise empty.
  • from_number: the number of the source of the call. Empty if the call is anonymous or internal (within company).
  • from_name: the name of the source of the call, if provided by the source. In some cases, the source number is also used as the name.
  • to_number: the number of the destination of the call. If the record describes an incoming call, this is the number on which the call was received.
  • end_reason: indicates the reason the call was ended. Can be either busy, caller (caller ended the call) or callee (receiver ended the call).

By processing the Company CDR in an application such as Excel, you can answer questions such as:

  • How many calls do we receive?
  • How often do we call a particular customer?
  • What is the average call duration?
  • Did a particular customer call more than 7 times yesterday?

Queue CDR

The columns in the Queue CDR are:

  • call_id: a unique identification of a call. If a call is split (for example when a call is distributed amongst agent(s) in a queue) then this will generate one or more new calls with new call IDs.
  • start_time: time at which the call started. Formatted as “YYYY-MM-DD mm:hh:ss”. If a call enters the same queue several times, the start time will differ.
  • timezone: time zone offset relative to UTC as defined in ISO 8601. Example: “+02:00”
  • wait_duration: waiting time until an agent answered the call, in seconds.
  • agent_duration: duration of the call after it was answered by an agent, in seconds.
  • queue_id: the identification of the queue.
  • queue_name: the name of the queue.
  • agent_id: the identification of the agent that answered the call. Empty if a call was not answered.
  • agent_name: the name of the agent that answered the call. Empty if a call was not answered.
  • from_number: the number of the source of the call. Empty if the call is anonymous or internal (within company).

By processing the Queue CDR in an application such as Excel, you can answer questions such as:

  • What was the average waiting time in a queue?
  • Which agent answered the most calls?
  • What was the average duration of calls in a queue?

User CDR

The columns in the User CDR are:

  • call_id: a unique identification of a call. If a call is split (for example when a call is distributed amongst agent(s) in a queue) then this will generate one or more new calls with new call IDs.
  • parent_id: the original call_id, if a call is split as described above. Empty if the call is not split.
  • start_time: time at which the user was first involved in the call. Formatted as “YYYY-MM-DD mm:hh:ss”. On incoming calls, a caller could have gone through IVR menus and prompts before a user gets involved.
  • answer_time: time at which the call was answered. Formatted as “YYYY-MM-DD mm:hh:ss”. Empty if the call is not answered.
  • end_time: time at which the call ended. Formatted as “YYYY-MM-DD mm:hh:ss”. If the call was not answered, or a call was forwarded, the call could continue elsewhere.
  • timezone: time zone offset relative to UTC as defined in ISO 8601. Example: “+02:00”
  • identity_id: a numeric, unique identification of the identity of a user.
  • identity_name: the name of the identity of a user.
  • direction: the direction of a call. Can be either outgoing or incoming.
  • number: if available, contains the number the callee got as caller ID. For outgoing calls, this is the number configured for the identity used for the call. In some cases, the number may be unknown.

By processing the User CDR in an application such as Excel, you can answer questions such as:

  • What was the average duration of calls answered by a user?
  • Which user missed the least calls?

Call Events

For optimal freedom in reporting we offer Call Event Logging. This allows calls to be tracked step by step.

The Call Event Logging system is meant for automatic processing in Business Intelligence tools. The column names and values are in English unless it concerns user input.

The columns in the response are:

  • id: a numeric, unique identification of an event. Numbers ascend in the order in which events were written.
  • company_id: a numeric, unique identification of a company.
  • call_id: a unique identification of a call. If a call is split (for example when a call is distributed amongst agent(s) in a queue) then this will generate one or more new calls with new call IDs.
  • parent_id: the original call ID. This is only provided if the call has been split.
  • step: a counter that indicates in which order events occurred. Starts at 0.
  • timestamp: time at which an event occurred. Formatted in a human-readable format based on ISO8601 and adjusted to work with MS Excel.
  • caller_type: indicates the type of caller. Can be either identity, external, pbx, queue or unknown.
  • caller_id, caller_number and caller_desc: more info about the caller, depending on caller type.
  • caller_state: indicates the state of the caller. Can be either connecting, ringing, answered, inactive or disconnected.
  • callee_type, callee_id, callee_number, callee_desc and callee_state: same as above, but for the receiving side. This will change while the call proceeds through the dial plan. For example, a call is answered by a queue first, then by an agent.
  • state: indicates the state of a call. Can be either conn (connecting), ring (ringing), answered or down (call ended). It’s possible for a call to change state from answered to ringing, for example after an unattended transfer.
  • end_reason: indicates the reason the call was ended. Can be either busy, caller (caller ended the call), callee (receiver ended the call) or replace (call ended with a (semi) attended transfer).

Note:

  • Events are not sorted in the response.
  • Event Logging is not real time. It can take a while for information to become available.
  • The Event Log may contain information for events that are not completed yet.

The principles of Event Logging are as follows: A call has a source (a caller), and a destination (a callee). Both are endpoints. These endpoints change over time: for example, a call first reaches a dial plan, then a queue, and then a user (identity).

For every destination, a call can have several states: connecting, ringing, and answered. If the call changes destination, the state of the call can change back from answered to ringing.

Subcalls are usually the result of the call reaching a queue. If a call reaches a queue, the status changes to answered. This call has a call_id but no parent_id (call_id of the parent). For every agent available in the queue, a new subcall is set up from the queue to the agent. Agents can be called one by one, or multiple at a time, depending on queue settings and the availability of agents. Calls set up from the queue to agents have a new call_id, but also lists the original call_id as parent_id. If an agent answers the queue call, all subcalls are ended (status: down) and the original call gets the agent that answered as the new destination.

User Events

User Events allow you to track user actions, such as logging in and out on a phone or queue, and pausing and resuming receiving queue calls.

The events are meant for automatic processing in Business Intelligence tools. The column names and values are in English unless it concerns user input.

The columns in the response are:

  • id: a numeric, unique identification of an event. Numbers ascend in the order in which events were written.
  • timestamp: time at which an event occurred. Formatted in a human-readable format based on ISO8601 and adjusted to work with MS Excel.
  • company_id: a numeric, unique identification of a company.
  • company_name: name of the company.
  • event_type: the type of event. Can be either pause, unpause, login, logoff, remove or queuePickup.
  • user_id: a numeric, unique identification of a user.
  • user_name: the login name of a user.
  • user_fullname: the full name of a user.
  • identity_id: a numeric, unique identification of the identity of a user.
  • identity_name: the name of the identity of a user.
  • target_type: the type of element the event applies to. Can be either queue or phone.
  • target_id: the unique identification of the element which the event applies to. For example: if target_type is a queue, target_id contains the ID of the queue.
  • target_name: the name of the element which the event applies to. For example: if target_type is a queue, this will contain the full name of the queue.

Downloading reports from the web interface

The page ‘CDRs and Events’ allows you to select the desired report and the desired timeframe.

Select a start and an end date, choose the type of report and choose the desired format. Default is CSV. If you select ‘CSV for Excel’ an extra header is added to the file that makes parsing in Microsoft Excel easier.

A maximum of one month worth of data can be downloaded at a time. If you need reports on a longer period, split it up in chunks of one month each.

CDR API

CDRs are available for download through an HTTP API at this endpoint:

https://files.apollo.compass-stack.com/cdr/$COMPANY_ID/$DATE/$CDR_TYPE.csv

The variables in this URL are:

  • $COMPANY_ID: the Company ID, as listed in the Compass web interface on the Manage page for the company you want to request events for.
  • $DATE: date (YYYY-MM-DD) - request events from this day.
  • $CDR_TYPE: one of the three CDR types: company, user or queue.

Reports are limited to one day per request.

Events API

Call Events can be downloaded from the following URL:

https://files.apollo.compass-stack.com/events/$COMPANY_ID/calls?startTime=$TIME1&endTime=$TIME2

User Events can be downloaded using this similar URL:

https://files.apollo.compass-stack.com/events/$COMPANY_ID/users?startTime=$TIME1&endTime=$TIME2

The variables in these URLs are:

  • $COMPANY_ID: the Company ID, as listed in the Compass web interface on the Manage page for the company you want to request events for.
  • $TIME1: start time (UNIX timestamp, GMT time zone) - request events from this time.
  • $TIME2: end time (UNIX timestamp, GMT time zone) - request events up to this time.

Call recordings

Introduction

Call recording can be enabled for an identity (user), and for an external number. Please note:

  • A call recording is saved to file and sent to the configured email address after the call ends. The recording file could become large, particularly on long calls.
  • Call recording files are not saved on the telephony platform. If the email with the attached call recording file cannot be delivered successfully (for example, because the receiving mailbox is full) the recording file cannot be recovered.
  • The users in your company are responsible for announcing that calls are recorded, and for maintaining a reasonable retention period for call recordings.

Automatic processing

To allow call recordings to be automatically processed, the following data is stored in the header of the email message containing a call recording:

  • X-Compass-CompanyId: the unique identification of the company in which the call recording took place.
  • X-Compass-Company: the shortname of the company in which the call recording took place.
  • X-Compass-IdentityId*: the unique identification of the identity (user) for which the call recording was done. Empty for external number call recordings.
  • X-Compass-Identity*: the name of the identity (user) for which the call recording was done. Empty for external number call recordings.
  • X-Compass-ExternalNumberId*: the unique identification of the external number for which the call recording was done. Empty for identity call recordings.
  • X-Compass-ExternalNumber*: the external number for which the call recording was done. Empty for identity call recordings.
  • X-Compass-Direction: the direction of a call. Can be either inbound or outbound.
  • X-Compass-MD5: The MD5 checksum for the attached call recording file.

The headers marked with a * are optional and could be empty depending on the type of recording. For example: if an identity call recording is done, the X-Compass-ExternalNumberId and X-Compass-ExternalNumber headers will be empty.

Note: next to the data in the headers, information about the call recording is also present in the body of the email, such as the numbers of the caller and callee. The information is simplified: if a call is routed through a queue or forward before call recording is triggered, the values may be different than expected.