What’s new in MR122

Link copied to clipboard

New set of SIM card events sent to an external web application

Link copied to clipboard

MVNOs pass SIM card information to their host MNO’s network to activate SIM cards for their subscribers. Now, SIM card provisioning becomes easier to implement with a new set of simplified SIM-related provisioning events and variables relevant to mobile subscriber provisioning. 

This set has been introduced in PortaBilling for the webhook-based provisioning used by the universal EventSender handler, including:

  • SIM/Created
  • SIM/Updated
  • SIM/Deleted
  • SIM/Replaced

Simplified events mean that admins can now configure the EventSender handler to send one event (SIM/Updated) to an external application, notifying it at once about several changes in the SIM profile, such as status change from “In use” to “Disposed”, default PIN change, or product replacement. 

The simplified version of the EventSender events is enabled by default, admins can explicitly see the full list of simplified events and subscribe to the required ones on the PortaBilling web interface. Simplified provisioning events allow developers to build external applications faster and easier, ensuring a saving of resources with application development.

EXAMPLE
An MVNO operates using the network infrastructure of a host Mobile Network Operator (MNO). To manage subscribers within the mobile core, the MVNO uses an external application integrated with the MNO’s PCRF (Policy and Charging Rules Function).
To track changes in subscribers’ records in PortaBilling, an admin subscribes the EventSender handler to the SIM/Updated event. When a subscriber logs into the self-care portal and upgrades their default service package to the Premium package, the subscriber’s record is updated in PortaBilling. As a result, PortaBilling sends a SIM/Updated event to the external application. The external application receives the event, identifies the affected subscriber, and connects to the MNO’s PCRF to apply the updated service policy in real time, activating Premium-level data, voice, or messaging rules on the mobile network.
Benefit

Service providers save costs and resources on mobile services provisioning to MNO’s core.

Subscription to the simplified events (version 2) for the EventSender handler

Link copied to clipboard

Simplified provisioning events in the EventSender handler are now available in the PortaBilling web interface. Events are grouped by category (e.g., Account) and can be enabled individually. For example, the Account/Bundle/Changed event can be activated with one click. This reduces setup time for webhook-based provisioning by letting admins view and configure events directly in the UI.  

Admins can also filter events by category across all event handlers in PortaBilling, making configuration faster and more precise.

EventSender handler subscriptions

Additionally, the EventSender handler now clearly indicates which version of the event is being used for provisioning – standard (v.1) or simplified (v.2). The configuration of the EventSender handler is done via the Event handlers in the PortaBilling web interface.

Benefit

Admins save time on setting up external provisioning.

Transcription of voicemail messages

Link copied to clipboard

You can now use AI-driven speech-to-text services to offer automated voicemail transcriptions to your customers. This is especially useful for cloud PBX and call center users – when they are unable to listen to audio messages, they can quickly read the message instead.

Voicemail transcriptions use the same Add-on Mart module as call recording transcriptions. When a new voicemail is received, the audio is automatically transcribed by a speech-to-text service. Using the PortaBilling API, you can display both the voicemail audios and the transcriptions in your own account self-care portal or mobile app. You can also allow users to configure an external email address and receive voicemail transcriptions directly by email.

As with call recordings, voicemail transcription can be monetized as an add-on subscription or included in a usage-based bundle with a specific number of hours of recorded calls and voicemails.

Requirements
The existing Add-on Mart module for the OpenAI Whisper service – already used for transcribing call recordings – now also supports voicemail transcription in all major languages. If you want an integration with your preferred speech-to-text transcription service, contact our support team. If you develop your own integration with a 3rd party speech-to-text service, contact our sales team to publish it on Add-on Mart.

To use the speech-to-text transcription of voicemails and call recordings:

  1. Sign up for an account with an external service (Whisper)
  2. Subscribe for the corresponding module in Add-on Mart
  3. Configure the integration:
    1. Obtain an API key from the external service and enter it in the Add-on Mart module’s Configuration UI
    2. If this is the first module you activate, specify the Add-on Mart credentials in PortaBilling
EXAMPLE
Emma, a sales representative, often works on the go and can’t always listen to voicemails, so she has voicemail transcription enabled on her account. While she’s in a client meeting, a prospect leaves her a voicemail. The system immediately processes the recorded message and runs it through the speech-to-text service. Later, when she’s available, Emma checks her email and sees a notification with the caller’s number, the transcription, and the attached voicemail audio. Emma quickly reads the transcription: “Hi, this is Mark. I’m interested in buying a water filter from you and want to know more about your products.” She calls Mark to follow up on her way to the office – no need to listen to the recording.
Benefits
  • Service providers can expand their cloud PBX or call center offering with voicemail transcription and generate additional revenue.
  • End users can read voicemails at a glance and respond quickly.

Call activity reports

Link copied to clipboard

Call center admins and supervisors (managers) can now view activity reports of their agents. These reports help track agent productivity and assess support quality by highlighting unusually low or high talk time. For example, low talk time may suggest that an agent is rushing through calls, while high talk time may indicate difficulty in handling the calls.

The newly introduced call activity reports show total talk time over a selected period and can be filtered by hunt group, agent, and call type (incoming or outgoing). Additional metrics such as average handle time, hold time, and waiting time in the queue will be added soon.

If you want your custom portal to display call activity reports, you can use the new Customer/get_call_activity_metrics method of the PortaBilling API. The new feature will be available in the CloudPBX Self-Care Portal (accessible via the Add-on Mart) in future releases.

EXAMPLE
Lisa is a supervisor at a customer support call center. She wants to assess how efficiently her agents handle customer calls and identify those who may need coaching. She logs in to the call center portal and views a call activity report for the past week. The report shows total talk time for each agent. Lisa sees that one of her agents, John, handled 50 calls with a total talk time of just over two hours. She estimates that his average call duration is under 3 minutes. Curious about the short calls, Lisa listens to several of John’s recordings and finds that he often rushes callers and transfers cases without proper troubleshooting. Using this insight, Lisa provides targeted feedback to help John improve his skills.
Benefit

Call center and PBX admins can measure agent performance.

Configuration

To allow viewing call reports, admins should open the PortaBilling web interface and enable the Advanced hunt group call tracking feature (Customer > Services > Voice calls).

By default, the call reports can be generated during the two-month period after handling the call. To increase this period, go to the Configuration web server interface and set a new period for the Metrics.CallActivityMetricsKeepMonth option.

Announce the position for the first caller in the queue

Link copied to clipboard

With this release, the first caller, just like all other callers in the queue, is clearly informed about being queued. For this, a new prompt has been introduced – “Currently, you are the [position] caller in the queue”. This allows the first and other subsequent callers to know their exact position in the queue and thus reduce the number of abandoned calls. Previously, only the second and subsequent callers in the queue were informed about the number of callers ahead of them, meaning the first caller received no announcement.

EXAMPLE
John is a manager (PBX admin) in a medical clinic. He configures the call queue and enables the Announce the caller’s position in the queue option, so the patients are informed of their position in the queue. Jack, a patient at this clinic, calls reception to make an appointment. The receptionist is on a call with another patient. The announcement informs Jack that he is the first caller in the queue.

The custom portal should be adjusted to use the announce_position API parameter of the PortaBilling API to support the new functionality (will be available in the CloudPBX Self-Care Portal in future versions).

Benefits
  • Service providers can offer cloud PBX with better call queues.
  • Cloud PBX and call center customers can improve the caller experience.

Suspended status for debit accounts

Link copied to clipboard

With this release, accounts with insufficient funds to cover subscription charges are now automatically marked as Suspended. This means that services for such accounts have been automatically suspended, though the account can still access the self-care portal. Once the balance becomes sufficient to cover subscription charges, the account is automatically reactivated. 

Previously, such accounts were marked as Blocked, making it unclear whether the suspension was made by the system or manually by an admin. Now, administrators can clearly identify the reason for suspension and take appropriate action.

PortaBilling can also notify external systems, such as custom-built web apps or apps based on PortaOne Workflows integration, when debit accounts are suspended or reactivated due to insufficient funds. This allows those systems to display accurate account statuses to users and act upon them. For this, you can use the new Account/Status/Suspended and Account/Status/SuspensionRemoved provisioning events.

Former Account/Status/Suspended and Account/Status/SuspensionRemoved were renamed to Account/Status/CustomerSuspended and Account/Status/CustomerSuspensionRemoved to avoid confusion.

EXAMPLE
A service provider uses a CRM system integrated with PortaBilling to notify their subscribers about changes in their account status. John, a prepaid mobile subscriber, has the $30 monthly subscription “Triple Play Bundle” charged in advance. On June 1st, PortaBilling calculates the subscription charges for June ($30) and compares it with the available funds, e.g.,$20. Since the balance is insufficient, the user’s service is immediately suspended. PortaBilling sets the account status to “Suspended” and sends the Account/Status/Suspended event to notify the CRM system, which sends John a notification: “Your “Triple Play Bundle” wasn’t activated due to low balance. Please top up your account with at least $30 to activate the bundle.” John makes a $10 payment, so he now has $30 in available funds. PortaBilling charges the $30 subscription fee, removes the “Suspended” status from John’s account, and sends the Account/Status/SuspensionRemoved event to the CRM system. Subsequently, the CRM notifies John: “Monthly fee billed – your service is now active. Enjoy!”
Benefit

This enhancement reduces the risk of human errors and simplifies integrations with external systems.

Configuration

To automatically suspend debit accounts due to insufficient funds for pending subscription charges in PortaBilling, enable the Suspend debit accounts option on the customer class configuration. If you need to suspend all of the customer’s accounts, you can also enable the Suspend customers option.

the Suspend debit accounts option

To notify external applications about automatic suspension due to insufficient funds for pending subscription charges, use the new provisioning events for an account – Account/Status/Suspended and Account/Status/SuspensionRemoved.

To inform an external app when account records are manually blocked or unblocked by the admins, subscribe the event handler in PortaBilling to the existing Account/Blocked and Account/Unblocked events.

View all routing attempts on the Trace session page

Link copied to clipboard

Your engineers can now see each routing attempt for a call directly on the Trace session page. This makes it easier to quickly check for failed call attempts and identify underperforming vendor connections.

Previously, when a call was routed through several vendor connections (e.g., due to no response from the first connection), the system displayed only one aggregated call log. Now, engineers can switch the mode on the Trace session page to see each routing attempt (vendor xDR) as a separate record. To enable this, they simply go to the search settings and select Display xDRs > separately (search in vendor xDRs only).

Select the Display xDRs separately option

For each routing attempt, engineers can view the disconnect cause (e.g., Switching equipment congestion) to spot vendor-related issues and adjust routing rules to increase the percentage of successfully connected calls.

To help engineers quickly identify failed calls, a new Status filter has been added.

The Status filter

Plus, additional columns Country/Destination and Customer name (disabled by default) have been added to show more context for each entry.

EXAMPLE

A customer of Owl Telecom contacts customer service to report that several of their recent calls to South Africa were dropped. An engineer opens the Trace Session page and filters xDRs by destination and time. He sees that the system tried to route the call through a GlobalNet vendor connection, but the attempts failed with the message “Switching equipment congestion.”

To determine if this is part of a larger issue, the engineer searches for other recent calls to South Africa. The page returns several failed calls from different customers, all routed through GlobalNet. Based on this, the engineer updates the routing settings to prioritize other vendors in the routing list and contacts GlobalNet to report the issue.

Benefit

Engineers can quickly catch routing issues and take action before more customers are affected.

Specifics

To determine and display the reason why a specific call attempt failed, the system uses the SIP response received from the vendor (e.g., 503 Service Unavailable) and maps this response to an internal code – h323-disconnect-cause – which explains why the call failed (e.g., 41 Temporary failure). This information appears on the Trace Session page to help engineers identify routing issues.

Web interface changes

Link copied to clipboard

Redesigned “Subscription plans” page

Link copied to clipboard

This release introduces a new “Subscription plans” page to streamline subscription plan management. Here are the changes:

  • When creating a new subscription plan, admins can now configure fee settings, promotional periods, and prepaid plans within the same side sheet – simply by switching between tabs. There’s no need to add these details separately afterward. This streamlines the setup process, saving time and reducing the risk of missing important settings.

    Add subscription plan

  • Editing subscription plans is now consistent with other pages – admins can simply click Edit Edit icon in the list.

    Edit Subscription plans

  • To make searches more precise, admins can now adjust the Name filter by clicking Matching modesettings 1 and selecting a condition – contains, starts with, ends with, or exactly matches. This helps narrow down results and makes it easier to find the right entry.

    Matching mode

  • All settings are now available on the Configuration page, organized into three tabs. Each tab uses the full-screen width, so most options are visible at once – even without scrolling.

    Subscription plan configuration

Benefit

These enhancements reduce the time admins spend setting up subscription plans.

Notification sets moved to a dedicated page

Link copied to clipboard

In PortaBilling, templates for customer or admin notifications are grouped into notification sets. These sets are now managed on a separate page in the web interface, apart from templates used for invoices and rate uploads/downloads.

Notification sets

Benefit

More intuitive navigation for admins managing notification-related settings.

×
Docs for
What's new
Admin manuals
Handbooks
UI help
Developers documentation