FreePBX Tutorial

  Creating an account for VOP

To install Voice Operator Panel (VOP) with FreePBX you need to create an extension that VOP will use to register to the FreePBX server.

This extension will also be used to receive incoming calls, monitor other extensions and transfer incoming calls to them.

This extension must be dedicated to VOP and not shared with another phone even when VOP is tethered to a hardphone.

This extension must be configured to receive all the incoming calls destined to your company. If a tethered hardphone is used its purpose is only to be called by VOP to talk/listen to calls received/placed by VOP. Please read "How does VOP behave when tethered to a hard phone ?" in our FAQ before using a hard phone.

VOP can only manage and transfer its own incoming/outgoing calls.

However, VOP can also pick-up a ringing call on a monitored extension then transfer it to another extension, but this shall not be the regular way to handle calls.

Log to the FreePBX admin web interface and select: Applications > Extensions > PJSIP/Chan_SIP Extensions, then click on "Add New Extension" to add a new extension.

Enter an extension number in the "User Extension" field, an extension name in the "Display Name" field and a password in the "Secret" field then click on "Submit". Finally click on the top/right red button "Apply Config".

For this tutorial we will use the extension number "901", the extension name "VOP" and the password "secret".

  Configuring the extension in VOP

When the VOP extension is set up, you can start VOP and configure it through the wizard:

"Enter your display:" - Enter the extension name (caller ID) of the application. ("VOP" in our tutorial)
"Enter your user name:" - Enter the extension number. ("901" in our tutorial)
"Enter your SIP server host name or address:" - Enter the host/domain name of the FreePBX server.
"Enter your SIP server port:" - Leave it to zero.
"Enter your SIP server user name:" - Leave it blank.
"Enter your SIP server password:" - Enter the password of the extension. ("secret" in our tutorial)
"Enter your voicemail phone number:" - Enter "*97".

Finish the wizard by entering other information not related to FreePBX.

VOP will start and register to your FreePBX server.

  Populating the directory

You will now need to build the Local directory of VOP with the extensions at your FreePBX server.

There are two ways to do it:

1. You can manually add every extension.
2. You can import the list of all the extensions at your FreePBX server.

First you will need to remove the dummy/example user "Doe, John" by right-clicking on him and selecting: User > Remove.

If you select (1): For each user you want to add you need to right-click in the Local directory and select: User > Add.

If you select (2): Export all your extensions from your FreePBX web interface in: Admin > Bulk Handler > User Manager Users, click on "Export". Now right-click in the Local directory of VOP and select: Directory > Import > File, then select the exported file. Select "Phone" for "default_extension", "First Name" for "fname", "Last Name" for "lname", "Mobile" for "cell" then click on "Import".

You should now see all your users in the Local directory with a green background that will change to show their phone status (Green: available, Yellow: ringing, Orange: busy).

There is one last step to configure if you want to be able to pick-up (intercept) a call ringing on an extension.

Go to the Settings window of the application and enter "**$" in: Account > Call intercept code. (and click on Save)

You will then be able to intercept a call ringing on an extension by right-clicking on the extension and selecting: Intercept.


You have now fully configured VOP for your FreePBX server.

If you have any problem press Alt-D to show the debug window of VOP, you should be able to read the problem from there.

If not, please contact us we will gladly help you.

  Discovering VOP

To learn how to use VOP please watch our Videos.

To learn more about VOP please also read our F.A.Q

You will learn how to set up many features such as: Hardphone tethering, Outlook, LDAP, CRM, Multi-tenancy, Provisioning and more...