7. Customer Self-Care Interface and Menus

7.1. The Customer Self-Care Web Interface
7.1.1. Login Procedure
7.1.2. Site Customization
7.2. The Voicemail Menu

There are two ways for end users to maintain their subscriber settings: via the Customer Self-Care Web Interface and via Vertical Service Codes using their SIP phones.

7.1. The Customer Self-Care Web Interface

The NGCP provides a web panel for end users (CSC panel) to maintain their subscriber accounts, which is running on https://<ngcp-ip>. Every subscriber can log in there, change subscriber feature settings, view their call lists, retrieve voicemail messages and trigger calls using the click-to-dial feature.

7.1.1. Login Procedure

To log into the CSC panel, the end user has to provide his full web username (e.g. user1@1.2.3.4) and the web password defined in Section 5.3, “Creating a Subscriber”. Once logged in, he can change his web password in the Account section. This will NOT change his SIP password, so if you control the end user devices, you can auto-provision the SIP password into the device and keep it secret, and just hand over the web password to the customer. This way, the end user will only be able to place calls with this auto-provisioned device and not with an arbitrary soft-phone, but can nonetheless manage his account via the CSC panel.

7.1.2. Site Customization

As an operator (as well as a Reseller), you can change the branding logo of the Customer Self-Care (CSC) panel and the available languages on the CSC panel. This is possible via the admin web interface.

7.1.2.1. Changing the Logo

For changing the branding logo on a reseller’s admin web page and on the CSC panel you just need to access the web interface as Administrator and navigate to Reseller menu. Once there click on the Details button for your selected reseller, finally select Branding.

In order to do the same as Reseller, login on the admin web interface with the reseller’s web credentials, then access the Panel Branding menu.

The web panel customisation happens as follows:

  1. Press the Edit Branding button to start the customisation process.
  2. Press the Browse button to select an image for the new logo:

    CSC Customisation Step 1: Select an image

    Figure 54. CSC Customisation Step 1: Select an image


  3. Press the Save button to save changes.
  4. Select and copy the auto-generated CSS code from the text box below the uploaded image:

    CSC Customisation Step 2: Copy CSS code

    Figure 55. CSC Customisation Step 2: Copy CSS code


  5. Press the Edit Branding button again.
  6. Paste the CSS code into CSS text box and Save the changes:

    CSC Customisation Step 3: Paste CSS code

    Figure 56. CSC Customisation Step 3: Paste CSS code


  7. Now the new logo is already visible on the admin / CSC panel. If you want to hide the Sipwise copyright notice at the bottom of the web panels, add a line of CSS code as shown here:

    CSC Customisation: Hide copyright notice

    Figure 57. CSC Customisation: Hide copyright notice


  8. The final branding data is shown on the admin web panel:

    CSC Customisation: Custom data on panel

    Figure 58. CSC Customisation: Custom data on panel


7.1.2.2. Other Website Customisations

The layout and style of NGCP’s admin and CSC web panel is determined by a single CSS file: /usr/share/ngcp-panel/static/css/application.css

More complex changes, like replacing colour of some web panel components, is possible via the modification of the CSS file.

warning

Only experienced users with profound CSS knowledge are advised to change web panel properties in the main CSS file. Sipwise does not recommend and also does not support the modification of the main CSS file.

7.1.2.3. Selecting Available Languages

You can also enable/disable specific languages a user can choose from in the CSC panel. Currently, English (en), German (de), Italian (it), Spanish (es) and Russian (ru) are supported, and the default language is the same as the browser’s preferred one.

You can select the default language provided by CSC by changing the parameter www_admin.force_language in /etc/ngcp-config/config.yml file. An example to set the English language as default: force_language: en

7.2. The Voicemail Menu

NGCP offers several ways to access the Voicemail box.

The CSC panel allows your users to listen to voicemail messages from the web browser, delete them and call back the user who left the voice message. User can setup voicemail forwarding to the external email and the PIN code needed to access the voicebox from any telephone also from the CSC panel.

To manage the voice messages from SIP phone: simply dial internal voicemail access number 2000.

To change the access number: look for the parameter voicemail_number in /etc/ngcp-config/config.yml in the section semsvsc. After the changes, execute ngcpcfg apply 'changed voicebox number'.

tip

To let the callers leave a voice message when user is not available he should enable Call Forward to Voicebox. The Call Forward can be provisioned from the CSC panel as well as by dialing Call Forward VSC with the voicemail number. E.g. when parameter voicemail_number is set to 9999, a Call Forward on Not Available to the Voicebox is set if the user dials *93*9999. As a result, all calls will be redirected to the Voicebox if SIP phone is not registered.

To manage the voice messages from any phone:

  • As an operator, you can setup some DID number as external voicemail access number: for that, you should add a special rewrite rule (Inbound Rewrite Rule for Callee, see Section 5.7, “Configuring Rewrite Rule Sets”.) on the incoming peer, to rewrite that DID to "voiceboxpass". Now when user calls this number the call will be forwarded to the voicemail server and he will be prompted for mailbox and password. The mailbox is the full E.164 number of the subscriber account and the password is the PIN set in the CSC panel.
  • The user can also dial his own number from PSTN, if he setup Call Forward on Not Available to the Voicebox, and when reaching the voicemail server he can interrupt the "user is unavailable" message by pressing * key and then be prompted for the PIN. After entering PIN and confirming with # key he will enter own voicemail menu. PIN is random by default and must be kept secret for that reason.