> For the complete documentation index, see [llms.txt](https://docs.pascom.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pascom.net/en/setup/acd/extension-switch.md).

# Set up Extension Switches

How to set up function-based extension switches with time-controlled automation to manage your availability.

An **extension switch** is a flexible control element within the PASCOM Cloud PBX that functions like a virtual on and off switch. Use it to manually or automatically (via time control) enable and disable specific call flows, such as routing decisions, announcements, or alternative call forwarding. Unlike rigidly defined business hours, an extension switch lets you react quickly to unforeseen situations, intelligently route calls, and automate complex telephony processes.

## Use Extension Switches

Extension switches are a practical tool when you cannot define a **fixed day or time period**, or when you need to make short-term changes to the call flow.

They are useful, for example, if you want to spontaneously switch the switchboard to the announcement *"All employees are currently in a meeting"*, or if there are no fixed business hours and the last person to leave the company switches the switchboard to "outside business hours".

### Create an Extension Switch

In the PASCOM web UI, select **Call Distribution** > **Action Conditions** and click **Add** to create a new condition. Alternatively, select an existing condition and click **Edit**.

When adding, select the **Extension switch** type.

1. Enter a **Name** (e.g. "Meeting Announcement" or "AI Agent").
2. Enter the **Extension** (e.g. "502") under which this switch is reachable.
3. Use **Switch state** to determine whether the extension switch is on or off after creation.
4. Save the configuration by clicking **Save & Next** or **Save & Exit**.

![Create extension switch](https://2713225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVIw0BpSv358R2Pr2HflD%2Fuploads%2Fgit-blob-d4216f24b047fa32e9061fab5bd5a0783414d6a1%2Fcreate-extension-switch.en.png?alt=media)

When a user calls this extension, the switch is **active**. Calling it again **deactivates** the switch. When you call the extension switch, you hear an announcement about the current status.

You can then use the extension switch as a **condition** in the call distribution actions to control your call flows.

### Configure a Time-Controlled Extension Switch

You can combine extension switches with intelligent **time controls** to manage your call forwarding precisely and automatically. Individual time schemes act as fixed rules for your extension switch, and the system handles the automatic switching for you.

For an existing extension switch, click the **Rules** tab and select **Add Rule**. For example, you can set the extension switch to activate automatically in the morning and deactivate at the end of the working day.

![Add time rule](https://2713225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVIw0BpSv358R2Pr2HflD%2Fuploads%2Fgit-blob-131f4b81aa14956af0eeb50dd992f244ae79beb3%2Fadd-time-rule.en.png?alt=media)

1. Enable the rule by sliding the **Rule active** switch.
2. Select the desired **Weekdays** for your rule from the drop-down menu (e.g. "Monday").
3. Enter the exact **Time** (e.g. "12:00").
4. Use the **Switch state** toggle to determine whether the extension switch turns on (red background) or off (gray background) at this time.
5. Add multiple rules that build on one another if necessary.
6. Click **Save**.

![Create time-controlled extension switch rules](https://2713225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVIw0BpSv358R2Pr2HflD%2Fuploads%2Fgit-blob-1ef7741bf2897361399aba8acc2ca0d2c88491d5%2Fcreate-rule-chain.en.png?alt=media)

### Make Extension Switches Available to PASCOM App Users

If you want to provide your team with the extension switch as an interactive element directly in their contact list, you must assign the appropriate permissions via roles. Decide which users with the **xmpp.group role** may interact with the extension switch.

1. Find more information about [Roles](/en/setup/user/role.md).
2. Learn how to use extension switches in the [PASCOM App](/en/user/pascom-app-userguide/extension-switch.md).

### Set Up Extension Switches on Line Keys (BLF)

{% hint style="success" %}
**LED Status Indicator:** You can assign the extension of an extension switch to a **line key** on your IP phone. The LED lights up as long as the switch is active and turns off when the switch is inactive.
{% endhint %}

To use an extension switch on a phone's **line key**, you must assign it to a user within a **User role**. The role does not require any specific permissions.

1. Find more information about [Roles](/en/setup/user/role.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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 following URL with the `ask` and `goal` query parameters:

```
GET https://docs.pascom.net/en/setup/acd/extension-switch.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

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.
