What’s new in MR125

Link copied to clipboard

Trigger alerts on high-cost data usage

Link copied to clipboard

When mobile operators offer global data plans that include roaming – for example, 10 GB in 80+ countries for 30 days – data usage in some regions, like Pacific islands, can cost them far more than average. To prevent revenue loss, operators can define usage thresholds for these high-cost roaming zones. Once a subscriber reaches the defined limit in a specific region, PortaBilling can send a notification to the subscriber and an alert to an external application, which can instruct the mobile network to reduce data speed or temporarily block internet access.

This feature allows operators to protect their profits in high-cost countries, while subscribers receive clear notifications to control their usage.

EXAMPLE

An MVNO, Owl Mobile, offers a global data plan with 10 GB for 30 days, allowing subscribers to use the internet in many countries without changing their SIM card. The Owl Mobile’s admin configures PortaBilling to monitor roaming usage in high-cost zones, including Vanuatu (usage limit: 100 MB per hour). Owl Mobile uses middleware that receives HTTPS events from PortaBilling and updates the subscriber configuration in the mobile network.

Subscriber John Doe purchases this plan and travels to Vanuatu. After landing, he starts streaming videos on his phone. Within 20 minutes, PortaBilling detects that John’s usage in Vanuatu exceeds 100 MB and automatically:

  • Notifies Owl Mobile’s middleware, which instructs the mobile network to reduce data speed for John.
  • Sends an SMS to John informing him that his internet speed will be throttled while he’s in Vanuatu.

When John returns to his home country and reconnects to the domestic network, he can access the internet at full speed.

How it works

You can set a usage threshold per roaming zone for an hourly, daily, or weekly period (based on the customer’s time zone). A roaming zone is a group of mobile networks identified by MCC (Mobile Country Code) and MNC (Mobile Network Code).

When a subscriber connects to one of these networks and starts using data, PortaBilling calculates the usage for that roaming zone in real time.

You can configure either of these conditions for the threshold:

  • Actual usage – PortaBilling detects when the subscriber’s data consumption reaches the defined limit. For example, if you set 100 MB per hour, PortaBilling sends a notification once the actual usage reaches 100 MB or more.
  • Estimated usage – PortaBilling estimates the subscriber’s projected usage rate (based on current data consumption speed) and detects if they are likely to exceed the threshold before the period ends. For example, if the usage reaches 60 MB within the first 30 minutes (meaning that the consumption speed is 120 MB/hour), PortaBilling can warn the subscriber before the 100 MB/hour limit is actually reached. If the subscriber keeps using data and the actual usage reaches the 100 MB threshold, an additional notification is sent.

    Add code group for monitoring

When the threshold condition is met, PortaBilling can trigger:

  • A webhook (HTTPS request) to your preconfigured external application (middleware), which can then apply the QoS changes in the mobile network.
  • A notification to the account, customer, and admin through the preconfigured channels (e.g., SMS or email).
Benefit

Prevent financial losses when offering roaming bundles.

See the configuration steps and details here.

Short-term bundles with exact 24-hour validity and timely reminders

Link copied to clipboard

In competitive prepaid markets, such as in Africa, and in roaming scenarios, providers offer services with 1-day bundles. These bundles allow subscribers to purchase and use services only when needed, with access lasting 24 hours.

With this release, you can configure whether a prepaid bundle’s lifetime is measured by the clock (24 hours from activation) or by the calendar (until midnight). This gives you flexibility to define how long a bundle remains active and ensures that users can enjoy fair and predictable access to services.

Previously, bundles always expired at midnight, which often resulted in shorter usage periods for users who activated a bundle late in the day. Now the users with short-term bundles, such as 1-day bundles, can use the services for the full duration they paid for (e.g., 1 day = 24 hours, 2 days = 48 hours), starting from the time of bundle activation.

Add bundle_At the same time as activated

Admins can also configure multiple notifications to remind users of an upcoming bundle expiration not only days in advance, but also hours or even minutes, for example, 2 days and 2 hours, or 4 hours and 30 minutes before expiry. This ensures that users with short-term bundles (e.g., 1-day) receive timely reminders and can renew before their service is interrupted.

Notify end users when

EXAMPLE

Owl Mobile, an MVNO, offers a one-day roaming bundle that includes 5 GB of data, 200 voice minutes, and 100 SMS. The bundle remains active for exactly 24 hours from the moment of activation and then expires automatically unless renewed.

Owl Mobile’s admin configures notifications to remind the users how much time is left before the bundle expires:

  • 12 hours
  • 6 hours and 30 minutes
  • 1 hour 30 minutes

On October 21st, at 16:00, John Doe activates this bundle, which will remain active until October 22nd at 16:00. John will receive notifications about the bundle expiration on October 22nd at 04:00 (12 hours before), at 09:30 (6 hours and 30 minutes before), and at 14:30 (1 hour and 30 minutes before).

Benefits

For users:

  • Get full access to services for the full duration they paid for – exactly 24 hours from activation.
  • Stay informed about the bundle expiration to avoid service interruptions.

For service providers:

  • Stay competitive in the market.
  • Inform users about the bundle expiration, which help increase sales.

See the configuration steps here.

More Polycom IP phone models supported for auto-provisioning

Link copied to clipboard

Cloud PBX customers can now easily configure programmable phone keys on additional Polycom IP phone models:

  • Polycom VVX311
  • Polycom VVX400
  • Polycom VVX401
  • Polycom VVX500
  • Polycom VVX501

Auto-provisioning for these models is available via Add-on Mart with an active subscription to the related modules. Along with programmable key configuration, PortaSwitch automatically provides core parameters such as SIP credentials, proxy settings, and codec options. Customers can apply settings to multiple devices at once via the CloudPBX Self-Care Portal (accessible through Add-on Mart) or an external portal using the PortaBilling API.

Benefits
  • Service providers can offer a more competitive CloudPBX service to onboard more customers.
  • Customers can manage phones on their own, reducing reliance on support.

Migrate on-premise PortaSwitch (Oracle Database) to Oracle Cloud Infrastructure (OCI)

Link copied to clipboard

If you have an Oracle-based on-premise installation and want to move it to the cloud, there’s now a solution for that. This release introduces the possibility of migrating Oracle-based PortaSwitch systems to a MySQL-based installation in Oracle Cloud Infrastructure (OCI). In the cloud, PortaSwitch runs on a MySQL database instead of Oracle RAC. (RAC requires a very specific hardware configuration for a shared disk array, and is not compatible with virtual resources in the cloud.) The MySQL database delivers the same reliability and performance as a single-node Oracle database – and, with the PortaOne team using cloud capabilities for disaster recovery, your service will be as resilient as it was with an on-premise Oracle database cluster.

Since the new installation contains a default database, the service provider must configure the product catalog in the cloud-based PortaSwitch. After the product catalog is set up, PortaOne Support migrates customers, resellers, and representatives from the on-premise PortaSwitch to the cloud-based PortaSwitch.

Benefits
  • No more hardware investment: No need to purchase or maintain physical servers.
  • Reduced administrative workload: The cloud infrastructure is fully maintained by PortaOne, significantly reducing the effort required from your technical staff.
EXAMPLE

Owl Telecom currently operates an on-premise, Oracle-based PortaSwitch and plans to migrate to OCI. The PortaOne Support prepares a new cloud-based system and provides access to Owl Telecom.

The migration process then follows these steps:

  1. Owl Telecom pre-configures mandatory entities such as vendors, DIDs/SIM cards inventories, and product catalogs in the cloud-based system for their customers.
  2. PortaOne Support migrates customers (with their accounts), resellers, and representatives to the cloud.
  3. Owl Telecom configures a default product for their resellers’ use. Each reseller then configures product catalogs for their customers and subresellers using the new portal URL.
  4. PortaOne Support migrates resellers’ subcustomers (with their accounts), subresellers, and reseller individuals to the cloud-based PortaSwitch.
  5. When all entities have been migrated, the service provider switches traffic from the on-premise system to the cloud system by updating the DNS records for SIP registrations and portal access.
Specifics
  • Only customer, reseller, and representative entities (together with their billing data, like xDRs of the current billing period) can be migrated from the on-premise system to the cloud-based one. All other required entities must be pre-configured by the admin manually via the web interface or API.
  • You can migrate to any maintenance release in the cloud, either to the same MR as your current system or to a newer one. However, the greater the gap between releases, the more challenging the pre- and post-migration activities become.
    The minimum release of the Oracle-based PortaSwitch that supports migration is MR70.
  • All customers, resellers, and representatives must be migrated in a single run.
Limitations
  • Only the billing data for the current billing period is migrated. Historical data, such as xDRs from previous billing periods, are not migrated.
  • Transferring the migrated entities back to the on-premise system is not supported.

More insights in call activity reports

Link copied to clipboard

Admins can now access more detailed call activity reports from the custom portals (third-party or developed in-house).  Call activity reports provide the total number of calls over a selected period, along with time spent on after-call work (wrap-up time), on hold, and waiting in the call queue.

This feature is available in the PortaBilling API. To support the new functionality, update your portals to use the “total_calls”, “wrapup_duration”, and  “suspended_duration” API parameters. The CloudPBX Self-Care Portal will include this data in future versions.

Admins and supervisors can filter the data in these reports by average metrics, such as average handle time, or by extremes, such as the longest and shortest calls. This helps track agent productivity and assess service quality by highlighting unusually short or long talk times. For example, a low number of outgoing calls may suggest limited customer follow-up, while a long wrap-up time can indicate inefficiency in post-call work.

Benefit

PBX admins can analyze call data to understand the agents’ effectiveness.

EXAMPLE

Lisa is a call center supervisor. To evaluate her team’s efficiency, she reviews the weekly call activity report in the call center portal. The report includes the total number of incoming and outgoing calls and the average wrap-up time for each agent. Lisa notices that one of her agents, John, spends more time than others finishing post-call tasks. After reviewing several of his call recordings, she realizes that John takes extra time to complete call notes. Using this information, Lisa coaches him on how to streamline his wrap-up process and improve productivity.

Caller details in voicemail and fax lists

Link copied to clipboard

With this release, Cloud PBX admins, call center admins, and supervisors using custom self-care portals can view caller and recipient details in the voicemail/fax list. To support this, the PortaBilling API method has been extended with two new parameters: “from” and “to”.  Along with the basic voicemail/fax message information (such as size, duration), this method now also returns the caller’s details and the number that received the message.

The custom portal should be updated to show these details. For the CloudPBX Self-Care Portal subscribers, this information will be shown in future versions.

EXAMPLE

Alex is a PBX admin at a healthcare clinic. He manages the phone system for multiple departments, including reception, the billing department (handling payments and insurance claims), and patient support. Each department has its own voicemail number configured on a separate extension. When Alex logs in to the self-care portal and opens the voicemail list, he can instantly see who left a message and which clinic department’s number received it.

This allows Alex to quickly filter urgent messages, such as a patient requesting a call-back, and forward them to the appropriate staff without delay.

Benefit

Cloud PBX admins, call center admins, and supervisors can handle daily tasks more efficiently by accessing voicemail and fax message information faster.

Configurable subscriber identification in Diameter requests for MVNOs/MNOs

Link copied to clipboard

The mobile core may send the subscriber ID (the SIM card’s IMSI or phone number) in either the User-Name or Subscription-Id field of Diameter requests. If User-Name is present, PortaBilling automatically uses it for subscriber identification. Only if it is missing does PortaBilling fall back to Subscription-Id. However, some mobile networks may utilize User-Name for other purposes while placing the subscriber ID in Subscription-Id. In such cases, PortaBilling receives User-Name, assumes it contains the subscriber ID, but cannot identify the subscriber based on it.

Now, for mobile data services, you can configure PortaBilling to ignore User-Name and only use Subscription-Id for subscriber authentication – allowing integration with such networks without extra development.

For PortaBilling to ignore the User-Name field when it contains something other than the actual subscriber ID:

  1. Create a service policy for internet access and specify the Origin-Host value of the MNO’s network (e.g., the packet gateway) in the Attribute pattern field. You can specify it in the format Origin-Host=%.company.domain – this pattern matches any host within the same realm (e.g., pgw1.company.domain and pgw2.company.domain).

    Specify attribute pattern

  2. Navigate to Attributes > Gy and turn on the Ignore User Name toggle.

    Turn on the Ignore User Name toggle

You don’t need to assign this service policy to a product or account – PortaBilling automatically applies this service policy when it detects a match between the configured pattern and the Origin-Host value in the incoming Diameter request.  When a service policy is applied, PortaBilling ignores the User-Name field and uses Subscription-Id to identify the subscriber.

Benefit

Launch mobile data service faster without the need for extra support requests and custom code changes.

Redesigned Trace session page

Link copied to clipboard

This release introduces an updated look to the Trace session page.

The Search panel has been moved from the left side of the page to a single line at the top of the page. This layout provides more space for displaying sessions and eliminates the need for horizontal scrolling, even when working with a large table.

To save space at the top of the page, additional search parameters that are used less frequently are now grouped under the More menu.

Trace session redesigned page

Benefits

This enhancement improves the user experience when troubleshooting sessions.

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