Service guide

Calling card service guide

MyVoipApp support team

Copyright: MyVoipApp, Inc. All rights reserved.

Table of contents

1Introduction

"Calling card" is a virtual card service. It is more like a prepaid account which users can use it to make outgoing call in any SIP clients who have been connected to MSS. With "calling card", the balance is control. Each calling card has some balance. If the balance is not enough, the user cannot use it to make outgoing call. When one call is finished, some fee will be decreased from the balance.

In another way, MSS can limit some SIP clients to make outgoing call; the feature is "call level". User can use "calling card" to suppress the call level and make outgoing call.

In miniSipServer (MSS), the default called number prefix for "calling card" is "*300*". That means the calling card service will be triggered if the user dials "300*". Below figure describes the basic process of this service.

MSSversion 2.5 or above (for 100 clients or for 1000 clients) can support this service. Please download it from http://www.myvoipapp.com.

We need configure MSS to support this service. These configurations include:

1. Connect to database.MSS uses MySQL as its default database.

2. Limit some called numbers can only be routed successfully through calling card;

3. Configure charge information, such as fee matrix;

4. Configure card information, such as card number, password and balance, etc.

1.1Abbreviations

DB MySQL database.

MSS miniSipServer

2Basic Configuration

2.1Remote database

In current phase, MSS can only connect to MySQL database (please download MySQL from http://www.mysql.com/ and install it firstly).

Please click menu “DataSystem informationRemote database” and configure the parameters according to your MySQL configurations.

2.2Limit called number

In default, all called numbers in MSS can be routed for all local users. If we want to deploy calling card service, of course, some called numbers or all called numbers must be limited. For example, we can limit users that they cannot make out-group call but they can do it through calling card.

What we should do is set 'call level' for such called number. Please click menu "Dial plan->Called analysis” and select or add called prefix to edit. For example, we limit the call level for “external line” call to 1. That means the call will success if the user has “call level 1” right or through “calling card” service.

2.3Charge information

Since “Calling card” is a prepaid service, it is important to configure prepaid information. It includes following configuration: (1) Configure prepaid rate; (2) Configure fee matrix.

2.3.1Prepaid rate

Please click menu “ServicesCalling cardPrepaid rate” and prepare to add a new prepaid rate.

For an example, “ID=1; Interval=60; Tariff=10”. It means that MSS should reduce 10(coin, USD and so on) from the card’s balance every 60 seconds.

2.3.2Fee matrix

Please click menu “ServicesCalling cardFee matrix” and prepare to configure how to calculate fee.

For examples:

We configure following records in the “caller prepaid” table.

Then, we can see which rate will be applied in following cases.

1. Call “101”, the rate ID “2” will be applied.

2. Call “102”, the rate ID “1” will be applied.

3. Call “9xxx”, the rate ID “1” will be applied

4. Call “1011”, the rate ID “2” will be applied.

2.4Card information

A card always includes following information: card number, password for this card and balance.

Please click menu “Services->Calling card->Card information” to add or edit a card information.

3Advance configuration

3.1Announcement files

As described in chapter “Introduction”, several audio will be played to caller party. These audio are record in English default. All audio files are installed in directory “mss_install_directory\ann”. You can replace them as you want.

Below table describes the audio files and their contents.

3.2CDR

A table will be created in MySQL database to store all CDRs of these calling cards. The table is ‘tbl_callingcard_cdr’. The advance user can visit or query it directly.