4. Customer Self-Care Configuration

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.

4.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 and trigger calls using the click-to-dial feature.

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 3.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.


	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_csc→site_domain in the config file /etc/ngcp-config/config.yml to the corresponding domain (e.g. `1.2.3.4`) and execute `ngcpcfg apply`.

Site Customization

As an operator, you can change the appearance of the CSC panel by modifying a couple of parameters in the section www_csc→site_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.

4.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.


	The value user input is normalized using the domain rewrite rules defined in the section called “Defining Domain Dialplans”.

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 sems→vsc. After the changes, execute ngcpcfg apply.


	Note that you can also change the parameter voicemail_number in this section of the config file. If you use a Call Forward VSC with this number, the forward is set to the Voicebox. E.g. when setting this parameter to 9999, a Call Forward Unconditional to the Voicebox is set if the user dials `729999`.


	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.