Page tree
Skip to end of metadata
Go to start of metadata




This module requires FreePBX 2.11 and Asterisk 11 or greater or PBXact 10.211.65 or greater.


The Presence State module lets you control which presence states are available to your users in certain applications. Presence states can control call behavior. For example, a user might choose "do not disturb / DND" in order to send calls directly to voicemail without ringing.

Usage Examples

For example, users can select a presence state from their User Control Panel (UCP) Presence menu if it is enabled for the user. You would enable this feature through the User Management module.

As another example, with the commercial Phone Apps-Presence, users can set their presence state from their phone.

Logging In

  • Log in to the FreePBX UI
  • On the top menu click Admin
  • In the drop down click Presence State

Available Presence States

When you arrive at the main page for the module, you will see a list of Presence States that have been created on your system already.

The defaults are shown below:

The defaults are Available, Chat, Away, DND (do not disturb), Extended Away, and Unavailable.

Adding a Presence State

To add a new state, click on Add State in the menu.


Select the Type of presence state you'd like to add. The options are Available, Chat, Away, DND, Extended Away, and Unavailable, as described below.


You are available and able to take calls and accept chats.


You are available but would prefer to be contacted via chat instead of a phone call.


You are away, usually for a short period of time, such as at lunch or in a meeting.


You are busy and do not want to be contacted at this time.

Extended Away

You are gone for a long period of time, such as on vacation or in a business meeting.


You are able to take calls but not able to accept chats. You will generally not show up as "online" in chat clients.


This is the text that will appear in parenthesis () next to the status.

For example: "Away (lunch)"

Submit and Apply Changes

When done creating your new presence state, click the Submit button. There is no Apply Config button.

Editing a Presence State

To edit a state, click on the edit button (pencil icon) next to its name in the list. A form will appear:

  • Make the desired changes.
  • When done, click the Submit button. There is no Apply Config button.

Deleting a Presence State

You can delete a presence state, either while viewing the list page or while viewing a specific presence state.

  • In the list: click on the delete button (trash can icon) next to the name, OR...
  • While viewing the specific presence state: Click on the Delete button.
  • In both cases, an alert window will pop up asking you to confirm the deletion. Click OK to proceed. There is no Apply Config button.
  • No labels