Why do we need the 3CX Barge Message? #

Companies all over the world use Compliance messages on an everyday basis. Some examples of these messages are,

• Notify the callers that their call is going to be recorded.
• Disclaimer statements.
• Service agreements.
• Policy statements.

Purpose of 3CX Barge Messages: #

• Save the agent’s voice and let the system say it for the agent.
• Present all the information with consistency to the customer.

How do Barge Messages work? #

3CX Barge Messages works by assigning prompt (.wav audio) files to Digital Receptionists (IVR). Agents use a
simple web interface to select the desired prompt. When ready, the agent will press a button on the web page to
play the selected message. The message is heard by both the agent and all other callers participating in the
current phone call.

Prerequisites: #

Before you attempt to install 3CX Barge Messages, you need to ensure your computer meets the minimum
requirements outlined below:

• 3CX Professional / Enterprise Edition Version 18 Service Pack 4 or above
• Windows 10 or above / Windows Server 2016 or above
• Microsoft SQL Server 2016 or above (Including the free SQL Express edition)
• Microsoft .Net 4.7.2 or above
• VoIPTools 3CX Relay Service installed on the 3CX server (Windows or Linux)
• Microsoft Internet Information Server IIS (https://www.voiptools.com/iis-features-and-configuration)
• 7.0 or above

NOTE:

• Installation on a domain controller may require additional assistance.
• When installing SQL Server, we recommend you install it in “Mixed Mode” to include SQL Authentication, and install SQL Management Studio.
• When installing IIS, be sure to install Basic Authentication, .Net Extensibility, and ASP.Net 4.X.

Installation: #

Step-by-Step Installation Procedure: #

The following section guides you through a detailed walk-through of the installation process:

Step 1: Download ‘3CX Barge Messages’. #

1. Find the software download link in the Order Confirmation Email, or you can find it in your order history on our website and download the 3CX Barge Message application.
2. In the Microsoft Defender SmartScreen, click the More Info option.

1. Click the Run Anyway option to start the installation.

Step 2: Install Prerequisites #

Click on the software installer that was downloaded in step 1 above. The installation wizard will automatically
identify the needed prerequisites and assist you with the install of each prerequisite needed to run ‘3CX Barge
Messages’. Prerequisites include .NET Framework (Web Installer), SQL Server Express (Web Installer) and,
SQL Server Management Studio.

1. Double-click on the downloaded installer executable to launch the Prerequisites Setup Wizard and click Next.

2. Select/unselect the applications to be installed based on your unique requirements and click Next to continue.

NOTE:

It is important that you install all the required prerequisites.

The installer automatically downloads and installs the prerequisites. The download may take several minutes.

3. The Microsoft SQL Server License Terms page appears if you have selected to install SQL Server Express. Click Accept to acknowledge the license terms and continue.

4. Browse the Media Location field to change the SQL Server Media target location and click Install to begin the installation of SQL Server Express.

5. Click Close when the prerequisites are successfully installed.

The Microsoft SQL Server Management Studio begins to install. It may take several minutes to complete the installation.

6. Click Yes to reboot your computer.

Step 3: Start the installation process #

1. Click Next to Continue on the 3CX Barge Messages Setup Wizard page.

2. Note the Installation Folder where ‘3CX Barge Messages’ will be installed. Note that you cannot change the path.
3. Click Next to continue.

Step 4: Test Relay Settings: #

1. In the 3CX Relay Services window, in the Relay Host field, enter the IP address or FQDN of your 3CX server.
2. Enter 8801 in the Relay Port field.
3. Enter the public key you took from VoIPTools Relay services in the Public Key text area.

3. Click the Test Relay Settings to confirm ‘3CX Barge Messages’ can communicate with the Relay services running on the 3CX server.
4. If the ‘3CX Barge Messages’ is successfully able to communicate with the Relay services that run on the 3CX server, a Success message box appears. Click OK. If the test fails, you will not be able to continue until communication with the relay is established.

Click Next to continue with the installation.

NOTE:

If the Relay test was unsuccessful,

• Confirm you have the correct firewall port(s) open (default TCP 8801) on the 3CX server and the perimeter firewall protecting the 3CX server.
• Confirm that you have entered the correct IP address / FQDN for the 3CX server. If using an FQDN, confirm you can resolve the FQDN by pinging the name.
• Confirm that 3CX Barge Messages and the Relay are attempting to communicate on the same port and protocol (HTTPS/8801 or HTTP/8800).

Step 5: Configure the database #

When configuring 3CX Barge Messages, select an existing Microsoft SQL Server instance in your environment. The database server can be a remote SQL Server. Click this link to know How-to configure SQL Server to permit remote connections or on a local instance running on the VoIPTools server.

1. On the SQL Database window, in the Server field, select the desired instance of SQL Server.

NOTE:

• We strongly encourage you to use SQL Authentication rather than Windows authentication. Many of our tools leverage a Call Flow Designer (CFD) application running on the 3CX. Frequently our CFD applications require access to a SQL database.
• If the 3CX server and the database server are not in an Active Directory domain, Windows authentication will fail. To use SQL authentication, your SQL Server must be configured to run in “Mixed Mode”. If you installed SQL Server with one of our tools, we automatically configure SQL in “Mixed Mode”.

2. Uncheck the Trusted Connection checkbox to use SQL Authentication.
3. In the Username and Password fields, enter valid SQL login account credentials.

4. Check the Trusted Connection (Windows integrated authentication) checkbox to use Windows Integrated Authentication (not recommended)
5. Select an existing database name from the list if you are upgrading or reinstalling 3CX Barge Messages. If installing for the first time use the default name In the Database field.
6. Click the Test SQL Connection button to confirm connectivity to SQL Server and then click Next to continue.

Step 6: Installing 3CX Barge Messages #

1. Click Install to start the installation of ‘3CX Barge Messages’ In the Ready to Install window.

The application installation progresses. This may take several minutes to complete.

2. Click Finish when the installation is complete.

Web Portal #

To access the 3CX Emergency Notifier web portal, click the Web Portal button on the configuration program, or Click the desktop icon created in the installation process.

When connecting to the web portal, you need to provide login credentials,

1. In the Extension field, enter your 3CX extension number.
2. In the PIN field, enter your 3CX voicemail PIN.
3. Click Login to log in to your account.

Setting up 3CX Barge Messages #

License Screen #

For registration, you need to log into the 3CX Barge Messages web portal and perform the following tasks,

1. On the 3CX Barge Messages web portal, click License in the main menu.
2. In the Registration section, enter your License Key and other details appropriately and click Register.

About Screen: #

After you register, click About in the main menu. You can check for the Version Number of the product, the
Copyrights year, and the Address of VoipTools, LLC.,

If you find any discrepancy, you can contact or mail us.

Settings Screen #

In The Settings screen, you can do General Setting and Voice Settings for your prompts.

Voice Settings: #

3CX Barge Messages can call your contacts and play recordings. The recordings can be prerecorded or
dynamically created using Text-To-Speech. A dynamically created recording can list information about
the extension where you dialed the emergency number.
The following settings can modify some of the attributes of the voice used to make a dynamic recording.

1. In the Voice Settings section, check the Dynamic Recording check box to turn on Dynamic Recording, or you can uncheck the check box to use a prerecorded recording rather than Text-To-Speech. Upload the prerecorded messages in the Messages tab.
2. From the Locale drop-down list, select the desired culture.

3. On the TTS Type drop-down list, select the TTS Type as Windows TTS(#WindowsTTS) or Amazon Polly(#AmazonPolly).
   1. Select TTS Type: Windows TTS to create dynamic play files by using the voices installed on your computer.
      1. In the Voice Name drop-down list, select the voice you want to use for dynamic recordings. The drop-down list generally displays all Voices installed on the computer.
      2. On the Gender drop-down, select Male or Female so that the Emergency Notifier will play the .wav file in the male or female voice.
      3. In the Volume drop-down list, select the volume you want to apply for your recording.
      4. On the Speech Rate drop-down list, select the desired speech rate to adjust the speed of the speech.

1. 2. Select TTS Type: Amazon Polly to create a Self Identification Message (.wav file) using Amazon
      Web Services.
      1. In the Amazon Id and Amazon Key fields, enter valid details.
         1. Learn to create an account on Amazon Web Services (AWS) and generate an AWS
            access key ID and the secret keyID using this link.(#aws)
      2. In the Voice Name drop-down list, select the voice you want to use for dynamic recordings.
         The drop-down list generally displays all the Voices installed on your computer.

4. Click Save to save the data.

General Settings: #

In General settings, you can select the list of IVRs for barging in the calls.
The IVRs are fetched from the Digital Receptionists under the 3CX Console Management.

• Select the checkboxes of the desired barge messages and click Save.
• You can click Cancel to cancel the operation.

Once you save the IVR selections, you will get a Success dialog box. Click OK.

Prompts Screen #

In the Prompts screen, you can insert your Prompt Messages and barge the Prompt Messages in calls.

• To insert a Prompt, follow the procedure,

On the Prompt Administration box in the File Name field, enter the name for your Prompt Message.
In the Version field, enter the version for your Prompt Message.
In the Description field, enter the description for your Prompt Message.
Select the Upload Audio File checkbox or Add Prompt Text checkbox and click Save.

• To upload an audio file,

Select the Upload Audio File Checkbox.
Enter your audio file path location or use Browse to browse your audio file and click Save.

Fig 29: Insert a prompt via the Upload Audio File option

• To add a Prompt text,

Select the Add Prompt Text checkbox.
In the Prompt Text field, enter the text you want to play as audio and click Save.

Fig 30: Insert a prompt via the Add a Prompt Text option

• Click Cancel to cancel the Prompt message,

When you save the Prompt message, you will get an Info dialog box. Click the OK button to add the Prompt
message to the Prompts Table.

NOTE:

• You can have the same File Names with different versions.
• Example :
  • If you can have a file “Test_Sample version 1”, you can have “Test_Sample version 2,” but you
  • cannot have “Test_Sample version 1.”

In the Prompts Table,

• Click Play to play and test your prompt message.

Fig 32: Play the Prompt

• Click BargeIn to barge in your prompt message to the call.
• Click Delete to delete the prompt messages from the Prompt Table.

Fig 33: Delete the Prompt

Reports Screen #

In the Reports screen, you can see the reports of the BargedIn calls made by the user and the manager.

Date Time	The date and time of the prompt messages barged in. The date format is mm/dd/yy and the Time format is hh: mm: ss.
Phone Number	Phone number to which your prompt messages barged in. If the phone number is the same server extension, it is an Internal inbound call. If the phone number has another server inbound number, it is an External call.
Extension	The extensions to which you barged in your prompt messages.
File Name	The file name of your prompt message.
Version	The version of your prompt message.

Support #

Visit our website to access our on-line manuals and receive quick answers to most of your questions. Otherwise, you can contact us by phone, email, live chat and on the VoIPTools forums.

Support Hours (USA and India) #

Our team is ready to assist you with answers to your technical questions and we now offer 24/7, 365 days a year.

Windows Event Log (Applications and Services VoIPTools) #

The Windows Event Log lists various errors, information messages and warnings related to all our VoIPTools applications and services. The data here can be used for troubleshooting various application errors.

Forums #

Our forum is intended for VoIPTools customers to collaborate on real-life challenges, solutions and best practices. You can participate on our forum at: https://www.voiptools.com/community/

Submit a Bug #

If you suspect a bug in any of our VoIPTools products, you can bring it to our notice by reporting your issue at: https://www.voiptools.com/report-a-bug/

Live Chat #

Our chat support team is ready to acknowledge your queries in real-time. You can start a live chat with us by simply clicking on the Live Chat button at the lower right corner of our web page.

Email #

You can email us at: support@voiptools.com. Be sure to describe your issue in detail. We’ll get back to you within one business day of receiving your request.

Phone #

You can call us at +1 801-642-4655 to reach a representative. VoIPTools will accept calls at this number from 8:00 AM to 6:00 PM (Central Standard Time).

Support Services #

Free Support: #

If you purchased our products through a VoIPTools Partner, your Partner will provide first level support. Partners have access to 100% free technical support, provided they participate actively in the troubleshooting process.

VoIPTools customers have access to our on-line manuals and we will respond to emails (next business day) and live chat, but we will not login to your servers remotely.

Paid Support: #

If you purchase “Installation Support’ our support team can login to your servers and install and configure all our tools for you. This includes installing SQL Server Express and Internet Information Server if required. Our team will work with you to configure our applications to best meet your needs.