Personalized cloud PBX calling

Link copied to clipboard

This functionality allows cloud PBX users to make toll calls from any SIP phone in the office using their own authorization code (PIN number).

When an office worker makes a call from his colleague’s phone, he is prompted to enter some additional authorization code to identify himself so that this call’s charges are applied to his account. This way a cloud PBX owner can see who actually made the call and who was charged for it.

This functionality prevents service abuse and enables individual accountability for each user’s account.

Consider the following scenario as the configuration example. Customer Smart Calls, Ltd. want their employees to make toll calls only after they enter an authorization code. Let’s say that some of their employees have the following accounts and PIN numbers:

  • Rachel – 17785551209 and 4545.
  • Mark – 17785551210 and 8989.

When Rachel makes a toll call from Mark’s SIP phone, she is prompted to enter the additional authorization code. She enters her PIN number and the call is put through. When the call ends, PortaBilling applies the charges and creates xDRs for both accounts. Mark’s account is charged for the call to the IVR and Rachel’s account is charged for the toll call. You can see the call records on the account self-care interface or on the account xDR page.

When Rachel makes a call to her colleague Jake or makes a toll-free call, this call is then initiated without additional authorization.

Since toll calls pass through the IVR application in this scenario you must specify the associated number that is identical for all accounts that use this functionality. This associated number is then sent back to the IVR in an authorization confirmation.

For user identification, create aliases for the accounts with IDs that include an account’s associated number (the part of the phone number in our example) followed by the # symbol and an authorization code (e.g., 1778555#4545, 1778555#8989, etc.).

Checklist

Link copied to clipboard

Print this page and use it 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. Make sure to first perform the basic cloud PBX scenario configuration according to the Cloud PBX Services handbook.

Operation

Done

IVR configuration

Create the Pass-Through IVR application.

Configure the IVR application.

Create accounts

Create the first account.

Configure the Associated number for this account.

Enable the IVR application for the account. Add an alias for this account.

Configure the second account.

Testing

Browse the xDR records for accounts.

Create the IVR application

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

    Dashboard

  2. On the Create voice application panel, fill in the following fields:
    • Name – specify the IVR application’s name (e.g., Roaming PIN).
    • Application type – choose Pass-through IVR.

      Create the IVR application

  3. Click the Save button.

    Configure the application settings

Configure the IVR application

Link copied to clipboard
  1. On the Voice application panel, go to the Authentication, Authorization, Accounting section, then select Authorization and enable the following options:
    • Authorize paid calls to enable additional authorization for toll calls.
    • Treat auth code as part of account ID for billing outgoing calls to separate accounts which are made from a shared phone.
    • Use associated number to produce auth ID to authorize the user via the associated number and authorization code.

      Configure the application settings

  2. Click Save.

Create accounts

Link copied to clipboard

This configuration requires a credit limit for the customer. If the credit limit has already been set, you may go directly to the Customer page to continue the configuration, otherwise set a reasonable credit limit for the customer.

Create an account for the customer and define the associated number for it.

Create the first account

Link copied to clipboard
  1. On the navigation menu, select Sales, then select Customers. Note that if you have not yet created a customer, consult the Create a Customer section of the Cloud PBX Services handbook.
  2. On your customer’s panel, click Accounts.
  3. On the Create an account panel, fill in the account information:
    • ID – SIP ID, i.e., the phone number that is used to log in to the SIP server and receive incoming calls (e.g., 17785551209).
    • Account role – select the type of account. Select Universal from the list.
    • Product – choose the main product, which you would like your account to have.

      Please refer to the Basic Residential VoIP Service handbook for a detailed description of creating an account.

      creating account

  4. Click Save.

Enable the associated number

Link copied to clipboard
  1. On your account’s panel, click Services and select Service configuration.
  2. On the Service configuration panel, select Voice calls.
  3. Enable Associated number option and specify the first part of the phone number (excluding the last four digits) as an associated number. This is used for creating the first part of the authentication ID and should be the same for all of a customer’s accounts.

    associated number activation

Enable the IVR application

Link copied to clipboard
  1. Go to the Outgoing calls section.
  2. Enable Call via IVR option and select the previously created Voice application (e.g., Roaming PIN).

    Enable the IVR application

  3. Click Save.

Add an alias

Link copied to clipboard
  1. Go to the Aliases panel, click the Add button and specify the alias details:
    • Alias role – select Universal here.
    • Alias ID – specify the Associated Number#PIN (e.g., 1778555#4545) in this field.
    • Allow authentication – disable this option.

      alias creation

      You can specify any numbers to be used as Associated and PIN numbers. However, make sure that the Associated number is identical for all of a customer’s accounts while the PIN numbers must be unique for each account.
  2. Click Save.

Create the second account

Link copied to clipboard
  1. Repeat steps 3-10 to create the account 17785551210.

    call via IVR enabling

  2. Go to the Aliases tab and add the Associated Number#PIN (e.g., 1778555#8989) as an alias.

    alias creation panel

  3. Click Save.

Testing

Link copied to clipboard
  1. Configure your SIP user agent with account 17785551209’s ID and password. (For more details, refer to Test the whole system section of the Basic Residential VoIP Service handbook.) Then have your SIP user agent log in to the SIP server.
  2. Make a call from this account using the 8989 authorization code.
  3. Go to account 17785551209’s xDR page and browse the xDRs.

    For a more detailed description, please refer to the Verify Call History for an Account section of the Basic Residential VoIP Service handbook.

    Browse the xDRs for the account

  4. Go to account 17785551210’s xDR page and browse the xDRs.

    Browse the xDRs for the account

  5. Go to the customer xDR page and browse the xDRs.

    Browse the xDRs for the customer

On this page

Release
What's new
Admin manuals
Handbooks
Developers documentation
UI help