Перейти к основному содержимому

Plan and usage

MonoPbx Voice lets your PBX call the phone network without a carrier contract of your own: you add minute packs for groups of destinations (for example Mexico, North America or Colombia). Each pack is added once, and you can combine any packs you need: Mexico only, or Mexico, North America and Colombia together. Plan & usage in the admin console shows what you have left.

There is no pay as you go. A call goes out only within the minutes of a pack that covers its destination. A call that no pack covers, or a call after a pack's minutes are used up, is refused: the caller is told why and you get an alert. There is no balance to top up and no overage charge.

Plan & usage page with two pack cards and the pack checklist.

Find it under Numbers, MonoPbx Voice, Plan & usage (/admin/voice-plan). The entry appears only on servers where MonoPbx Voice is turned on. Viewing the page needs the MonoPbx Voice plan: read permission (voice_plan:read); turning MonoPbx Voice on or off, adding and removing packs and changing settings and caps need MonoPbx Voice plan: write (voice_plan:write). The Owner role has both and the Manager role can read; see Permissions.

Turn MonoPbx Voice on or off​

The MonoPbx Voice service card at the top of the page says whether MonoPbx Voice is On or Off for your company.

  • Turn on asks for the country of the company (United States, Mexico or Colombia) and how this server connects: Registration (recommended, works behind NAT and with a changing address) or a Static IP address (only for a server with a fixed public address; enter its public addresses). It adds a managed trunk to MonoPbx Voice, an outbound rule and the emergency numbers of the country (911 in the United States and Mexico, 123 in Colombia). Your own outbound rules keep routing first.
  • Turn off asks you to confirm. It closes the company's MonoPbx Voice account and removes the managed trunk, its outbound rule and its emergency numbers. Calls in progress are not cut. It is not possible while numbers are active, ordered or waiting for an address, or while a request to bring numbers is open: release the numbers on Buying numbers first (released numbers are kept for 30 days and do not block it). Your packs stop renewing: each runs to the end of the period you paid for and then ends (no refund, unused minutes do not carry over).
  • You can turn it on again later; a new MonoPbx Voice account is opened for the company.

The card says Not available when your server does not offer MonoPbx Voice, and Not in your licence when the licence does not include it (add it on Admin, Licence).

Packs​

One card per destination group shows:

  • the pack the minutes come from;
  • a bar with the share used. It turns amber at your warning share (80 % by default) and red when the minutes are used up;
  • the minutes used and left, and the date the bundle resets. Unused minutes do not roll over.

Minutes are shared by the whole company. The figures come from the licence server and are refreshed regularly; calls that ended on your PBX since then are added at once. If the figures are more than 15 minutes old the page says so; calls on a pack continue and the figures refresh by themselves.

The figures are read live from your licence account, so the console shows the same numbers as the account portal (the page says Live figures from your licence account). If the licence server cannot be reached, the last figures this server received are shown.

Add or remove packs in the console​

Everything is bought inside the console, through your licence account:

  • Your packs is a checklist of every pack on sale. A ticked pack is one your company has, with its minutes, price and renewal date. Each pack can be added only once; combine as many different packs as you need.
  • Tick a pack to add it: choose Monthly or Annual (a year for the price of ten months, Save 17%) and select Add. The pack is charged at once to the card on file of your licence account. In all shows what the ticked packs cost per month and per year.
  • Untick a pack to remove it: it stops at the end of the period you paid for and is not renewed. Nothing is refunded, and unused minutes do not carry over. Ticking it again before that date keeps it, with no new charge.
  • Adding a pack your company already has is refused with Your company already has this pack (MPBX-VOICE-PACK-HELD).
  • After each purchase the same payment result card as the licence checkout says what happened: Payment approved (charged, the minutes are added; Done closes it), Payment pending (the bank is still deciding; you get an e-mail when it clears) or Payment declined (nothing was charged; Try again or Change payment method, which opens the account portal). The bank's own words, when there are any, are shown on the card.
  • Manage in account opens the licence account portal already signed in, for invoices and payment methods.

Self-hosted servers​

On a server you host yourself, link it to your licence account first: open Admin, Licence and sign in to the account (see Licence account). Until then Plan & usage and Numbers say Link your licence account and nothing can be bought. Once linked, the Licence page also shows a MonoPbx Voice card with links to add packs and buy numbers.

When a pack runs out​

Calls to that destination are refused until the pack resets at the start of the next period, or until you add a pack that covers the destination. The caller hears a short message and the app says the company's minutes are used up. You get an alert. A call in progress may run up to one minute past the last minute of the pack; it is not charged.

Calls to destinations that no pack covers are always refused. Premium-rate and high-risk destinations are never callable over MonoPbx Voice.

Caps per user​

A cap limits how many minutes one person may use per period, over all destinations.

  • Default cap per user: applies to everyone without a cap of their own. Leave it empty to use the pack's fair-use limit.
  • Caps per user: pick a person, enter the minutes per period and select Save cap. Use the row menu to change or remove a cap.

A person who reaches the cap cannot place more MonoPbx Voice calls in that period; the app tells them to ask their administrator. Caps never delete anything.

Alerts​

You get an alert when a pack reaches the warning share (1 to 99 %, 80 % by default), when it is used up and when a person reaches their cap. Each alert is sent once per item and period:

  • in the console's alert list (Alerts), as A MonoPbx Voice pack passed its warning share or A MonoPbx Voice pack ran out;
  • by e-mail to the outbound alert addresses, to up to 10 Alert addresses you enter under Settings and to the administrators who switched on MonoPbx Voice alerts (Anomaly e-mails);
  • at the top of the Plan & usage page, as long as the pack stays above the share.

If our fraud checks see unusual call activity on your account (for example far more minutes in an hour than usual), every MonoPbx Voice call of the company is stopped at once and our team is alerted. The page then says your calling plan is paused; contact us to resume it.

Usage​

Usage this period shows a daily chart of minutes on a pack, a table by destination group (pack minutes, and the minutes a call ran past a pack's last minute, which are not charged) and the 50 people with the most minutes. Calls without a person (for example calls forwarded by an IVR) are listed together.

What people see​

When MonoPbx Voice refuses a call, MonoPhone and the web phone show why, in the person's language, and ask them to contact their administrator:

ReasonMessage (English)
Pack used upYour company's minutes for this destination are used up.
Person's cap reachedYou have used all your minutes for this destination in this period.
Destination not covered by any packYour company's calling plan does not cover this number.
Plan pausedYour company's calling plan is paused.
Plan cannot be checkedThe calling plan can't be checked right now.

The reasons also appear in the call history and in Error codes.

Permissions​

PermissionWhat it allows
voice_plan:readSee this page: whether MonoPbx Voice is on, the packs, usage and caps.
voice_plan:writeTurn MonoPbx Voice on and off, add and remove packs, change the settings and caps.

The Owner role holds both, the Manager and Read-only manager roles hold voice_plan:read. Roles that could open the page before these permissions existed (with the dial plan permissions) were given them automatically, so nobody lost access; you can now remove them from a role that should manage call routing but not the calling plan. See Users and roles.

See also​