#
Sep 16, 2026 · @Moshe
Overview #
Three optional PBX device settings control what an R20A’s call button dials and how its door relay opens. They only apply to devices on the akuvox/r20a template.
| Setting Name | Controls | Example Value |
|---|---|---|
akuvox_call_number | Number the call button dials | 600 or 600;601 |
akuvox_relay_dtmf | Code pressed during a call to open the door | # |
akuvox_relay_delay | How long the relay stays open | 5 |
Device or domain: where to set them #
Use a domain setting when every door phone in the tenant should behave the same, and a device setting when one door phone needs its own value. If both exist, the device setting wins for that door phone.
| Situation | Set it on | Example |
|---|---|---|
| All door phones at a site dial the same front desk | Domain | akuvox_call_number = 600 for the tenant |
| All doors use the same unlock code and time | Domain | akuvox_relay_dtmf = #, akuvox_relay_delay = 5 |
| One entrance dials a different number | Device | Side gate door phone: akuvox_call_number = 610 |
| One door has a lock that needs a longer open time | Device | Garage door phone: akuvox_relay_delay = 10 |
| Only one door phone in the tenant | Device | Any of the settings |
A common setup is a domain setting for the site default, plus device settings only on the door phones that differ.
Set it on the device page #
- Go to Accounts > Devices and open the door phone.
- Scroll to the Settings section.
- In the empty row, enter the Name (for example
akuvox_call_number), the Value, and set Enabled to True. - Click Save, then restart the door phone.
The device page has no Category or Type fields; enter only Name and Value.
Set it on the domain settings page #
- Go to Advanced > Domains and open the customer’s domain.
- Click Settings, then Add.
- Fill in the form:
| Field | Enter |
|---|---|
| Category | provision |
| Subcategory | The setting name, e.g. akuvox_call_number |
| Type | Text |
| Value | The value, e.g. 600 |
| Enabled | True |
| Description | Optional, e.g. Door phones dial front desk |
- Click Save.
- Restart each door phone in the domain, or wait for their next scheduled provisioning check.
The Subcategory must match the setting name exactly, and the Category must be provision, or the door phones ignore it.
Set the call button number #
Set akuvox_call_number to the extension, ring group or IVR that should answer when a visitor presses the button.
- Go to Accounts > Devices and open the door phone.
- Scroll to the Settings section.
- In the empty row, enter:
| Field | Enter |
|---|---|
| Name | akuvox_call_number |
| Value | The destination number, e.g. 600 |
| Enabled | True |
| Description | Optional, e.g. Front desk ring group |
- Click Save.
- Restart the door phone, or wait for its next scheduled provisioning check.
Value examples:
| Scenario | Value |
|---|---|
| Front desk extension | 100 |
| Lobby ring group | 600 |
| Two numbers | 600;601 |
Separate several numbers with a semicolon and no spaces.
Use a number that the door phone’s own extension is allowed to dial. The call is placed from the door phone’s SIP account, so its extension’s calling rules apply.
Set the door relay code and open time #
Set akuvox_relay_dtmf to the key the person answering presses to unlock the door, and akuvox_relay_delay to how long the door stays unlocked.
- Go to Accounts > Devices and open the door phone.
- Scroll to the Settings section.
- Add one row per setting:
| Name | Value | Enabled | Description |
|---|---|---|---|
akuvox_relay_dtmf | # | True | Door open code (optional) |
akuvox_relay_delay | 5 | True | Door open seconds (optional) |
- Click Save. A new empty row appears after each save if you need to add the second setting separately.
- Restart the door phone, or wait for its next scheduled provisioning check.
Tell the customer the code. While on a call from the door phone, they press it on their phone’s keypad to release the door.
The relay applies to relay A,
Match the open time to the lock hardware. Too short and the visitor can’t get through; too long and the door stays unlocked after they enter.