5. Customer Self-Care Interfaces

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.

5.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://<ce-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.

5.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 4.3, “Creating Subscribers”. 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.

[Important]

You can simplify the login procedure for one SIP domain in such a way that users in this domain only need to pass the user part (e.g. user1) as a username instead of the full web username to log in by setting the parameter www_cscsite_domain in the config file /etc/ngcp-config/config.yml to the corresponding domain (e.g. 1.2.3.4) and execute ngcpcfg apply.

5.1.2. Site Customization

As an operator, you can change the appearance of the CSC panel by modifying a couple of parameters in the section www_cscsite_config of the config file /etc/ngcp-config/config.yml. Modify the site title, your company details and the logo to reflect your use case.

You can also enable/disable specific languages a user can choose from in the CSC panel. Currently, English (en) and Spanish (es) are supported and are activated by default.

After changing one or more of the parameters in this file, execute ngcpcfg apply to activate the changes.

5.2. The Vertical Service Code Interface

Vertical Service Codes (VSC) are codes a user can dial on his phone to provision specific features for his subscriber account. The format is *<code>*<value> to activate a specific feature, and #<code> or #<code># to deactivate it. The code parameter is a two-digit code, e.g. 72. The value parameter is the value being set for the corresponding feature.

[Important]

The value user input is normalized using the Rewrite Rules Sets assigned to domain as described in Section 4.5, “Configuring Rewrite Rule Sets”.

By default, the following codes are configured for setting features. The examples below assume that there is a domain rewrite rule normalizing the number format 0<ac><sn> to <cc><ac><sn> using 43 as country code.

  • 72 - enable Call Forward Unconditional e.g. to 431000 by dialing *72*01000, and disable it by dialing #72.
  • 90 - enable Call Forward on Busy e.g. to 431000 by dialing *90*01000, and disable it by dialing #90.
  • 92 - enable Call Forward on Timeout e.g. after 30 seconds of ringing to 431000 by dialing *92*30*01000, and disable it by dialing #92.
  • 93 - enable Call Forward on Not Available e.g. to 431000 by dialing *93*01000, and disable it by dialing #93.
  • 50 - set Speed Dial Slot, e.g. set slot 1 to 431000 by dialing *50101000, which then can be used by dialing *1.
  • 55 - set One-Shot Reminder Call e.g. to 08:30 by dialing *55*0830.

You can change any of the codes (but not the format) in /etc/ngcp-config/config.yml in the section semsvsc. After the changes, execute ngcpcfg apply.

[Caution]

If you have the EMTAs under your control, make sure that the specified VSCs don’t overlap with EMTA-internal VSCs, because the VSC calls must be sent to the NGCP via SIP like normal telephone calls.

5.3. The Voicemail Interface

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.

[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 4.5, “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.