Skip to content
Docs
Voxbi Cockpit APIs
API Guides

Parent SIP devices

A parent SIP device is a gateway or base station that child SIP devices register through rather than connecting directly to the PBX.

Overview

Parent SIP devices sit between the PBX and a group of endpoints. Instead of each handset or trunk registering directly, they register through the parent, which holds the single SIP connection to the PBX. Two types are supported: Gigaset DECT managers for cordless handsets, and generic SIP trunk devices for analog phones or other endpoints.

What it does

A child SIP device is linked to a parent by setting its type to "Gigaset" or "Trunk". The parent holds the single SIP connection, so toggling it off prevents all of its child devices from registering until it is re-enabled.

See also

  • SIP devices - child devices that register through a parent SIP device.

Form fields

Fields available in the create and edit forms.

General

Name

Descriptive label for this device shown in lists (for example, "Main DECT Base" or "SIP Gateway Floor 2"). Editable directly from the list view.

MAC

Hardware identifier used for device identification and auto-provisioning. Required for Gigaset devices.

Enabled

Whether the device is active. When off, child devices cannot register through it. Toggleable from the list view.

Type

The device category, which determines which child SIP device types can register through it.

  • gigaset Gigaset DECT Manager Manages Gigaset cordless handsets. Child devices must be type Gigaset.
  • sip_trunk Generic SIP Trunk Device General-purpose gateway for trunk or analog endpoints.
Location

Physical location where this device is installed. A new location can be created directly from this field.

Alternative username

Composite widget that lets you override the default SIP registration username for this device. Only visible in edit mode. When enabled, the device will register with this username instead of the default.

SIP password

SIP authentication password. Auto-generated at creation if left blank. Only visible in edit mode. Retrieval is logged.

Updated