Setting up WEB callback services

There are three types of WEB callback:

• Simple – the user provides his account ID and phone number. When a callback is requested, he is connected with a predefined number (e.g. a helpdesk of the service provider).
• Extended – the user provides his account credentials (account ID and password) and phone numbers: one he wants to be called back at and the one he wants to dial.
• Hosted – the user provides the phone number where he can be reached. When the callback is requested, he uses the IVR prompts for further actions (e.g. to check his balance, enter a destination number, etc.)
  Since for the hosted WEB callback, the first outgoing call is established without authentication, to prevent service abuse make sure that unauthorized users are not allowed to access the WEB callback trigger for hosted mode.

This chapter demonstrates how to configure the WEB callback by performing the following steps in the example below:

1. A user from Brazil wants to make a call to the USA. He goes online and enters his account credentials (account ID and password), a phone number where he can be reached, and the US destination number.
2. Next, he needs to reach the helpdesk, so he enters his account ID and the phone number where he can be called back.

Use this checklist to check off the operations you have completed while performing the system setup according to the instructions in this chapter. Please be sure to perform all of the operations in the order designated (all of the boxes should be checked), otherwise, the service will not work.

Follow the steps described in the Setting up callback services. General configuration handbook that describes the initial instructions for configuring callback services.

1. On the navigation menu, select Infrastructure, then select Voice calls processing and go to Voice applications.

    

2. On the Create voice application panel, fill in the following fields:
   • Name – specify the name (e.g. Web callback).
   • Application type – choose Web callback trigger.

     

3. Click Save.

1. On the Voice application panel, go to the Entry point panel and specify Callback page web address. This address will be provided to your users for initiating callback calls in this format https://<host>:8901 (where host is either a domain name or an IP address of the web server (the admin interface hostname), and 8901 is the port where the WEB callback operates).

   

2. Go to the Authentication, Authorization, Accounting section and configure the following parameters:
   • On the Authorization panel, put a cursor in to The second number to connect field and specify the number end users will be connected to when using a Simple WEB callback (e.g. the phone number of your helpdesk).

     

   • On the Accounting panel, specify the access code that will allow the PortaBilling to use a special tariff for callback charging. For WEB callback, the default access code value is WEBCALLBACK.
   • Internal account – Specify the internal account. During the hosted Web callback, this account is used for authentication and is charged for call legs.

     Enable the Special charge if LegB fails option to use a special tariff to charge for legA if a call to a destination number (legB) cannot be established (e.g. if the destination number is busy or not answering).

     

   • On the Translation rules panel, put a cursor into Account ID translation rule field and specify the translation rule as a Perl expression that will convert the number of the calling party. This rule will be applied to the number if the option Use Account ID as ANI is selected.

     

     In order to prevent confusion and clearly distinguish between accounts used for residential SIP services and for callback services, it is recommended that a naming convention be used. One good example of a naming convention is to use the prefix “cb” for your callback accounts. A corresponding translation rule (e.g. s/^/cb/) will add the prefix “cb” to the calling number and the ANI authenticated account will be the one initiating the callback call that will be charged once the call is completed.

     Please refer to the Prepaid calling IVR applications section to read more about the callback calling IVR configuration parameters.

3. On the Prompts & notifications panel, go to the Prompts customization section and specify the folder name with your custom IVR prompts. These prompts will be used instead of the default ones. Please refer to the How to... section for a detailed description of how to upload and use custom IVR prompts.

   

4. On the Application specific panel, enable the Use account ID as ANI option to show the account ID (i.e. PIN) as the calling number.

   

5. Click Save.

At this step it is necessary to create a tariff according to which your customers will be charged when using callback services.

A callback call consists of two parts (call legs): a call to the calling party (legA) and a call to the destination number (legB), therefore this tariff is used to create charges for both call legs. The total charge for the whole callback call is the sum of charges for call legA and call legB.

1. On the navigation menu, select Service catalog and click Tariffs.
2. On the Create tariff panel, fill in the tariff details:
   • Name – type a short name for the tariff object; this is the name you will see in the select menus, (for example, Callback).
   • Currency – this indicates the currency in which you charge your customers.
     The currency for the tariff is chosen only once, and cannot be changed later.
   • Service – select Voice calls.
   • Applied to – select Customer as this tariff will be used to charge your customers.
   • Managed by – select Administrator only here, since we are setting up a service without the involvement of resellers.
3. Click Save.
   You can charge separately for call legs. Please refer to the How to… section for a detailed description of the necessary steps for setting that up.

Since a callback call consists of two parts (call legs), rates for both call leg destinations need to be entered into the tariff.

1. On your customer tariff’s panel (Callback), click Rates.

   

2. On the Add rate panel, fill in the rate details:
   • Destination – select a destination prefix from the list or type it directly, (e.g. 1818 for Canada).
     You must create an entry for certain phone prefixes in the Destination register before creating a rate for them in the tariff.
   • Rating mode – select the Flat rate option here. If you want to enter different rates for the peak and off-peak periods, select the Separate peak / off-peak rate option.
   • First interval, seconds – type a first billing unit in seconds.
   • Next interval, seconds – type the next billing unit in seconds.
   • First price – type a per minute price for the first interval.
   • Next price – type a per minute price for the next interval
   • Off-peak first interval – type a first billing unit in seconds for off‑peak time.
   • Off-peak next interval – next billing unit in seconds for off‑peak time.
   • Off-peak first price – type a per minute price for first interval for off‑peak time.
   • Off-peak next price – type a per minute price for next interval for off-peak time.
     Off-peak fields appear only if the Separate peak / off-peak rate rating mode is selected or an off-peak period has already been assigned to this tariff on the General info panel
   • Rate formula – type a custom rating formula.
   • Effective from – if you want this rate to take effect sometime in the future, you can either type in a date manually, or use the calendar (click on the DD-MM-YYYY link)
     When using the calendar, you can specify that the date you are entering is in a different time zone than your present one. PortaBilling will then automatically adjust the time.
3. Click Save.
4. Repeat these steps to enter more rates.

Accounts for accessing callback services will have a specific product assigned to them. Products are powerful tools that define different ways for billing accounts. Product definition is always done using these steps: product type definition, service definition and configuration and creation of a rating list.

1. On the navigation menu, select Service catalog and click Products.
2. On the Create product panel, fill in the product details:
   • Name – type an internal product name that will be shown on the administrator interface.
   • Name visible to end users – type a name of the product that will be shown to end users on their self-care interfaces.
   • Product type – select Main product here.
   • Currency – choose a currency the product will be priced in.
   • Managed by – select Administrator only here, since we are setting up a service without the involvement of resellers.
   • Account default ACL – choose an Access Control List (ACL) for accounts with this product assigned. ACLs control which objects end users can access to and which actions they can perform.
   • Account role – select Universal from the list.
3. Click Save.

Define which service types are included in the product. A service type is a description of the physical service provided to end users.

To add a service type:

1. On your product’s panel, click Services.
2. On the Services panel, click Add a service.
3. In the Select services to add dialog box, select Voice calls and click Add.

The rating list has two functions: it defines permitted access points (nodes and access numbers) and specifies which tariff should be used for billing in each of these points.

1. On your product’s panel, click Charges, then click Usage charges.
2. On the Usage charges panel, click Add.
3. Fill in the required information:
   • Service – select Voice calls.
   • Node – Sselect the PortaSIP node.
   • Access code – type in the WEBCALLBACK access code here. You can also leave this field empty; the system will automatically select this tariff when charging for WEB callback services.
   • Tariff – select the tariff that will be used to calculate the charges for callback calls.
   • Overdraft protection – to configure overdraft protection for this product, consult the Configure overdraft protection section within the product section in the Overdraft protection configuration handbook.
4. Click Save.

1. Click Add to enter another rating entry. This rating entry will define what tariff should be selected if one of the call legs fails to be established (e.g. the destination number is busy or not answering).
2. Fill in the required information:
   • Service – select Voice calls.
   • Node – select the PortaSIP node.
   • Access code – type in the CALLBACK_FAIL access code here.
   • Tariff – select the callback tariff for unsuccessful calls.
     You can use a special tariff for this rating entry (e.g. if you do not charge your customers for unsuccessful calls to destination numbers, create a separate tariff and enter a rate of zero for a “|” wildcard destination in it). Find the description of the tariff creation and rates enter in the sections above.

      

     

3. Click Save.

A customer owns their accounts. As a rule, Callback is provided as a prepaid service, so invoices are not issued. However, you will still need at least one customer object in order to keep all the accounts organized in one location.

1. On the navigation menu, select Sales, then select Customers.
2. On the Create customer panel, fill in the customer details:
   • Name – type a short name for the customer object; this will be used on the web interface.
   • Balance control – select Postpaid.
   • Currency – choose the currency in which this customer will be billed.
   • Credit limit – specify the credit limit value for this customer.
   • Business model – a business model defines what type of service is to be provided to the customer. Select Universal for this customer.
   • Customer class – customer class allows you to define a policy for automated payment collection. By choosing a specific class here the customer will automatically inherit all of the class properties (grace period, invoice template, etc.).
   • Billing period – choose a billing period for the customer. A billing period defines the frequency of invoicing for this customer.
   • Billing period time zone – choose a time zone in which customer’s billing period will be closed and invoices will be generated.

     

3. Click Save.

1. On your customer’s panel, click Accounts.
2. On the Create an account panel, click Account generator.
3. In the Account generation dialog, fill in information about accounts.

• Account role – the defined usage for the account. Select Universal from the list.
• Type – select Debit.
• Product – choose the main product, which you would like your account to have.
• Quantity – number of accounts (callback cards) to be generated.
• Batch – accounts are grouped into batches. If Add a new batch is selected, all accounts will be placed into a new batch. Otherwise, an existing batch should be selected from the drop-down list.
• New batch name – type a name for the new batch.

• Opening balance – the initial balance on the card.
• Requires manual activation – it is normal practice to generate all prepaid cards as inactive so they cannot be misused before being sold to the dealer or end customer. You can always activate the whole batch of cards or an individual card later. If you plan to assign the cards to a distributor later on, the cards must be generated as inactive. Move the slider to the right to generate as inactive.
• Generation method – the Random method means that every account will be assigned a unique, randomly-generated PIN.
• ID prefix – type in cb prefix to distinguish generated accounts for callback services from accounts used for the basic SIP service. If you would like all of the generated accounts to start with the same digit string (e.g. cb1818), enter it here. Thus, if you enter 12 and an ID length of 9, account IDs (PINs) will look like this: cb1818NNNNN, where N = random digits.
• ID length – all account IDs (PINs) will be numerical and of the specified length. In order to avoid problems with the prepaid card print-shop, PortaBilling will not generate account numbers with a leading zero. Also, PortaBilling will only allow generation of a batch with feasible parameters, e.g. it is impossible to generate a batch of 1,000 accounts with ID length 4 and ID starting at 55.
• Service password – to improve security, you can use the complete account information, i.e. account ID and password, for authentication in an email callback. Click Auto generated so that service passwords are automatically generated.
• Distributor – you can assign a specific distributor to this group of accounts.
• Life cycle:
  • Activation date – the date from which the account is usable.
  • Expiration date – the date that the account expires.
  • Availability period after first usage, days – defines the number of days the account remains active after its first use or recharge.
  • Availability period after last usage, days – defines the number of days the account remains active after its last use or recharge.
• E-Commerce enabled – if selected, this will allow debit card owners to make online payments via the PortaBilling web interface (leave unselected.)
• Web self-care:
  • Credentials – if you choose Auto-generated, your customer will use his account ID (PIN) to login to the self-care pages; a random password for web access will be assigned for each account. If you choose Empty, the account owner will not be able to use the self-care pages at all until a login has been assigned for his account; no password will be assigned, so account owners will be able to login to the web interface simply by providing their account ID (PIN).
  • Time zone – when an account owner accesses the web self-care pages to see a list of his calls, the time will be shown in the time zone most appropriate for him.
  • Web interface language – the language to be used on the account self-care web interface.
    Account generation tasks are executed every few minutes and it may take a while to generate large numbers of accounts.

    

 In case the original email message was lost or accidentally deleted, the file containing generated accounts is stored on the PortaBilling web (admin) server in the /porta_var/<Server_IP>/ directory, sub-directory cards.

If a user enters an invalid account ID (PIN) when using a hosted callback, the call will not be established. However, the call to the number of the calling party will have already been established and will need to be handled correctly, i.e. this call must be charged to an account and an xDR must be created for this session. How can this be done if no account ID is provided? The so-called internal account is used for this purpose.

To keep the accounting organized, it is recommended that an internal account be created that PortaBilling can use to charge for such “partially made” calls.

1. On your customer panel, click Accounts.
2. On the Create an account panel, fill in the account details:
   • ID – specify in the Internal account field of the WEB callback trigger instance.
   • Account role – select the type of the account. Select Universal from the list
   • Product – select the product you just created (Callback Services).
   • Activation date – leave the default value as is. The account will immediately be activated.
   • Service password – specify the service password for this account. It is very important to assign a secure (difficult to guess) password to prevent the account from being wrongfully entered and used to inject fraudulent calls to your network.
   • Type – select Credit.
   • Balance control – select Subordinate.
3. Click Save.

1. Go to the web page using the web address specified in the WEB callback trigger instance.
2. Select Extended type.
3. Specify the credentials (account ID and password) of your account for callback.
4. Specify the number you want the system to call you back at and the destination number you wish to dial.
5. Click Connect Us Now!

1. While on the web page for callback services, select Simple type.
2. Specify your account ID and the number you want to be called back at.
3. Click Call Me Now!

Let’s say an employee of a company is on a business trip in Brazil and needs to reach his office. Instead of paying for expensive international calls, he can “order” the call from the office to his mobile.

1. While on the web page for callback services, select Hosted type.
2. Specify the number you can be called back at.
3. Click Call Me Now!