Phone App Configuration

The following information describes how to modify the phone apps that are displayed on screen.

• For new FreePBX / PBXact installations, where the default Sangoma Phone template has not been modified, the phone's display will appear similar to the image below.
  ( we will discuss the Sangoma Phone template below)

• As noticed from the image above, no phone apps are assigned to the buttons. Since phone app assignment is customizable we allow the user to customize.

• To customize the phone apps to be displayed on phone's screen, we need to modify the default Sangoma Phone template

• Log into your PBX GUI.

• Under the Settings section, pick EndPoint Manager.

Open

• In the right nav menu, under Brands, click on Sangoma

• Click on the default-sangoma template name to edit the included default template or any other template that you want to edit.

• Click on the 'Models' tab to list the available Phones, then select the phone model.
  
  

  Open

  

   

• You will be presented with a view of all available programmable buttons for that phone model.
  
  example from S700

   

• The first 2-3 buttons should always be set up as line keys. A line key is what allows you to make or receive a call, so if you want to manage two calls at a time, you need to set up two line keys.
  
  

• If you wish to add more Line keys, beside the line key number, select the Type drop down,  and choose Line.
  
  

• For the remaining buttons on your phone, assign whichever phone apps you wish, to each button.  

• To assign a phone app, beside the line key number, select the Type drop-down, and choose XML-API
  
  Example for Line key 5 on S700:

  
   

• Click on the Value drop-down beside the line key and select the phone app you wish to assign to that line key
  
  

   

  • Once selecting the phone app the line key will be updated with the phone app.
    In the below image, the Call Flow phone app was chosen for line key 5

     

• Finish selecting the phone app you wish to assign for each button

• Once completed, your phone app view would look something like the following image, based on the phone apps chosen
  
  

   

• When done editing, press the Save Model button to save your settings for this model.
  
  

• You now need to update the phone configuration file. Choose an option and click the Apply button. The three options at the bottom of the template are:

  • Save- This will only save your changes into the PBX database. It will not write out new config files for the phones that are using this template as mapped in the Extension Mapping section of End Point Manager.
    
    

     

  • Save and Rebuild Config(s)- This will save your changes to the PBX Database and also write out new config files for the phones that are using this template as mapped in the Extension Mapping section of End Point Manager. The phones do not retrieve the updates and will need to be rebooted to get their update.
    
    

     

  • Save, Rebuild Config(s) and Update Phones- This will save changes into the PBX database, write out new config files for the phones, and also immediately update any phones that are mapped to use this template and currently registered to the PBX. This may cause the phones to reboot in rare instances but while the phone is processing the updated config for 5-10 seconds the buttons will not be usable on the phone.
    
    

     

• The Phone apps on the phone's display should now be presented by each button. Below is a screenshot of a phone with some phone apps configured.
  
  
  

   

• For information on how to use each phone app, visit: Application Userguides