Sites (branches) and site administrators
A site is a branch of your company. Use sites when offices in different places share one MonoPbx but need their own carriers, numbers, time zone and music, and their own local administrators.
Open People and devices, Sites (/admin/sites). You need departments:read to see the page and departments:write to change it (a site is organisation structure, so it uses the department permissions).
What a site holds
- Own data: name, short code, country, time zone, address and a location note. The note is only for your information; emergency calls never use it.
- Music on hold: an uploaded file or a playlist. It is played to a caller parked on a user of the site when that user's department has no music of its own.
- Local breakout trunk: the site's own carrier (see below).
- Members: departments (their users belong to the site too), users, devices, trunks and numbers. Open Members on the site row, pick a kind and add or remove. A member belongs to one site; adding it to another moves it.
A site that still has members, an outbound rule or an administrator cannot be deleted.
Phones join their site by themselves
You rarely need to add devices to a site by hand:
- By the user. A new device of a user who belongs to a site (directly or through their department) is put on that site at once.
- By the office network. In the site's form, list its Provisioning networks, one per line, for example
192.0.2.0/24for the office LAN, or the office's public address (for example203.0.113.7) when the phones reach the PBX over the internet. A phone without a site that downloads its provisioning file from one of these networks joins the site. When two sites list overlapping networks, the more specific one wins. - Your choice wins. Once you add a device to a site, or take it off a site, in Members, it is never moved automatically again. A device that already has a site is never moved by these rules either.
The dial plan of a site
Create outbound rules as usual and choose the sites they apply to (Callers from sites in the rule, or caller_site_ids in the API). A rule that names sites applies to the callers of those sites only, so the rules that name Berlin are the dial plan of Berlin, each with routes over Berlin's trunks.
Local breakout: when the site has a breakout trunk and the matching rule has a route over it, calls of the site's users try that trunk first. The rule's other routes stay as failover. A rule is never extended with a trunk it does not name.
Site administrators
Open Administrators on the site row. Give a person a role (for example Department Admin) for this site. The role applies in every department that belongs to the site, now or later, and nowhere else. Take it away the same way.
- You can only give what you hold yourself, in every department of the site.
- A site without departments grants nothing yet: add a department first.
- A site administrator cannot move departments into their site, so they cannot widen their own reach.
Site reports
The Sites page shows calls placed and received by the users of each site and the calls on the site's trunks for the last 7, 30 or 90 days. The same report is available as CSV, XLSX or PDF from Reports (GET /reports/sites/export). You need reports:read.
For the technical details see the engineering guide docs/guides/sites.md.