# Dial groups management

The module allows you to organize employees into groups and flexibly manage their permissions: block international calls, allow internal calls only, assign personal routes or CallerID. Full group isolation is supported — employees will only be able to call within their own group.

### Installation and module overview

1\. Go to "**Module marketplace"** -> "[**Marketplace**](/mikopbx/english/manual/modules/pbx-extension-modules.md#marketplace)**"**. Install the **"Manage call groups"** module.

<figure><img src="/files/L9MYRHWh0ZPgAt9E9lnR" alt=""><figcaption><p>"Manage call groups" module in the Marketplace</p></figcaption></figure>

2\. Go to "**Installed modules"** section. Enable the module and open its settings.

<figure><img src="/files/F846x6o3NY5x2K52VI7V" alt=""><figcaption><p>"Installed modules" section. Opening module settings.</p></figcaption></figure>

In the "**Dial group list"** section you can see all existing groups. You can also set a default group here — all newly created employees will be added to it automatically. If needed, a group can be selected manually when creating an employee.

<figure><img src="/files/Gr13Og9QSZyLL8KVvaM4" alt=""><figcaption><p>"Dial group list" tab</p></figcaption></figure>

In the **"Extensions"** section you can see all employees and which group they belong to.

<figure><img src="/files/gpDmDrfnXNnjhnuVlHTa" alt=""><figcaption><p>"Extensions" tab</p></figcaption></figure>

### Creating a new group

1. To add a new group, go to the "**Dial group list"** tab and click "**Create dial plan"**.

<figure><img src="/files/32CozNDowq7PhX7YjcGu" alt=""><figcaption><p>"Create dial plan" button</p></figcaption></figure>

2. Specify the basic parameters for the new group:

* **Group** — any name, for example "Marketing Department".
* **Description** — a brief note, for example "External calls allowed through Telnyx only". Helps quickly identify the group's purpose later.

Click "**Save**".

<figure><img src="/files/iCcOrfst8MNxdZSrrEZO" alt=""><figcaption><p>Basic parameters for the new group</p></figcaption></figure>

3. On the "**Group staff"** tab, select the employees to include in the group.

<figure><img src="/files/EgtfmapQlfU5wQ29MaBu" alt=""><figcaption><p>Adding employees when creating a new group</p></figcaption></figure>

4. Go to the "**Outbound routing rules"** tab. Here you can enable or disable available routes for the current group. For example, activate only the Telnyx route — then group members will only be able to call through it.

If needed, enter a number in the **Outbound Caller ID** field — this number will be shown to the recipient when calling through this route. If left empty, the default Caller ID from the provider settings will be used.

{% hint style="warning" %}
Not every provider allows CallerID substitution — typically only numbers belonging to the organization are permitted. The following formats are supported:

* `60177876453 <admin>`
* `60195229304`
* `60195223045 <60195223045>`

Check with your telecom provider which `FROM` header format (the `user` field) is supported.

If you need to use this feature, make sure to **disable** the **`fromuser`** field in the provider settings. This setting also affects the `FROM` header and has higher priority.
{% endhint %}

{% hint style="info" %}
If all routes are disabled, group members will only be able to make internal calls.
{% endhint %}

<figure><img src="/files/3XZmRcjtNMzzwge3OvXa" alt=""><figcaption><p>"Outbound routing rules" tab settings</p></figcaption></figure>

### Common use cases

#### **Allow internal calls only**

If your company has interns or employees who don't need to call external numbers, you can restrict their access to internal calls only.

1. Go to the "**Dial group list"** module settings. Click "**Create dial plan"**. Set any name, for example "Internal Calls Only".

<figure><img src="/files/bhIsztqNJdd5Iklb8iaw" alt=""><figcaption><p>General settings of the new group (internal calls only)</p></figcaption></figure>

2. On the "**Group staff"** tab, select the employees to include in the group.

<figure><img src="/files/EgtfmapQlfU5wQ29MaBu" alt=""><figcaption><p>Selecting employees to add to the group</p></figcaption></figure>

3. On the "**Outbound routing rules"** tab, disable all routes — switch all toggles to the off position.

<figure><img src="/files/tlKpb8NyxtLQOP7ACHsZ" alt=""><figcaption><p>Disabling all outbound routes for the group</p></figcaption></figure>

#### **Block international calls**

1. Go to the "**Dial group list"** module settings. Click "**Create dial plan"**. Set any name, for example "No international calls (only local)". <mark style="background-color:blue;">In this example, the providers for local calls are Megafon and Beeline. Telnyx will be used for worldwide (international) calls.</mark>

<figure><img src="/files/DCPkpsUe0gEz0hpugJ03" alt=""><figcaption><p>General settings of the new group (no international calls)</p></figcaption></figure>

2. On the "**Group staff"** tab, select the employees to include in the group.

<figure><img src="/files/EgtfmapQlfU5wQ29MaBu" alt=""><figcaption><p>Selecting employees to add to the group</p></figcaption></figure>

3. On the "**Outbound routing rules"** tab, enable only local provider routes and leave the "**Telnyx**" international route disabled.

<figure><img src="/files/VQDIOW9wkyFIL9zWeJ0D" alt=""><figcaption><p>Outbound routing template with international calls blocked</p></figcaption></figure>

### Group isolation

After creating a group, go to **Group Settings** to configure isolation options. Two options are available:

* Isolate a group of employees.
* Isolate the pickup function.

#### **Isolate a group of employees**

This feature fully isolates the group from all other employees on the PBX:

* Group members can only call numbers within their own group.
* Employees from other groups cannot call the isolated group.
* Call pickup (`*8`) will only work within the group.

**Patterns of numbers related to the group. A group member will only be able to call them** - define the patterns of numbers that group members are allowed to dial. Patterns support digits 1–9 and the symbol `X` (any digit 0–9).

Pattern examples:

* `2XX` — numbers from 200 to 299
* `200001` — a specific internal number, for example a queue number
* `66XXXXXXXXX` — 11-digit Thai phone numbers

<figure><img src="/files/CjL5CCXrefgil8QzCr1X" alt=""><figcaption><p>Isolating the employee group</p></figcaption></figure>

#### **Isolate the pickup function**

More details about the pickup function can be found in the [documentation](/mikopbx/english/manual/system/general-settings.md#perevody_vyzovov1).

By default, the call pickup combination is `*8` or `*8phoneNumber`. When isolation is enabled, pickup will only be available within the group — the list of members is defined on the **Group Employees** tab.

<figure><img src="/files/qXfAcVqKdCOFg25cFrG9" alt=""><figcaption><p>Isolating the call pickup function within the group</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mikopbx.com/mikopbx/english/modules/miko/module-users-groups.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
