# User Groups

User Groups allow you to group multiple users together and assign a shared **Outbound Caller ID** to the group.

When an **Outbound Rule** is configured with a **Caller User Group** condition, the PBX applies the group’s outbound caller ID to calls placed by members of that group. Specifically, the PBX replaces the **user part of the `From` header** in the SIP `INVITE` message with the **User Group’s Outbound Caller ID**.

This feature is commonly used to present a **department-level caller ID** (for example, Sales or Support) instead of individual extension numbers.

***

### Create a User Group

To create a user group:

1. Navigate to **Call Manager > User Groups**.
2. Click **Add**.
3. Enter a **Group Name**.
4. Assign an **Outbound Caller ID** and select the trunk to be used.

In the example below, a user group named **Sales Dept** is created, with an outbound caller ID of **010000** assigned on the **CallCentric** trunk.

<figure><img src="/files/wwOwTDyGDo9djVeTcNv2" alt=""><figcaption></figcaption></figure>

***

### Create an Outbound Rule Using Caller User Group Criteria

Next, create an outbound rule that uses the **Caller User Group** as a matching condition:

1. Go to **Call Manager > Outbound Rules**.
2. Create or edit an outbound rule.
3. Set the **Caller User Group** criterion.
4. Select the previously created **Sales Dept** user group.

<figure><img src="/files/biGooFY7WW6d1wbPG4vP" alt=""><figcaption></figcaption></figure>

***

### Call Behavior

When an extension that belongs to the **Sales Dept** group places a call that matches this outbound rule:

* The PBX uses the **group’s outbound caller ID**.
* The outbound caller ID is inserted as the **user part of the `From` header** in the SIP `INVITE` message.
* The call is routed according to the outbound rule and associated trunk.

This ensures consistent, department-level caller identification for outbound calls.


---

# 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://support.portsip.com/portsip-communications-solution/portsip-pbx-administration-guide/5-user-management/user-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.
