Executives, assistants and door phones
This page covers two features for offices: an executive whose calls an assistant screens, and SIP door phones that ring people inside and open the door.
Executives and assistants
An executive is a person with one or more assistants. Open Settings, Telephony, Executives and assistants (/admin/executives; needs users:write for the executive's department).
- Choose the executive.
- Add the assistants in ring order. A screened call rings the first assistant. For each assistant, choose whether they may switch the executive's status (Do not disturb, forwarding).
- Choose the call screening:
- Calls ring me: screening is off; the executive's phones ring as usual.
- Outside callers ring my assistant: calls from outside the company ring the assistant; colleagues reach the executive directly.
- Every caller rings my assistant: every call rings the assistant first.
- Add the private line: numbers and extensions that always ring the executive directly, one per line.
Calls from the assistants always ring the executive. This is how an assistant puts a caller through: answer, call the executive (a consult call), then complete the transfer. An assistant can also pick up a call that rings the executive with the pickup code (see Feature codes).
A screened call follows the assistant's own status: if the assistant is busy or does not answer, the assistant's forwarding rules apply.
The executive can switch screening and edit the private line themselves under Executive and assistant in the web client and the mobile app. Who assists whom stays an administrator's choice.
What assistants see
Under Executive and assistant, an assistant sees each executive they assist, their extension and their current status, and can set them to Do not disturb or back to Available when the administrator allowed it. The assistant's desk phone gets a busy-lamp key for each executive's extension on its own, after the keys you set for the phone (when the phone has a free key); the My BLF panel shows the same.
Door phones
A door phone is a SIP door station registered as an ordinary device: it has an extension, and its call button dials a number. Point the button at a person, a ring group or a queue. To ring different people by time of day, point it at a ring group with office hours.
Open Settings, Telephony, Door phones (/admin/door-phones; devices:read to see, devices:write to change) and add the device as a door phone:
- Name: what people see.
- Open the door by:
- Keypad code in the call: the phone system presses the code (for example
*1) in the call with the door. Use the code your door station opens on. - Relay web address: the phone system calls the door station's relay address (
GET,POSTorPUT). - Not from the phone system.
- Keypad code in the call: the phone system presses the code (for example
- Camera image address: the still image (JPEG) of the door's camera. People see it, refreshed every second, while the door rings and during the call.
- Door user name and password: used for the relay and the camera image. The PBX sends them with HTTP Basic authentication; when the door station asks for digest authentication instead (MD5 or SHA-256), the PBX answers with digest automatically. The password is stored encrypted and never shown again.
- Users may open the door: an office-hours schedule. Outside its open hours only administrators can open the door.
Opening the door
When the door rings a person, the mobile app shows its camera and an Open door button on the call screen. In the web client, Door phones shows the camera and the button while you are in a call with the door. A person can only see the camera and open the door while they are in a call with it (ringing or answered). An administrator with devices:write can look at the camera and use a relay address at any time. Every opening is recorded in the audit log.
Network
The phone system fetches the camera image and calls the relay itself. Door stations usually have private addresses on the office network. The operator of the installation lists the door stations' exact addresses in MPBX_DOOR_PHONE_ALLOW_ADDRS (comma separated); other private addresses stay blocked. A door station that the server cannot reach shows The door did not answer.
Test before you rely on it
Test each door station model once: the keypad code or relay address, the camera image address and its user name and password. Door stations that accept only digest authentication work with the same user name and password. A door station that needs an access token in the address is not supported: use a relay address that works with a user name and password, or none.
Working with the lists
Door phones is a list: a search box (name or extension), one row per door station with its extension and how its door opens, and the ... menu at the end of a row with Preview, Open (a door with an HTTP relay), Edit and Delete (with devices:write). Add door phone in the header, and Edit in the menu, open the form in a dialog; Save closes it and the list shows the change. Below 640 pixels wide the table turns into cards.
Executives keeps its single form: pick the executive, then their assistants appear as a table in ring order. The ... menu of an assistant moves it up or removes it; the checkbox says whether the assistant may change the executive's status.