---
title: Preview Dialer V20
description: "# Introduction ***Revolutionize Your Call Center Operations with Surveyor: The Future of Campaign Management and Customer Engagement*** The 3CX Surveyor is an advanced web-based \"preview\" dialer designed to revolutionize your call center's campaign management. With Surveyor, you easily make impactful…"
url: "https://voiptools.com/docs/preview-dialer-v20/"
updated: "2026-09-07"
category: "Tools - V20"
---

# Preview Dialer V20

# Introduction

***Revolutionize Your Call Center Operations with Surveyor: The Future of Campaign Management and Customer Engagement***

The 3CX Surveyor is an advanced web-based "preview" dialer designed to revolutionize your call center's campaign management. With Surveyor, you easily make impactful outbound calls to your contacts, ensuring high-touch interactions and exceptional results. Manage campaigns, assign agents to phone lists, and personalize interactions with script-reading capabilities. Gain valuable insights through web-based performance reports to optimize your call center operations. 3CX Surveyor provides detailed customer profiles, an integrated mini CRM, and the tools to treat customers like family, empowering your team to build strong relationships, ensure customer satisfaction, and drive sales.

## What is a 3CX Surveyor?

The 3CX Surveyor is a web-based "preview" dialer designed for the 3CX platform. Empower your agents to conduct personalized outbound calls, manage campaigns efficiently, use survey scripts, and generate performance reports. Manually import contacts into the tool and seamlessly integrate it with 3CX PBX for Windows. Agents can work from home or the office using the user-friendly web interface and 3CX softphone. Optimize your outbound calling processes with 3CX Surveyor for remarkable results.

## Why choose 3CX Surveyor?

| ![](https://voiptools.com/wp-content/uploads/2023/01/captivating-script.png) | **CAPTIVATING SCRIPTS** | Effectively engage your clients with captivating, personalized scripts tailored to their needs and preferences. Our user-friendly web-based system enables seamless script management and customization for exceptional customer interactions. |
| --- | --- | --- |
| ![](https://voiptools.com/wp-content/uploads/2023/01/seamless-monitoring-1.png) | **SEAMLESS MONITORING** | Efficiently monitor customer service progress with our integrated mini CRM. Track and evaluate customer interactions seamlessly to deliver personalized experiences and exceptional support. |
| ![](https://voiptools.com/wp-content/uploads/2023/01/real-time-insights-1.png) | **REAL-TIME INSIGHTS** | Gain access to comprehensive and real-time insights through powerful web-based performance reports on survey data. Utilize simple yet robust analyses to reveal valuable trends and patterns, empowering data-driven decisions that propel your business forward. |
| ![](https://voiptools.com/wp-content/uploads/2023/01/campaign-optimization.png) | **CAMPAIGN OPTIMIZATION** | Efficiently organize and optimize your campaigns by assigning agents to targeted phone lists and equipping them with survey scripts. Empower your team to conduct impactful outreach, ensuring valuable feedback and driving superior campaign results with confidence |
| ![](https://voiptools.com/wp-content/uploads/2023/01/high-touch-outbound-calls-1.png) | **HIGH-TOUCH OUTBOUND CALLS** | Establish profound connections with your contacts through our personalized and "high-touch" outbound calls. Our solution empowers your agents to confidently build rapport and foster relationships, guaranteeing that every interaction leaves a positive and enduring impact. |

# Prerequisites

**Before you begin with the installation steps mentioned in this guide, you need to ensure that your computer meets the minimum requirements mentioned below for installing a 3CX Surveyor.**

| **PREREQUISITE** | **PURPOSE** |
| --- | --- |
| **3CX Version V20** | 3CX **Surveyor** is designed to work seamlessly with this version for enhanced features and performance. |
| **Windows 10 or above / Windows Server 2012 or above** | These operating systems provide the necessary environment for the application to run efficiently. |
| **[IIS Features and Configuration – VoIPTools](https://voiptools.com/docs/iis-features-and-configuration/)** | IIS is needed as a web server to host and manage web-based applications and services. |
| **.NET Framework 4.7.2 (Web Installer)** | This framework provides essential components for running and developing applications. |
| **VoIPTools Universal Updater** | This component is necessary for updates, ensuring the application remains current and functional. |
| **VoIPTools Relay Service** | It is used for proper integration and functionality of the 3CX **Surveyor**within the 3CX environment. |
| **Microsoft SQL Server 2016 or above (Including the free SQL Express edition)** | 3CX requires Microsoft SQL Server 2016 or later for database management. |
| **Static IP for VoIPTools and 3CX servers** | This is to ensure proper two-way communication, both the 3CX server (Relay) and the VoIPTools server. Dynamically assigned IP addresses are not supported. Additionally, it is recommended to use HTTPS for secure communication, which requires a FQDN for SSL/TLS certificate validation between the VoIPTools server and the Relay. |
| **8 GB RAM** | You need a minimum of 8 GB RAM to ensure that the 3CX Surveyor, along with other necessary applications (like VoIPTools, IIS, SQL Server, and .NET Framework), can run smoothly and efficiently |
| **Port number **5800**opened on your device** | Port 5800 is a specific network port used by 3CX for communication purposes. Opening this port on the device's firewall allows incoming and outgoing traffic to pass through, enabling the 3CX software to send and receive data over the network effectively. |

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> - 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 on a domain controller is not supported.**

| ![](https://voiptools.com/wp-content/uploads/2023/01/1-2.png) | **DOWNLOAD SOFTWARE** | You can order 3CX Surveyor online at [https://www.voiptools.com](https://voiptools.com/downloads/).  Your order confirmation email will include your license key and a link to download the software. |
| --- | --- | --- |
| ![](https://voiptools.com/wp-content/uploads/2023/01/2.png) | **INSTALL PREREQUISITES** | You must install several prerequisites before installing the 3CX Surveyor. The Advanced Installer identifies and installs these applications automatically. Click **[here](https://voiptools.com/docs/queue-notifier-v20/#2-toc-title)**to learn about the required prerequisites. |
| ![](https://voiptools.com/wp-content/uploads/2023/01/3.png) | **INSTALL 3CX SURVEYOR** | This User Guide contains step-by-step instructions to successfully install 3CX Surveyor. Begin by extracting the installer from the downloaded zip file (Step 1 above), then run the setup program named **Surveyor.exe** |
| ![](https://voiptools.com/wp-content/uploads/2023/01/4.png) | **LOG IN TO THE WEB APPLICATION** | You can now log in to the web application using the extension number and the PIN. |

# Step-by-step Installation Procedure

## Step 1: Download 3CX Surveyor(Server)

Find the software download link in the **Order Confirmation Email**, or you can download the application by following the procedure,

1. Open your browser and go to the **VoIPTools official website** or click ***[here](https://voiptools.com/downloads/)***to get redirected to the website.
2. Search for the**On Surveyor Application** and click the **Download**![](https://voiptools.com/wp-content/uploads/2024/01/download-button.png)button to download your application.

## **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 installation of the prerequisites needed to run the 3CX Surveyor.

1. Click the downloaded installer executable to launch the **Prerequisites Setup Wizard** and click **Next.**

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-prereq-setup-wizard-1.png)
Figure 1: Prerequisite Setup Wizard

1. In the **Prerequisites** window, the installer will identify the missing prerequisites. You must install all the required prerequisites. However, you can select/unselect the applications to be installed based on your unique requirements and click **Next** to continue.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-select-prereq-1.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-select-prereq-1.png)
***Figure 2:*** Prerequisites Selection Window

The installer will download and install the selected applications.

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Prerequisites-Installation-in-progress.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Prerequisites-Installation-in-progress.png)
***Figure 3: Prerequisites Installation in progress***

1. In the **Microsoft SQL Server License Terms **click the **Accept **button to acknowledge the license terms and continue.
   - This page appears if you do not have **SQL Server Express** preinstalled in your device.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-CW-V20-SQL-license.png)
***Figure 4: SQL Server Express: Accept License Terms***

1. View the SQL Server Media target location in the **Media Location** field. If required, you can click the **Browse**button to change the location. Click **Install** to begin the installation of SQL Server Express.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-CW-V20-server-express-target-location.png)
***Figure 5: SQL Server Express: Target Location***

SQL server installation is in progress. This may take several minutes to complete.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-CW-V20-server-installation-in-progress.png)
Figure 6: SQL Server Installation In Progress

1. Click the **Close**button once the prerequisites are installed.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-CW-V20-server-express-installated-successfully.png)
***Figure 7: SQL Server Express: Installed Successfully***

1. In the **Confirmation Message**box, click **OK**to reboot the computer.

## Step 3: Start the installation process

1. After all the prerequisites are installed, click Next in the **3CX Surveyor Setup Wizard** Continue.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-4.-setup-wizard.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-4.-setup-wizard.png)
***Figure 9: Surveyor setup wizard***

1. On the **Select Installation Folder** window, in the **Folder** field view the location where the 3CX Surveyor gets installed.
2. Click **Next** to continue with the installation.[https://web.archive.org/web/20220814061434/https://www.voiptools.com/wp-content/uploads/10.png](https://web.archive.org/web/20220814061434/https://www.voiptools.com/wp-content/uploads/10.png)

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE:**
>
>
>
> You cannot change the path.

[![](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Surveyor-select-the-installation-folder.png)](https://voiptools.com/wp-content/uploads/2023/03/Screenshot-Surveyor-Surveyor-select-the-installation-folder.png)
***Figure 10: Surveyor select the installation folder***

## Step 4: Test Relay Settings

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

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-6.-relay-services.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-6.-relay-services.png)
***Figure 11:*** Test Relay Settings

1. Click the **Test Relay Settings**to confirm 3CX Surveyor can communicate with the Relay services running on the 3CX server.
2. If the 3CX Surveyor successfully communicates 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.
3. Click **Next** to continue with the installation.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-7.-relay-test-success.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-7.-relay-test-success.png)
***Figure 12:*** Relay Test Successful Message

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE:**
>
>
>
> - You must set the Relay Port to 8801.
> - *If the Relay test fails, you cannot continue the installation until you establish communication with the Relay.* Confirm the following if the test was unsuccessful:
>   - Confirm you have the correct firewall port open (default TCP 8801) on the 3CX server and the firewall protecting the 3CX server.
>   - Confirm that you have entered the correct FQDN for the 3CX server.
>   - Confirm that the 3CX Surveyor and Relay use the same port and protocol.

## Step 5: Configure the database

When configuring the 3CX Surveyor, select an existing Microsoft SQL Server instance in your environment.  The database server can be a **[remote SQL Server](https://voiptools.com/docs/configure-sql-server-for-remote-access-over-internet/)**, or a local instance running on the VoIPTools server.

You can set up the SQL database using SQL Authentication or Windows Integrated Authentication.

### SQL Authentication

1. Enter *your server name* in the **Server** field.
   -  If using the free ***SQL Express Edition***, the default SQL Instance name is ***SQLExpress***.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-8.-SQL-database-Server-Dropdown.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-8.-SQL-database-Server-Dropdown.png)
***Figure 13:*** Server Field

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE:**
>
>
>
> - If you want to use ‘SQL Authentication’, then install SQL Server in ‘Mixed‘ mode.
> - If SQL Server is installed on a server other than the server where 3CX Exporter is installed, you will need to configure SQL Server to allow remote connections.

1. Enter *your credentials* in the**Username** and**Password** fields.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-8.-SQL-database-credentials.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-8.-SQL-database-credentials.png)
***Figure 14:*** Database Credentials

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE:**
>
>
>
> Make sure that you select a SQL Login that has sufficient permissions to alter the database and create SQL objects.

1. Select or enter the *3CX Surveyor*in the **Database** dropdown.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-8.-SQL-database-db-dropdown.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-8.-SQL-database-db-dropdown.png)
***Figure 15:*** Database Dropdown

1. In the **Test SQL Connections** section, click the **Tool**button to test the connection and click **OK**in the **Test Results**popup box.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-9.-database-connection-success.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-9.-database-connection-success.png)
***Figure 16:*** Database Connection Success Message Box

### Windows Integrated Authentication

1. To use **Windows Integrated Authentication** check the **Trusted Connection (Windows integrated authentication)** checkbox.
   -  The VoIPTools installer will create a local Windows user name as “VoIPToys” and give you sufficient rights to this user to create/update the SQL database.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-10-trusted-connection.png)
Figure 17: Trusted Connection Checkbox

1. In the **Test SQL Connection** section, click the **Tool**button to test the connection.
2. Click the **Next**button which gets enabled when the database connection is successful.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-11.-trusted-connection-test-success.png)
Figure 18: Trusted Connection - Test Successful

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> We 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 configure SQL in “Mixed Mode”.

## Step 6: Installing 3CX Surveyor

1. In the **Ready to Install **window, click **Install** to start the installation of the 3CX Surveyor.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-12.-ready-to-install.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-12.-ready-to-install.png)
***Figure 19:*** Ready To Install Window

The application installation progresses.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-13.-installation-in-progress.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-13.-installation-in-progress.png)
***Figure 20:*** Installation In Progress

1. Once the installation is complete, click **Finish** to complete the installation process.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-14.-finish-button.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-14.-finish-button.png)
***Figure 21:*** Finish Button

## Step 7: **Login to the Web Application**

**Before you Start:** Make sure you have **registered with the VoIPTools Relay** which grants access to the application.

Follow the procedure to register your software,

1. Click the**3CX Surveyor desktop icon** ![](https://voiptools.com/wp-content/uploads/2024/11/logo.png) to open the web application.
2. On the **Login**page, do the following tasks,
   1. In the **Extension** field, enter *your 3CX extension number.*
   2. In the **PIN **field, enter *your 3CX voicemail PIN.*
   3. Click the **Login **button to log in to your account

![](https://voiptools.com/wp-content/uploads/2024/11/login-page-1024x532.png)
Figure 22: Login Page

## Login Privileges:

Login privileges in 3CX Surveyor ensure secure, role-based access to the system. Managers have full access to configure settings and oversee operations, while Agents are limited to specific functionalities like the Wallboard screen. These privileges enhance security, streamline workflows, provide tailored experiences, and enable efficient user and role management.

You can log in to the 3CX Surveyor as a Manager and as an Agent. An Agent has access only to the

[![](https://voiptools.com/wp-content/uploads/2024/10/screenshot-Surveyor-V20-agent-view.png)](https://voiptools.com/wp-content/uploads/2024/10/screenshot-Surveyor-V20-agent-view.png)
Figure 23: Wallboard screen Agent view

As a Manager, you have access to all the tabs in the 3CX Surveyor.

[![](https://voiptools.com/wp-content/uploads/2024/10/screenshot-Surveyor-V20-1.-manager-view.png)](https://voiptools.com/wp-content/uploads/2024/10/screenshot-Surveyor-V20-1.-manager-view.png)
*Figure 24: Wallboard Screen* Manager view

To learn how to assign roles to the agents in the 3CX Console Management, click here.

## Getting Started with 3CX Surveyor

![](https://voiptools.com/wp-content/uploads/2024/11/ss-surveyor-v20-edited-1024x221.png)
Figure 25: Web Application - Overview

| ![](https://voiptools.com/wp-content/uploads/2024/09/number-one.png) | **Application Logo** | This is the default application logo. You can modify and use a custom logo in the Site Settings. |
| --- | --- | --- |
| ![](https://voiptools.com/wp-content/uploads/2024/09/number-two.png) | **Header Title Prefix** | This is the default header title prefix. You can modify and use a custom header title prefix in the Site Settings. |
| ![](https://voiptools.com/wp-content/uploads/2024/09/number-three.png) | **Menu Bar** | The menu bar displays all the menus available. |
| ![](https://voiptools.com/wp-content/uploads/2024/09/number-four.png) | **User Details** | The application shows the extension number and the name of the user. |

### Overview of the Menu Bar

| **Dialer menu** | The Dialer Menu streamlines campaign management, call operations, and agent workflows, enhancing communication efficiency and improving customer engagement. |
| --- | --- |
| **Campaign menu** | The Campaign Menu lets you create, organize, and manage campaigns, assign agents, configure scripts, and streamline campaign coordination. |
| **Contact menu** | The Contacts Menu manages contacts, updates details, sets preferences, tracks interaction history, and enhances communication and database accuracy. |
| **Questions menu** | [content] |
| **Import menu** | The Import menu helps you upload, map, and organize contacts from a CSV file into the central repository efficiently. |
| **Reports menu** | The **Reports** menu provides insights into campaigns, agent activity, and customer interactions, aiding decision-making, strategy optimization, and performance improvement. |
| **Settings menu** | The Settings menu offers customization for functionality, security, and branding, including General Settings for operations and Site Settings for visuals. |
| **About menu** | The About menu provides software version, company details, and support contact, ensuring easy access to version verification and assistance. Click the link to know more about the **[VoIPTools support](#support).** |

## Settings Menu

The Settings menu in the 3CX Surveyor portal provides comprehensive customization options to enhance both functionality and branding. It consists of two sections: General Settings, which optimize usability, security, and operational efficiency, and Site Settings, which allow for visual customization of the application’s branding, improving user experience and alignment with your brand.

![](https://voiptools.com/wp-content/uploads/2024/11/settings-menu-dropdown-2-1024x201.png)
Figure: Settings Menu Dropdown

| **General Settings** | The General Settings allow customization of culture, access, wait times, session expiry, and automatic CSV imports for enhanced efficiency. |
| --- | --- |
| **Site Settings** | Site Settings allow you to customize the application’s branding, including header colors, grid colors, logo, and title prefix. |

### General Settings

The General Settings section allows you to customize various aspects of the 3CX Surveyor portal to enhance usability and security. You can adjust culture settings, manage portal access, set wait times between contact retries, define session expiry times, and enable automatic CSV imports for streamlined contact management. These settings improve operational efficiency, ensure data consistency, and allow for a tailored user experience, ultimately optimizing the functionality of the portal for campaign and user management.

#### How to Open the General Settings

This section guides you to open the General Settings in the web application.

**Before you Start:** Make sure you have logged in with manager rights.

1. Hover over the **Settings**menu in the menu bar.
2. In the drop down, click the **General Settings**option.

![](https://voiptools.com/wp-content/uploads/2024/11/settings-menu-dropdown-Copy-2.png)
Figure: Settings Menu Dropdown - General Settings

**Results:** You have opened the General Settings screen. Read further to learn the functions of each tabs in the General Settings.

#### Getting to Know Tabs in General Settings

| Tab Name | Purpose of the tab |
| --- | --- |
| **Widget** | The Widget Tab allows you to customize the Dialer screen by selecting desired widgets, improving accessibility and user experience. |
| **General** | The General tab customizes culture, access, wait times, session expiry, and imports, enhancing usability, security, and operational efficiency. |
| **Controls** | The Controls tab manages role-based access, customizes control items, and allows permission assignments, enhancing security, efficiency, and application clarity. |
| **Dispositions** | The Disposition tab categorizes call outcomes, improving clarity, follow-up efficiency, and decision-making for better customer interactions and satisfaction. |
| **Lookups** | The Lookups tab manages preset values, standardizing data entry, improving consistency, reporting, and user experience, while controlling available selections. |

#### Widget Tab - Configure Widgets in Dialer Menu

The **Widget Tab** lets you select the desired widgets to display on the Dialer screen. With this feature, you can customize your interface by choosing which widgets to include, enhancing your user experience and allowing for quick access to relevant tools and information. This flexibility ensures that you can tailor the Dialer menu to meet your specific needs and preferences.

Before you start, make sure you have logged in with **Manager credentials** and navigated to the **Widgets tab** in the**General Settings**under the **Settings menu.**

1. Select the desired widget in the **Enable**column.
2. Click the **Save**![](https://voiptools.com/wp-content/uploads/2023/01/save.png) button.

 ![](https://voiptools.com/wp-content/uploads/2024/10/Modify-widgets-in-dialer-tab.gif)

Figure: Configure Widgets

**Results:**The selected widgets are updated on the **Dialer**screen according to your preferences. This customization allows you to rearrange, add, or remove widgets, ensuring that the interface reflects your workflow and enhances your efficiency.

![](https://voiptools.com/wp-content/uploads/2024/10/3.-output-in-dialer-tab-1024x485.png)
Figure: Dialer Menu with Modified Widgets

#### General Tab

The **General** tab provides tools to customize culture settings, manage portal access, set wait times, define session expiry, and enable automatic CSV imports. These features enhance usability, security, and efficiency, streamline contact data management, and ensure organized operations within the 3CX Surveyor portal for improved campaign and user management.

##### General Section

The **General** section enables you to customize culture settings, manage portal access, set contact wait times, and define session expiry time, enhancing usability, security, and operational efficiency in the 3CX Surveyor portal.

###### Set Culture Settings

You can utilize the culture settings to control the display format of dates and currency across the web portal. By default, these settings are configured to English, however, they can be adjusted to suit your specific preferences.

Before you start, make sure you have logged in with Manager credentials and navigated to the General tab in the General Settings under the Settings menu.

1. Click to open the **Culture**dropdown.
2. Select the desired culture and click the **Save**![](https://voiptools.com/wp-content/uploads/2023/01/save.png)button.

![](https://voiptools.com/wp-content/uploads/2024/10/screenshot-surveyor-V20-1.-culture-dropdown-1024x811.png)
Figure: General Section - Culture Dropdown

**Results:** You have changed the display culture of the 3CX Surveyor web application.

###### Manage Access to Surveyor Web Portal

The **Surveyor Access Management** feature lets you control access to the Surveyor web portal by designating a 3CX extension group. With this feature, you can ensure that only members of this specific extension group have permission to log in to the portal, and Surveyor licensing is aligned with the total number of members in this group, including extension group managers.

This feature also grants the following capabilities to Managers within the extension group:

- Creating campaigns
- Managing and importing contact lists
- Assigning agents to lists

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon-4.png)**NOTE:**
>
>
>
> To assign the Manager role to a specific extension,

Before you start, make sure you have logged in with **Manager credentials** and navigated to the **General**tab in the **General Settings** under the **Settings**menu.

1. Click to open the **Survey Extension Group**dropdown.
2. Select the desired extension group and click the **Save**![](https://voiptools.com/wp-content/uploads/2023/01/save.png)button.

![](https://voiptools.com/wp-content/uploads/2024/10/screenshot-surveyor-V20-2.-ext-group-dropdown-1024x815.png)
Figure: General Section - Surveyor Extension Group

**Results:** The members of the selected group are granted access to log in to the Surveyor web portal. Additionally, Surveyor licensing will be calculated based on the number of individuals in the chosen extension group, including both members and any assigned group managers.

###### Set Wait Time

The **Wait Time**feature lets you set a specific interval before a contact is presented again after receiving a previous disposition, such as *No Answer.* This setting enables efficient contact management by controlling reattempt timing, helping to prevent immediate retries and improve engagement opportunities on subsequent contact attempts.

Before you start, make sure you have logged in with **Manager credentials** and navigated to the **General**tab in the **General Settings** under the **Settings**menu.

1. On the **General**section in the **Wait Time**field, set the desired wait time.
2. Click the **Save**![](https://voiptools.com/wp-content/uploads/2023/01/save.png)button.

![](https://voiptools.com/wp-content/uploads/2024/10/screenshot-surveyor-V20-3.-wait-time-1024x807.png)
Figure: General Section - Wait Time Dropdown

**Results:** The contacts who were previously dispositioned with outcomes like "*No Answer*" will not be immediately reattempted. Instead, they reappear in the system for follow-up only after the specified waiting period has elapsed.

###### Set Session Expiry Time

The **Session Timeout** feature lets you manage the web page session expiration based on user inactivity.

With this feature, you can automatically terminate a session after a specified period, enhancing security by minimizing the risk of unauthorized access. When a session expires, users are redirected to the login page and must reauthenticate to regain access to the portal.

Before you start, make sure you have logged in with **Manager credentials** and navigated to the **General**tab in the **General Settings** under the **Settings**menu.

1. On the **General**section in the **Session Timeout**field, set the desired session expiry time.
2. Click the **Save**![](https://voiptools.com/wp-content/uploads/2023/01/save.png)button.

![](https://voiptools.com/wp-content/uploads/2024/10/screenshot-surveyor-V20-4.-session-time-out-settings-1024x812.png)
Figure: General Section - Session Timeout Field

**Results:**The user session expires after the set period of inactivity. This means that if a user does not interact with the web portal within the specified time frame, their session gets terminated automatically and the user will be redirected to the login page, requiring them to re authenticate to continue using the portal.

##### Auto Import Section - Enable Automatic Import of New CSV Files

The purpose of the **Automatic Import** feature is to streamline the process of importing contact data into campaigns by enabling Surveyor to monitor a designated folder for new CSV files. When a new file is detected, its contents are automatically imported, reducing the need for manual intervention and ensuring that the campaign data is always up to date.

**Benefits:**

- Automating contact data entry processes saves time.
- Integrating new information enhances campaign effectiveness.
- Minimizing human error improves data accuracy and reliability.

The **Auto Import**feature lets you automate CSV file imports, skip header rows, set archive paths, and download templates for proper data formatting in campaigns.

Before you start, make sure you have logged in with **Manager credentials** and navigated to the **General**tab in the **General Settings** under the **Settings**menu.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon-4.png) **NOTE:**
>
>
>
> Before initiating the auto-import process for your CSV files, download and use the sample CSV file to ensure proper formatting of your files.
>
>
>
> ![](https://voiptools.com/wp-content/uploads/2024/10/screenshot-surveyor-V20-5.-download-CSV-button-1024x817.png)
> Figure: Download Sample CSV Link

1. In the **Auto Import**section, select the **Auto Import Contacts** box to enable the auto import feature.

![](https://voiptools.com/wp-content/uploads/2024/10/screenshot-surveyor-V20-1.-auto-import-contacts-box-1024x817.png)
Figure: Auto Import Contacts Box

1. Select the **First Row Header**box to skip the first row if your CSV file contains header as first row.

![](https://voiptools.com/wp-content/uploads/2024/10/screenshot-surveyor-V20-2.-first-row-header-box-1024x807.png)
Figure: First Row Header Box

1. Enter the *import path* data in the **Import Path**field to specify where Surveyor monitors for new CSV files.

![](https://voiptools.com/wp-content/uploads/2024/10/screenshot-surveyor-V20-3.-auto-import-save-path-1024x804.png)
Figure: Import Path Field

1. Enter the *archive path*in the **Archive Path**field to move the imported CSV files after processing.
2. Click the **Save**![](https://voiptools.com/wp-content/uploads/2023/01/save.png) button to save your changes.

![](https://voiptools.com/wp-content/uploads/2024/10/screenshot-surveyor-V20-4.-archive-path.png)
Figure: Archive Path Field

**Results:** The Surveyor automatically monitors the designated folder for new CSV files. Once a new file is placed in the specified import path, the system imports the contact data from that file into the designated campaign. Additionally, imported CSV files will be moved to the specified archive path, keeping your import folder organized.

#### Controls Tab

The **Controls** tab enables role-based access management and customization of control items in the 3CX Surveyor portal. It allows administrators to assign permissions for viewing or editing controls to specific user groups and modify control labels for clarity, enhancing security, workflow efficiency, and application customization.

##### Field Definitions of Controls Tab

| Column Name | Purpose/Function |
| --- | --- |
| **Culture** | Displays the language culture in which the information is displayed. |
| **Screen** | Indicates the menu where the control item is present. |
| **Label Name** | Indicates the label of the control item. Label name cannot be changed. |
| **Label Text** | Indicates the name of the control item. You can change the name of the control item. |
| **Control Name** | Name of the control item |
| **Admins** | To allow admins to view the control items, check the box. To restrict their access, simply leave the box unchecked. |
| **Managers** | To allow the managers to view the control items, check the box. To restrict their access, simply leave the box unchecked. |
| **Users** | To allow the users to view the control items, check the box. To restrict their access, simply leave the box unchecked. |

##### Grant Permission to Users to Edit a Control Item

This feature allows organizations to control data access by assigning permissions to specific user groups, such as Admins, Managers, and Users. By enabling role-based access, it enhances data security, supports workflow efficiency, and ensures accountability, allowing only authorized users to modify designated data within the application.

Before you start, make sure you have logged in with **Manager credentials** and navigated to the **Controls**tab in the **General Settings** under the **Settings**menu.

The following instructions enable administrators to grant an agent permission to access a restricted control.

1. Search for the *control item* in the **Label Text**field.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-Surveyor-V20-1.-search-for-a-control-1024x469.png)
Figure: Label Text Field

1. Check the **Users**box to give access to that control item.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-Surveyor-V20-2.-select-the-user-rights-1024x469.png)
Figure: Control Item Access

1. Click the **Save**![](https://voiptools.com/wp-content/uploads/2023/01/save.png)button to save the action.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-Surveyor-V20-3.-saved-popup-1-1024x460.png)
Figure: Control Access Actions Saved

1. Click the **Reload**![](https://voiptools.com/wp-content/uploads/2023/03/refresh.png)button to apply the saved actions.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-Surveyor-V20-4.-reload-button-1024x472.png)
Figure: Reload Button

**Results:** The agent can access the restricted control item.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-Surveyor-V20-5.-output.png)
Figure: Control Item Access Changed

##### Edit Label Text for a Control Item

You can modify the label text of specific controls, enhancing customization and clarity within the application. By editing labels, you can ensure that control names are relevant and meaningful, aiding user navigation and alignment with organizational terminology.

**Before you Begin:** Make sure you have logged in with **Manager credentials** and navigated to the **Controls**tab in the **General Settings** under the **Settings**menu.

1. Search *for the control item*in the **Label Text** field.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-search-for-control-item-1024x469.png)
Figure: Change Label Text - Label Text Field

1. Double-click on the **Label Text**and edit the *label text of the control item.*

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-edit-the-label-text-1024x469.png)
Figure: Edit the Label Text

1. Click the **Save**![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) button to save your actions.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-3.-save-popup-1-1024x450.png)
Figure: Label Text Saved Popup

1. Click the **Reload**![](https://voiptools.com/wp-content/uploads/2023/03/refresh.png)button to apply the saved actions.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-4.-reload-button-1-1024x455.png)
Figure: Edit Label Text - Reload Button

**Results:**The name of the control item is changed.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon-3.png)**NOTE:**
>
>
>
> To view the edited label, you have to set the **Culture**to ***en-US*** in the **General** tab under the **General Settings**. For step-by-step instructions, click **[here](#culture)**.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-5.-output-1-1024x455.png)
Figure: Edit Label Text - Sample Output

#### Dispositions Tab

The Disposition tab categorizes call outcomes like 'Busy' or 'Not Interested,' improving clarity, reporting, and agent workflows. Adding new dispositions enhances call tracking and follow-up efficiency, enabling better decision-making for managers and ultimately leading to improved customer interactions and satisfaction through accurate categorization of call results.

##### Field Definitions of Dispositions Tab

| Column Name | Definition/Purpose |
| --- | --- |
| **Description** | Give you the name of the disposition to configure. |
| **AllowRetry** | Lets the agent try calling again if the first attempt was busy. |
| **Disable** | It disables the disposition from the application. |

##### Add New Dispositions to Call Status Widget

This section guides you to add a new widget to the **Call Status** widget in the **Dialer**menu.

Before you start, make sure you have logged in with **Manager credentials** and navigated to the **Dispositions**tab in the **General Settings** under the **Settings**menu.

1. Click the **Add**![](https://voiptools.com/wp-content/uploads/2023/01/add-button-1.png) button.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshots-Surveyor-V20-1.-add-button-1024x877.png)
Figure: Add New Disposition - Add Button

1. Enter *the name of the disposition* in the **Description**field.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshots-Surveyor-V20-2.-description-1024x915.png)
Figure: Add New Disposition - Disposition Details

1. You can select the **Allow Retry** box to let the agent try calling again if the first attempt was busy.
2. Click the **Save Changes** ![](https://voiptools.com/wp-content/uploads/2023/01/save-button-6.png) button to save your changes.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshots-Surveyor-V20-3.-allow-retry-button-1024x915.png)
Figure: Add New Disposition - Allow Retry Box

**Results:** The new disposition gets added to**Call Status** widget in the **Dialer**menu.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshots-Surveyor-V20-4.-output-1024x504.png)
Figure: Add New Disposition - Sample Disposition Output

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon-4.png)**NOTE:**
>
>
>
> 3CX Surveyor supports batch edits and hence, you may edit one or more dispositions before you save them.

##### Disable an Existing Disposition

This section guides you to disable an existing disposition from the **Call Status**widget in the **Dialer**menu.

Before you start, make sure you have logged in with **Manager credentials** and navigated to the **Dispositions**tab in the **General Settings** under the **Settings**menu.

1. Select the **Disable**box for the dispositions you want to disable from the application.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-1.-disable-disposition-1024x876.png)
Figure: Disable Dispositions - Selecting Dispositions

1. Click the **Save Changes**![](https://voiptools.com/wp-content/uploads/2023/01/save-button-6.png) button to save your results.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-2.-dsve-button-1024x876.png)
Figure: Disable Dispositions - Save Changes Button

**Results:** The selected dispositions are disabled from the **Call Status**widget in the **Dialer**menu.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-2.-dispositions-disabled-1024x465.png)
Figure: Disable Dispositions - Sample Output

#### Lookups Tab

The **Lookups** tab in lets you centrally manage preset values, such as "Buying Status" or "Customer Status," to standardize data entry. You can customize options to improve user experience, ensure data consistency, enhance reporting capabilities, and control available selections, creating a streamlined and flexible application setup.

##### Field Definitions of Lookups Tab

| Columns Name | Definition | Purpose |
| --- | --- | --- |
| **Lookup Type** | It defines the type or category of the lookup. It is used to group different settings under specific labels, such as "Buying Status," "BTC," "Class," or "Customer Status." | It organizes entries into logical groups so that similar items can be managed together. For instance, all entries related to "Buying Status" might reflect a customer's purchasing behavior, while "BTC" could relate to different time segments of a day. |
| **Lookup Value** | This column provides an abbreviated or coded value representing the specific option within each **LookupType** category. Examples include "NB," "NVB," and "VB" under the "Buying Status" type. | These coded values are likely used internally within the system for quick reference or to set specific conditions. This makes it easier to programmatically access specific settings without using long descriptive text. |
| **Lookup Display** | This column shows the human-readable description of each **LookupValue**. This text is what users or system operators see on the user interface, making it easy to understand what each code stands for. | It translates coded values from the **LookupValue** column into plain language, improving usability by making settings understandable at a glance. |
| **Disable** | This column is a checkbox column that lets you disable certain lookup entries. | The administrators can disable specific lookup entries, preventing them from being used or displayed in the interface. This provides control over which options are available or active without permanently deleting them. |

##### How to Add a Lookup?

The following instructions set guides you to add new lookup entries in the **Lookups** tab. By specifying a lookup type, value, and display text, administrators create standardized options for various fields, enhancing data consistency and user experience across the platform.

Before you start, make sure you have logged in with **Manager credentials** and navigated to the **Lookups**tab in the **General Settings** under the **Settings**menu.

1. Click the **Add**![](https://voiptools.com/wp-content/uploads/2023/01/add-button-2.png) button.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-Surveyor-v20-1.-add-button-1024x876.png)
Figure: Add a Lookup - Add Button

1. In the **Lookup Type** field, enter *the lookup type.*
2. In the** Lookup Value** field, enter *the lookup value.*
3. In the **Lookup Display** field, enter *the lookup text to display.*

![](https://voiptools.com/wp-content/uploads/2024/11/2.-lookup-details-1024x911.png)
Figure: Add a Lookup - Lookup Details

1. Click **Save Changes** ![](https://voiptools.com/wp-content/uploads/2023/01/black-tick.png) to save the new lookup.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-Surveyor-v20-3.-save-button-1024x911.png)
Figure: Add a Lookup - Save Changes Button

**Results:**The new lookup gets added in the web application.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-Surveyor-v20-4.-output-1-1024x481.png)
Figure: Lookup Added in Web Application

##### Disable an Existing Lookup

The following instructions guides you to disable a specific lookup's display text in the **Lookups** tab of 3CX Surveyor settings, ensuring updated, accurate information is saved.

Before you start, make sure you have logged in with **Manager credentials** and navigated to the **Lookups**tab in the **General Settings** under the **Settings**menu.

1. Search for the lookups to display.
2. Select the **Disable**box for the lookups to disable.
3. Click **Save Changes** ![](https://voiptools.com/wp-content/uploads/2023/01/black-tick.png) button.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-disable-lookup-1024x634.png)
Figure: Disable Lookups

**Results:** The selected lookups get disabled in the web application.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-lookup-disabled-output-1024x437.png)
Figure: Disable Lookups - Sample Output

### Site Settings

The Site Settings allow you to customize the branding of the web application, providing flexibility in visual presentation. These settings enable you to change the gradient color of the Application Header, modify the grid color for data display screens, upload a custom logo, and set a header title prefix. These customizations enhance the user experience by aligning the application’s appearance with your brand identity, making the interface more visually appealing and consistent with organizational standards.

Site Setting**s** enable you to customize branding settings for the application that includes the following:

- Customize the gradient color of the Application Header.
- Customize grid color in screens that display grid data.
- Customize the logo on the Application Header.
- Customize Header Title Prefix on the Application Header.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-overview-1-1024x504.png)
Figure: Site Settings - Overview

#### **Customize Application Title Header – Gradient Color**

The following instructions guides you to change the title color of the Surveyor web application.

Before you start, make sure you have logged in with **Manager credentials** and navigated to the **Site Settings**in the **Settings**menu.

1. Select the top paint from the **Top Colour **color palette. 

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-top-colour.png)
Figure: Header Gradient Color - Top Color

1. Select the bottom paint from the **Bottom Colour** color palette.
2. Click **Apply** ![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) to Save the settings.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-bottom-colour.png)
Figure 74: Header Gradient Color - Bottom Color

#### **Customize Grid Color**

The following instructions guides you to change the grid color of the Surveyor web application.

Before you start, make sure you have logged in with **Manager credentials** and navigated to the **Site Settings**in the **Settings**menu.

1. From the **Grid Color** palette, select the color that you want to display for the grid in screens that display grid data
2. Click **Apply**![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) to save your settings.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-grid-colour.png)
Figure 75: Grid Color Palette

#### **Customize Logo**

The following instructions guides you to upload a custom logo to your web application.

Before you start, make sure you have logged in with **Manager credentials** and navigated to the **Site Settings**in the **Settings**menu.

1. Click the **Browse**button to choose a logo from your device.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-browse-button.png)
Figure: Custom Logo - Browse Button

1. Select the uploaded logo from the **Custom Logo** dropdown list.
2. Click **Apply** ![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) to save your changes.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-logo-dropdown.png)
Figure 76: Custom Logo Dropdown

#### **Customize ‘Header Title Prefix’ Text**

The following instructions guides you to change the prefix of the header title.

Before you start, make sure you have logged in with **Manager credentials** and navigated to the **Site Settings**in the **Settings**menu.

1. In the **Header Title** field, enter *the text that you want the application to display as a ‘prefix’ for the existing title in the application header.*
2. Click **Apply**![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) to save the header title prefix.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-header-title.png)
Figure 77: Custom Header Title Prefix

The final result of the page when you do all the customizations,

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-final-output-1024x446.png)
Figure 78: Display of Customized Brand Settings

## Dialer Menu

The Dialer Menu allows you to manage campaigns, initiate calls, and streamline communication workflows using various widgets. You can control caller IDs, schedule callbacks, assess contact attributes, and update contact information. This feature simplifies call operations, optimizes targeting, and enhances agent efficiency, improving overall campaign success and customer engagement.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-overview-expanded-view-1024x750.png)
Figure: Dialer Menu - Default View

### Getting to Know the Dialer Menu

![](https://voiptools.com/wp-content/uploads/2024/11/oveview-1024x216.png)
Figure: Dialer Menu - Overview

| ![](https://voiptools.com/wp-content/uploads/2024/09/number-one.png) | **Widgets** | The available widgets in the dialer menu. You can hover over the widgets to know the name of the widget. |
| --- | --- | --- |
| ![](https://voiptools.com/wp-content/uploads/2024/09/number-two.png) | **Reset Layout Icon** | It resets the Dialer menu to the default layout. |
| ![](https://voiptools.com/wp-content/uploads/2024/09/number-three.png) | **Save Layout Icon** | You can organize the widgets and save the layout. |

### Overview of the Dialer Widgets

| Widget Icon | Widget Name | Purpose of the Widget |
| --- | --- | --- |
| ![](https://voiptools.com/wp-content/uploads/2024/11/1.-campaign-icon.png) | **Campaign** | The Campaign widget enables you to manage campaigns, select call lists, and initiate calls for assigned agents efficiently. |
| ![](https://voiptools.com/wp-content/uploads/2024/11/2.-show-call-control.png) | **Show Call Control** | In the **Call Control** widget, you can automatically see the contact number of the first contact in the campaign list. |
| ![](https://voiptools.com/wp-content/uploads/2024/11/3.-call-status.png) | **Call Status** | **Call Status** widget lets you select one of the dispositions from the available dispositions list. |
|  | **Call Notes** |  |
| ![](https://voiptools.com/wp-content/uploads/2024/11/6.-prior-notes-1.png) | **Prior Ad** | The **Prior Ad** widget allows users to retrieve, reference, or duplicate details of a previous advertisement, enabling easy reuse, validation, customization, or historical tracking of campaigns. |
| ![](https://voiptools.com/wp-content/uploads/2024/11/5.-address.png) | **Address** | **Contact Address** widget displays address details of the contact in the call. |
|  | **Call Back** |  |
| ![](https://voiptools.com/wp-content/uploads/2024/11/8.-agent-script.png) | **Agent Script** | **Agent Script** widget displays the information specific for the agent. |
| ![](https://voiptools.com/wp-content/uploads/2024/11/9.-attributes.png) | **Attributes** | The Contact Attributes widget displays sales information such as order history, contact details, status, class, and territory for contacts. |
| ![](https://voiptools.com/wp-content/uploads/2024/11/10.-qualification-script.png) | **Qualification Script** | The **Call Qualification** widget assesses prospects’ eligibility based on key attributes, enabling efficient targeting, data collection, and optimized call timing to maximize campaign success. |
|  | **Auto Voicemail** |  |
| ![](https://voiptools.com/wp-content/uploads/2024/11/12.-caller-ID.png) | **Caller ID** | The Caller ID widget allows you to manage and update outbound caller IDs for logged-in users' extensions in 3CX. |
|  | **Survey Questions** |  |

### Campaign Widget

This section guides you to manage campaigns and initiate calls from assigned lists

**Before you Begin:** Make sure you have logged in with **Manager Credentials**, navigated to the **Dialer menu** and opened the **Campaign**![](https://voiptools.com/wp-content/uploads/2024/11/1.-campaign-icon.png)widget**.**

1. In the **Campaign **drop down, select *the campaign*for which you want to work.
2. From the **List **drop down, select the **Campaign List** so that you can start calling the agents assigned to it.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-campaign-widget.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-campaign-widget.png)
**Figure 65: Campaign widget**

**Results:** The selected campaign and list are loaded, enabling agents to begin making assigned calls.

### Call Control Widget

In the **Call Control** widget, you can automatically see the contact number of the first contact in the campaign list.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-call-control-widget.png)
Figure: Call Control Widget

![](https://voiptools.com/wp-content/uploads/2024/11/1.png)

#### Dial a Number

This icon lets you to dial the number that appears in the **Contacts**field

You can also dial additional phone numbers. Click **Dial** ![](https://voiptools.com/wp-content/uploads/2023/01/Icon-GreenSavebutton.png) icon beside **Phone 1**/ **Phone 2**/ **Mobile**/ **FAX** fields.

![](https://voiptools.com/wp-content/uploads/2024/11/2.-done.png)

#### End a Call

This icon lets you end the current call.

![](https://voiptools.com/wp-content/uploads/2024/11/3.-transfer.png)

#### Transfer the Call

This icon lets you transfer the call. To transfer a call,

1. Enter *the extension number* in the **Contacts**field.
2. Click the **Transfer**icon.

   To transfer a call to another extension, you must first enter the extension number in the **Contact** field. When you click the **Transfer**icon.

![](https://voiptools.com/wp-content/uploads/2024/11/5.-search.png)

#### Search a Contact

Lets you search a contact.

1. Enter any of the contact details.
2. Click the **Search**icon.

![](https://voiptools.com/wp-content/uploads/2024/11/4.-save.png)

#### Save Contact Details

To save the contact details,

1. Enter the contact details in the respective fields.
2. Click the **Save** icon.

![](https://voiptools.com/wp-content/uploads/2024/11/6.-forward.png)

#### Next Contact

Moves to the next contact in the dialer. Once you are done with the current contact you can click the **Next**icon to move to the next contact.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) ***NOTE:***
>
>
>
> - The number beside the Next button indicates how many people are yet to be called.
>
>
>
> - In order to move to the next customer, you need to disposition the call.

1.

### Call Status Widget - Move to Next Call

**Call Status** widget lets you select one of the dispositions from the available dispositions list.

1. Select any of the disposition in the **Call Status**widget.
2. Click the **Next**![](https://voiptools.com/wp-content/uploads/2023/01/right-triangle-1.png) icon in the **Call Control**widget.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-3.-call-status-widget.png)
Figure: Call Status Widget

To learn to add or disable dispositions in the Call Status widget, click **[here](#dispositions)**.

### Call Notes Widget

This widget enables agents to view priority notes and other notes. Agents can add new notes during a call or modify existing ones as needed.

### Contact Address Widget

**Contact Address** widget displays address details of the contact in the call.

You can modify the contact address details.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-4.-contact-address-widget.png)
Figure: Contact Address Widget

To learn to add/modify/delete the address fields, click [**here**](#label-text).

### Prior Ads Widget

The **Prior Ad** widget allows users to retrieve, reference, or duplicate details of a previous advertisement, enabling easy reuse, validation, customization, or historical tracking of campaigns.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-5.-prior-add-widget-1024x436.png)
Figure: Prior Ad Widget

### CallBack Widget

**Call Back** widget lets you schedule a call back according to the customer’s preferred timings. If you are working on a call and if the call back scheduled time arrive, the dialer waits till you have finished the call and click the **Dialer** button, the call will be dialed to the **Call Back** number. The number you mentioned in the Phone field, that number copy it and dial the call through the dialer and once the call finished you need to check the **done**box to mark the end of the call and hit the save button and the next call will appear..

1. In the **Date/ Time** drop-down, select the appropriate date and time.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-6.-call-back-widget-date-and-time.png)
Figure: Call Back Widget - Date and Time Dropdown

1. In the **Phone **field, enter the phone number to which you need to call back.
2. Once the call back has been performed successfully, check the **Done **box to know in future that the call back for the customer has been performed.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-7.-call-back-widget-other-details.png)
Figure: Call Back Widget - Phone Field

### Agent Script Widget

**Agent Script** widget displays the information specific for the agent.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-8.-agent-script-1024x348.png)
Figure: Agent Script Widget

### Contact Attributes Widget

All the sales information related to the contact will be populated in the **Contact Attributes** widget. From here, you can know what the contact’s first order, last order, last contact details, class, status and territory are.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-9.-contact-attributes.png)
Figure: Contacts Attributes Widget

To learn to modify the details of the Contact Attributes widget, **[click here](#lookuptab)**.

### Call Qualification Widget

The **Call Qualification** widget assesses prospects’ eligibility based on key attributes, enabling efficient targeting, data collection, and optimized call timing to maximize campaign success.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-10.-call-qualification.png)
Figure: Call Qualification Widget

### Auto Voicemail Widget

**Auto Voicemail** widget enables you to access the ‘Play’ and ‘Send’ features in sync with the ‘Auto Voicemails’ screen of the ‘3CX Auto Voicemail’ application. **Auto Voicemail** widget enables your staff to automatically play prerecorded voice messages when connected to a customer’s voicemail box. For more information, you can refer **[Auto Voicemail manual](https://voiptools.com/docs/auto-voicemail-v20/)**.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> To view **Auto Voicemail** widget, you need to install ‘3CX Auto Voicemail’ application.

#### Play Auto Voicemail

This section guides you to play the voicemail associated with customer's voicemail box.

**Before you Begin:** Make sure you have logged in with **Manager credentials**, navigated to the **Dialer menu** and opened the **Auto Voicemail** widget. Also ensure you have **installed Auto Voicemail application.**

1. Select the desired voicemail.
2. Click the **Play**![](https://voiptools.com/wp-content/uploads/2023/01/right-triangle-2.png)button.

**Results**: The built-in media player opens to play the selected voicemail.

#### Play Auto Voicemail

This section guides you to send the voicemail to the customers during a call.

**Before you Begin:** Make sure you have logged in with **Manager credentials**, navigated to the **Dialer menu** and opened the **Auto Voicemail** widget. Also ensure you have **installed Auto Voicemail application.**

1. Select the desired voicemail.
2. Click the **Send**![](https://voiptools.com/wp-content/uploads/2023/03/blue-arrow-button.png) button.

**Results:** The desired voicemail is now sent to the customer on call.

### Caller ID Widget

**Caller ID** widget enables you to work in sync with the ‘Caller IDs’ menu of the ‘3CX Caller ID’ application. From here, you can update Outbound Caller ID for logged-in user’s extension, revert back to agent default Caller ID, and manually update Outbound Caller ID for logged-in user’s extension. For more information, you can refer Caller ID manual.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> To view **Caller ID** widget, you need to install ‘3CX Caller ID’ application.

#### Update Outbound Caller ID for Logged-in User’s Extension

- From the **Numbers** drop down, select the franchise whose extension you want to apply to your outbound caller ID.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-11.-caller-id-number-dropdown.png)
Figure: Caller ID Widget - Numbers Dropdown

**Results:** Once applied, the system displays the successfully updated message and the desired franchise would apply to the outbound caller ID.

#### Revert Back To Agent Default Caller ID

Reverting a CallerID for an agent will revert it back to the ‘Agent Caller ID’ (specified in the **Agents **tab). If the agent is not assigned any Caller ID, then the application takes ‘Default CallerID’ (specified in the **Settings **tab) of the extension group to which the agent belongs to.

- Beside **Numbers** drop down, click the **Revert **![](https://voiptools.com/wp-content/uploads/2023/01/refresh.png) button.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-12.-caller-id-revert-button.png)
Figure: Caller ID Widget - Revert Icon

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon.png) **NOTE**:
>
>
>
> Every agent must have a default Caller ID (Agents tab) else Caller ID will not be reverted.

### Survey Questions Widget

The Survey Questions widget displays a list of questions to ask the customer. Agents can modify the survey questions through the **Questions**menu.

## Campaign Menu

The **Campaign Menu** enables you to efficiently manage campaigns by creating and organizing them, adding campaign lists, and assigning agents. You can configure campaign details, set statuses, define timeframes, include agent scripts, and manage contact lists. This feature ensures streamlined coordination and execution of your targeted campaigns with ease and professionalism.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-overview-1024x285.png)
Figure: Campaign Menu - Overview

### Add New Campaign

This section guides you to add a new campaign.

**Before you start:** Make sure you have logged in with **Manager credentials** and navigated to the **Campaign Menu**in the menu bar.

1. Click the **Add**![](https://voiptools.com/wp-content/uploads/2023/03/plus-icon-blue.png) icon.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-add-button-1-1024x285.png)
Figure: Add Campaign - Add Button

1. In the **Campaign**popup screen, do the following
   1. Enter a title in **Description 1**field.
   2. Enter *a short description of the campaign*in the **Description 2** field.
   3. In the **Status**dropdown,
      - Set the status to **Active**to activate the campaign.
      - Set the status to **Inactive**to inactivate the campaign.
   4. Enter a *script for the agent*in the **Agent Script**text area.
   5. Click the **Save**![](https://voiptools.com/wp-content/uploads/2023/01/save.png)icon.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-create-new-campaign-1024x582.png)
Figure: Add Campaign - Agent Script

**Results:** The campaign gets added to the campaigns list.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-3.-output-1024x496.png)
Figure: Add Campaign - Sample Output

### Add a Campaign List

This section guides you to add a campaign list to the existing campaigns.

**Before you start:** Make sure you have logged in with **Manager credentials** and navigated to the **Campaign Menu**in the menu bar. You must have created a campaign first before adding a campaign list. Refer the earlier section to learn how to add a campaign.

#### Step 1: Open the Campaign List Screen

1. Click the **Expand**![](https://voiptools.com/wp-content/uploads/2023/01/expand.png) icon.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-expand-button-1024x435.png)
Figure: Open Campaign List - Expand Button

1. Click the **Add**![](https://voiptools.com/wp-content/uploads/2024/11/plus.png)icon.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-add-button-1024x538.png)
Figure: Add Campaign List - Add Button

#### Step 2: General Section - Add General Details of the Campaign List

1. Enter the name of the campaign list in the **List Name**field.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-list-name.png)
Figure: General Section - List Name Field

1. In the **Status**dropdown,
   - Set the status to **Active**to activate the campaign.
   - Set the status to **Inactive**to inactivate the campaign.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-activate-campaign.png)
Figure: General Section - Status Dropdown

1. Set the **Start Date** and **End Date**from the **Calendar**dropdown.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-3.-start-and-end-date-1024x512.png)
Figure: General Section - Date and Time Dropdown

#### Step 3: Agent Script Section - Add Agent Script to Campaign List

- Enter the script for the agent using the inbuilt word processor.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-agent-script.png)
Figure: Agent Script Section

#### Step 4: SQL Query Section - Add SQL Query to Campaign List

The SQL Query section displays the list of contacts involved in the campaign list. The list is exported from the **Contacts**menu. You can add new contacts in this section.

1. Click the **Add**![](https://voiptools.com/wp-content/uploads/2023/01/add-button.png) icon.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-add-button-2.png)
Figure: SQL Query Section - Add Button

1. Enter the contact details.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-details.png)
Figure: SQL Query Section - Contact Details

1. Click the **Save Changes**text.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-3.-save-changes.png)
Figure: SQL Query Section - Save Changes Text

#### Step 5: Assign Agents Section - Add or Remove Agents to the Campaign List

The **Assign Agents** tab lets you assign specific agents to a campaign list. The **Unassigned** list box shows agents in the **Surveyor Extension Group**, defined in the In the **General**tab under the **Settings**menu.

To assign agents, select them from the **Unassigned** list box and move them to the **Assigned** list box.

| ![](https://voiptools.com/wp-content/uploads/2023/01/right-triangle.png) | **Assign Agent** | Lets you assign a selected agent for the campaign. |
| --- | --- | --- |
| ![](https://voiptools.com/wp-content/uploads/2023/01/left-triangle.png) | **Unassign Agent** | Lets you remove a selected agent from the campaign. |
| ![](https://voiptools.com/wp-content/uploads/2023/01/double-right.png) | **Assign All** | Lets you assign all the available agents to the campaign. |
| ![](https://voiptools.com/wp-content/uploads/2023/01/double-left.png) | **Unassign All** | Lets you remove all the assigned agents in the campaign. |

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-assign-agents.png)
Figure: Assign Agents Section

## ,Questions Menu

[introduction]

### Add a Survey Question

This section guides you to add a new survey question.

**Before you Begin:** Make sure you have logged in with **Manager credentials** and have navigated to the **Add/Edit Questions section**under the **Questions menu.**

1. Click the **Add**![](https://voiptools.com/wp-content/uploads/2023/01/add-button.png) icon to open the **Add/Edit Question**popup.

1. Enter *the question text*in the **Question**text area.

1. Select the answer type from the **Answer Type**dropdown.

1. Enter *your answers*in the **Answer**field.
2. Click the **Save**![](https://voiptools.com/wp-content/uploads/2023/01/save-button-5.png) icon.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon-4.png)**NOTE:**
>
>
>
> For answers with multiple options, separate the options using the "|" key (pipe or vertical bar).

**Results:** The question gets updated in the **Question Maintenance**table.

### Edit a Survey Question

This section guides you to edit the existing survey question.

**Before you Begin:** Make sure you have logged in with **Manager credentials** and have navigated to the **Add/Edit Questions section**under the **Questions menu.**

1. Click the **Edit**![](https://voiptools.com/wp-content/uploads/2024/11/edit-survey-icon.png)icon for the desired question to open the **Add/Edit Questions**popup.
2. Make your changes and click the **Save**![](https://voiptools.com/wp-content/uploads/2023/01/save-button-5.png) icon.

### Delete a Survey Question

his section guides you to delete the existing survey question.

**Before you Begin:** Make sure you have logged in with **Manager credentials** and have navigated to the **Add/Edit Questions section**under the **Questions menu.**

1. Click the **Delete**![](https://voiptools.com/wp-content/uploads/2023/01/delete-note.jpg)icon besides the desired question.

>

1. Click **OK**in the confirmation popup.

> **![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon-4.png)** **NOTE:**
>
>
>
> You cannot delete a question after it has been added to a survey group. First, remove the question from the survey group, then proceed with deletion. Click **[here](#include-survey-question)**to learn how to include or exclude questions from a survey group.

### Group Survey Questions

[introduction]

#### Create a Survey Group

This section guides you to create a survey group to group the survey questions.

**Before you Begin:** Make sure you have logged in with **Manager credentials** and have navigated to the **Question Groups section**under the **Questions menu.**

1. Click the **Add ![](https://voiptools.com/wp-content/uploads/2023/01/add-button.png)**icon in the **Survey Names**table.

1. Enter *the name of the survey*in the **Survey Names**field.
2. Click the **Save ![](https://voiptools.com/wp-content/uploads/2023/01/save-button-5.png)** icon.

**Results:** The survey group gets added to the Survey Names table.

#### Assign Questions to a Survey Group

This section guides you to include or exclude survey questions to a survey group.

**Before you Begin:** Make sure you have logged in with **Manager credentials** and have navigated to the **Question Groups section**under the **Questions menu.**

1. Select the desired survey group from the **Survey Names**table.

1. Click**Include All** button to include all the survey questions or select the desired questions from the **Available**section and click the Include button.

1. Click the **Save**button.

**Results:** The questions are assigned to the survey group.

## Contacts Menu

The Contacts Menu in 3CX Surveyor provides a centralized platform to manage, organize, and update contact information efficiently. It enables users to search, add, delete, or edit contacts, ensuring accurate and streamlined database management. The menu also supports advanced features such as setting contacts as private or in "Do Not Disturb" mode. Additionally, the History Tab records interaction notes for better customer insights, while the Qualification Tab displays comprehensive contact details, enhancing overall communication and operational efficiency.

### Contacts Tab

The Contacts Tab enables you to manage contact information effectively within the 3CX Surveyor. You can search for, add, delete, or update contact details with ease. This feature streamlines database management, ensures accurate information retrieval, and provides a user-friendly interface for maintaining a centralized repository of contact data.

#### Getting to Know the Contacts Tab Toolbar

| ![](https://voiptools.com/wp-content/uploads/2024/11/1.-search.png) | **Search** | Type appropriate information anywhere in the field and click the **Search **![](https://voiptools.com/wp-content/uploads/2023/04/search.png)button. 3CX Surveyor finds the person from the database and populates the information in all the fields. |
| --- | --- | --- |
| ![](https://voiptools.com/wp-content/uploads/2023/01/eraser.png) | **Delete Contact** | Search for the contact that you want to delete and click the **Delete Contact **![](https://voiptools.com/wp-content/uploads/2023/01/eraser.png) button to delete the contact. |
| ![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) | **Save** | Click the **Save **![](https://voiptools.com/wp-content/uploads/2023/03/save.jpg) button to save the changes you made to the contact. |
| ![](https://voiptools.com/wp-content/uploads/2023/04/wrong.png) | **Clear Contact** | Click the **Clear Contact** ![](https://voiptools.com/wp-content/uploads/2023/04/wrong.png) button to clear the contact details in the Contact tab. |

#### Search a Contact

This section guides you to search a contact in the Contacts tab.

**Before you Start**: Make sure you have logged in with **Manager Rights** and have navigated to the **Contacts**tab under the **Contacts**menu.

1. Enter the *complete details or partial details of the contact* in any of the field.
2. Click the **Search**![](https://voiptools.com/wp-content/uploads/2024/11/1.-search.png)icon.
3. Select the desired contact from displayed contacts list.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-search-details-1024x717.png)
Figure: Search Contacts - Contacts List

**Results:** Details of the contact is populated.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20--1024x647.png)
Figure: Contact Details Populated

#### Add a Contact

This section guides you to add a contact.

**Before you Start**: Make sure you have logged in with **Manager Rights** and have navigated to the **Contacts**tab under the **Contacts**menu.

1. Enter the necessary contact details in the fields.
2. Click the **Save**![](https://voiptools.com/wp-content/uploads/2023/01/save.png)icon.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-details-1024x659.png)
Figure: Add Contact - Contact Details

**Results:** You get a **Success**popup when the contact gets added to the contacts list.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-saved-1-1024x647.png)
Figure: Contacts Added - Success Message

#### Set Contact as Private

This section guides you to add a contact.

**Before you Start**: Make sure you have logged in with **Manager Rights** and have navigated to the **Contacts**menu.

1. Search for the contact you want to set a private. Click ***[here](#search-contact)***to learn to search a contact.
2. Select the **Private**box.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-Private-contact-edited-1024x637.png)
Figure: Private Box

#### Set Contact as Do Not Disturb

This section guides you to add a contact.

**Before you Start**: Make sure you have logged in with **Manager Rights** and have navigated to the **Contacts**menu.

1. Search for the contact you want to set a do not disturb. Click ***[here](#search-contact)***to learn to search a contact.
2. Select the **Do Not Disturb**box.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-Do-not-contact-edited-1024x661.png)
Figure: Don Not Contact Box

### History Tab

The **History **screen allows you to record notes about various conversations your company had with a specific contact over time. You can record important information like commitments or services you provided so that when the customer calls you, you can quickly look into notes to know if you can perform something on their behalf to achieve great customer satisfaction. It provides a great way to understand your customer even before you start talking to them.

### Add New Notes

This section guides you to add new notes for a contact.

Before you Start: Make sure you have logged in with the Manager Rights and have navigated to the History tab under the Contacts menu. Also, ensure you have searched or created the contact before writing notes. Click ***[here](#contactstab)***to know to create/search a contact.

1. Click the **Add**![](https://voiptools.com/wp-content/uploads/2023/01/Icon-BlueAddbutton.png)icon.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-add-button-3-1024x422.png)
Figure: Add Notes - Add Icon

1. Enter the notes in the **Notes**field and click the **Save**![](https://voiptools.com/wp-content/uploads/2023/01/save.png)icon.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-add-notes-1024x485.png)
Figure: History Tab - Notes Field

**Results:** The note gets updated with other information regarding the notes.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-3.-notes-added-1024x461.png)
Figure: History Tab - Notes Added

### Qualification tab

**Contact** screen enables you to view the information about contact.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-qualification-details-1024x586.png)
Figure: Qualification Tab

## Import Menu

The Import menu enables you to efficiently upload and organize contact information from a CSV file into the central repository. By providing tools to map data fields, manage duplicates, and specify delimiters, it ensures accurate and streamlined data integration, enhancing your ability to maintain an updated contact database.

### Import Contacts from a CSV File

This section guides you to import contacts from a .CSV file in your local device.

**Before you Start:** Make sure you have logged in with the Manager Rights and have navigated to the **Import** menu in the menu bar and have a existing .CSV file in your device.

1. Click the **Browse**button and browse the CSV file from your local device.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-1.-browse-button-1-1024x590.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-1.-browse-button-1.png)
Figure: Import Contacts - Browse Button

1. Enter *a name for contact list*in the **Contact List**field.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-2.-list-name-1024x590.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-2.-list-name.png)
Figure: Import Contacts - List Name Field

1. Select the **Delimiter**type.
   - Select **Comma**if the data in your CSV file is separated by commas.
   - Select **Tab**if the data in your CSV file is separated by tab spaces.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-1-1-1024x590.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-1-1.png)
Figure: Import Contacts - Delimited Type

1. Click the **Get Field**icon to load the CSV column headers into the **CSV File** list box.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-4.-get-fields-icon-1024x590.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-4.-get-fields-icon.png)
Figure: Import Contacts - Get Field Icon

1. Move each column from the CSV File list box into the CSV Field list box by appropriately using buttons such that the columns in the CSV Field list box will match those of the **Contact Field** list box.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-4.-csv-fields-matching-1024x524.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-4.-csv-fields-matching.png)
Figure: Import Contacts - CSV Fields Matching

1. Select the **Update Existing Contacts box to**overwrite existing contacts.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-5.-update-existing-contacts-box-1024x590.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-5.-update-existing-contacts-box.png)
Figure: Import Contacts - Update Existing Contacts Box

1. Click the **Import ** ![](https://voiptools.com/wp-content/uploads/2024/11/import-icon.png)button to import all the contacts from the CSV file into the central repository of contacts.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-6.-import-button-1024x590.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-6.-import-button.png)
Figure: Import Contacts - Import Button

**Results:** The contact list in the CSV file gets exported to the web application.

[![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-7.-output-1024x509.png)](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-V20-7.-output.png)
Figure: Import Contacts - Sample Output

## Reports Menu

The Reports Menu provides access to various report types, including Sales, Performance, Call, and Call Back Reports. Each report offers valuable insights into different aspects of your business operations, such as campaign performance, agent activity, customer interactions, and callback efficiency. By grouping columns, analyzing trends, and exporting data, you can make informed decisions, optimize strategies, and improve performance. This streamlined process enhances data visibility, supporting better management and operational efficiency across your organization.

![](https://voiptools.com/wp-content/uploads/2024/11/1.-reports-dropdown-1024x449.png)
Figure: Reports Menu Dropdown

| Report Name | Purpose |
| --- | --- |
| **Sales Report** | The Sales Reports screen tracks campaign performance, analyzes sales data, enables grouping, and exports insights for informed decision-making. |
| **Performance Report** | The Performance Reports screen provides insights into agent activities, enabling analysis, monitoring, optimization, and export of performance data. |
| **Call Report** | The Call Reports screen tracks customer interactions, analyzes call outcomes, evaluates agent performance, and supports exporting and grouping data. |
| **Call Back Report** | The Call Back Reports screen tracks callback activities, monitors performance, and enables analysis through column grouping and data export. |

### Sales Report

The Sales Reports screen offers detailed insights into sales campaign performance, allowing you to track company interactions, sales values, and key contacts. It helps you analyze trends, group data for better clarity, and export information for further review, facilitating informed decision-making and enhancing overall business strategies.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-overview-1-1024x527.png)
Figure: Sales Report - Overview

#### Sales Report - Column Definitions

| Column Name | Definition / Purpose |
| --- | --- |
| **Campaign Name** | Name of the campaign |
| **Date/ Time** | Date and time of the start of the campaign. The date format is*MM/DD/YYYY* and the time format is *HH:MM AM/PM* |
| **Name** | Name of the company contacted |
| **Phone** | Phone number of the company contacted |
| **Value** | The sales value in US Dollars. |
| **First** | First Name of the contacted person. |
| **Last** | Last Name of the contacted person. |

#### Sales Report - Export Data

This section guides you to export the sales report in various file formats to you local device.

**Before you Start:** Make sure you have logged into the application with manager rights and have navigated to the **Sales Reports** screen under the **Reports**menu.

- Click any of the desired format to export to your local device.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-export-options-1-1024x527.png)
Figure: Sales Report - Export Options

#### Sales Report - Group the Columns

Grouping columns in a report organizes data into logical sections, enhancing readability, enabling comparisons, and simplifying analysis by presenting related information cohesively.

This section guides you to group the columns of the sales reports.

**Before you Start:** Make sure you have logged into the application with manager rights and have navigated to the **Sales Reports**screen under the **Reports**menu.

1. Drag and drop any of the available columns into the space provided above the columns.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-3.-columns-grouped-1024x496.png)
Figure: Sales Report - Columns Grouped

1. Click the **Expand**![](https://voiptools.com/wp-content/uploads/2023/01/expand-1.png) icon to expand the grouped items.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-overview-2-1024x527.png)
Figure: Sales Report - Columns Expanded

**Results:** You have grouped the columns in the Sales Reports screen.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon-4.png)**NOTE:**
>
>
>
> The grouped columns do not reflect in the exported files.

### Performance Reports

The Performance Reports screen offers a comprehensive view of agent activities, including call volume, durations, and campaign involvement. It enables detailed analysis, effective monitoring, and informed decision-making to optimize performance and ensure operational efficiency. Users can group columns for better organization and export data in various formats for further review.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-overview-3-1024x520.png)
Figure: Performance Report - Overview

#### Performance Report - Column Definitions

| Column Name | Definition / Purpose |
| --- | --- |
| **First** | First Name of the contacted person. |
| **Last** | Last Name of the contacted person. |
| **Login Date/ Time** | Date and time of the start of the campaign. The date format is*MM/DD/YYYY* and the time format is *HH:MM AM/PM* |
| **Calls** | Number of calls made by the agent. |
| **Duration** | Total duration of all the calls made. The format is *HH:MM:SS* |
| **Campaign Name** | Name of the campaign |

#### Performance Report - Export Data

This section guides you to export the performance report in various file formats to you local device.

**Before you Start:** Make sure you have logged into the application with manager rights and have navigated to the **Performance Reports** screen under the **Reports**menu.

- Click any of the desired format to export to your local device.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-export-options-2-1024x520.png)
Figure: Performance Report - Export Options

#### Performance Report - Group the Columns

Grouping columns in a report organizes data into logical sections, enhancing readability, enabling comparisons, and simplifying analysis by presenting related information cohesively.

This section guides you to group the columns of the performance reports.

**Before you Start:** Make sure you have logged into the application with manager rights and have navigated to the **Performance Reports**screen under the **Reports**menu.

1. Drag and drop any of the available columns into the space provided above the columns.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-3.-compact-view-1024x535.png)
Figure: Performance Report - Columns Grouped

1. Click the **Expand**![](https://voiptools.com/wp-content/uploads/2023/01/expand-1.png) icon to expand the grouped items.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-4.-expanded-view-1024x611.png)
Figure: Performance Report - Columns Expanded

### Call Reports

The Call Reports screen provides detailed records of customer interactions, including call dates, times, dispositions, and agent involvement. It enables tracking and analysis of call outcomes, facilitating performance evaluation, campaign effectiveness assessment, and operational improvement. Users can organize data through column grouping and export reports in various formats for detailed review.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-overview-4-1024x563.png)
Figure: Call Report - Overview

#### Call Report - Column Definitions

| Column Name | Definition / Purpose |
| --- | --- |
| **Customer** | Name of the customer |
| **Campaign** | Name of the campaign |
| **Agent Name** | Name of the agent who contacted the customer. |
| **Phone** | Phone number of the customer. |
| **Date/Time** | Date and time of the call. The date format is*MM/DD/YYYY* and the time format is *HH:MM AM/PM* |
| **Dispositon** | The response of the customer as noted by the agent. |

#### Call Report - Export Data

This section guides you to export the performance report in various file formats to you local device.

**Before you Start:** Make sure you have logged into the application with manager rights and have navigated to the **Call Reports** screen under the **Reports**menu.

- Click any of the desired format to export to your local device.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1-2-1024x563.png)
Figure: Call Report - Export Options

#### Call Report - Group the Columns

Grouping columns in a report organizes data into logical sections, enhancing readability, enabling comparisons, and simplifying analysis by presenting related information cohesively.

This section guides you to group the columns of the call reports.

**Before you Start:** Make sure you have logged into the application with manager rights and have navigated to the **Call Reports**screen under the **Reports**menu.

1. Drag and drop any of the available columns into the space provided above the columns.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-3.-compact-view-1-1024x587.png)
Figure: Call Report - Columns Grouped

1. Click the **Expand**![](https://voiptools.com/wp-content/uploads/2023/01/expand-1.png) icon to expand the grouped items.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-4.-expanded-view-1-1024x678.png)
Figure: Call Report - Columns Expanded

### Call Back Reports

The Call Back Reports screen provides detailed information about callback activities, including caller, buyer, and agent details, as well as callback status and campaign association. It helps monitor callback performance, ensures follow-up actions, and supports analysis through column grouping and data export for effective campaign and agent management.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-callback-report-overview-1024x479.png)
Figure: Call Back Report - Overview

#### Call Back Report - Column Definitions

| Column Name | Definition / Purpose |
| --- | --- |
| **Agent Last Name** | Last Name of the agent. |
| ****Agent First Name**** | Frist Name of the agent. |
| **Caller** | Name of the caller who made the call back. |
| **Name** | Name of the caller who made the call back. |
| **Buyer** | Name of the buyer who made the call back. |
| **Contact** | Name of the contact who made the call back. |
| **Phone** | Phone number of the contact who made the call back. |
| **Complete** | Indicates whether the callback is complete. |
| **Campaign Name** | Name of the campaign. |
| **Callback Date** | Date and time of the call back. The date format is*MM/DD/YYYY* and the time format is *HH:MM AM/PM* |

#### Call Back Report - Export Data

This section guides you to export the performance report in various file formats to you local device.

**Before you Start:** Make sure you have logged into the application with manager rights and have navigated to the **Call Back Reports** screen under the **Reports**menu.

- Click any of the desired format to export to your local device.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-export-options-3-1024x479.png)
Figure: Call Back Report - Export Options

#### Call Back Report - Group the Columns

Grouping columns in a report organizes data into logical sections, enhancing readability, enabling comparisons, and simplifying analysis by presenting related information cohesively.

This section guides you to group the columns of the Call Back reports.

**Before you Start:** Make sure you have logged into the application with manager rights and have navigated to the **Call Back Reports**screen under the **Reports**menu.

1. Drag and drop any of the available columns into the space provided above the columns.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-3.-coloumns-grouped-1024x496.png)
Figure: Call Back Report - Columns Grouped

1. Click the **Expand**![](https://voiptools.com/wp-content/uploads/2023/01/expand-1.png) icon to expand the grouped items.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-4.-columns-expanded-1024x632.png)
Figure: Call Back Report - Columns Expanded

### Survey Report

[content]

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-overview-1-1024x527.png)
Figure: Sales Report - Overview

#### Survey Report - Column Definitions

| Column Name | Definition / Purpose |
| --- | --- |
| **Campaign Name** | Name of the campaign |
| **Date/ Time** | Date and time of the start of the campaign. The date format is*MM/DD/YYYY* and the time format is *HH:MM AM/PM* |
| **Agent** | Name of the agent associated with the survey |
| **Recipient Name** | Name of the person contacted. |
| ****Recipient Phone**** | Phone number of the person contacted. |

#### Survey Report - Export Data

This section guides you to export the Survey report in various file formats to you local device.

**Before you Start:** Make sure you have logged into the application with manager rights and have navigated to the **Survey Reports** screen under the **Reports**menu.

- Click any of the desired format to export to your local device.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-2.-export-options-1-1024x527.png)
Figure: Sales Report - Export Options

#### Survey Report - Group the Columns

Grouping columns in a report organizes data into logical sections, enhancing readability, enabling comparisons, and simplifying analysis by presenting related information cohesively.

This section guides you to group the columns of the Survey reports.

**Before you Start:** Make sure you have logged into the application with manager rights and have navigated to the **Survey Reports**screen under the **Reports**menu.

1. Drag and drop any of the available columns into the space provided above the columns.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-3.-columns-grouped-1024x496.png)
Figure: Sales Report - Columns Grouped

1. Click the **Expand**![](https://voiptools.com/wp-content/uploads/2023/01/expand-1.png) icon to expand the grouped items.

![](https://voiptools.com/wp-content/uploads/2024/11/screenshot-surveyor-v20-1.-overview-2-1024x527.png)
Figure: Sales Report - Columns Expanded

**Results:** You have grouped the columns in the Survey Reports screen.

> ![](https://voiptools.com/wp-content/uploads/2023/01/notes-icon-4.png)**NOTE:**
>
>
>
> The grouped columns do not reflect in the exported files.

## About Menu

The **About** menu provides essential information about the application, including the version number, company details, and contact information for support. It serves as a reference to verify the software version you are using and facilitates easy access to customer support for assistance or inquiries.

Click the link to know more about the **[VoIPTools support](#support).**

![](https://voiptools.com/wp-content/uploads/2024/11/about-menu-1024x577.png)
Figure: About Menu

# Need Support?

You get quick answers to most of your inquiries in our online manual. If you prefer direct contact, we offer various support channels, including phone, email, live chat, and our helpful VoIPTools forums.

![](https://voiptools.com/wp-content/uploads/2023/05/24-hours-support-2.png)

## 24/7 Support Availability

Rest assured, our dedicated team is here to assist you around the clock, every day of the year. Whether you're based in the USA or India, we're ready to provide prompt responses to your technical queries.

![](https://voiptools.com/wp-content/uploads/2023/05/windows-log-event.png)

## Windows Event Log for VoIPTools Applications and Services

For troubleshooting any application errors, our Windows Event Log contains a comprehensive list of error messages, warnings, and informative notes related to all our VoIPTools applications and services. It's a valuable resource to help you pinpoint and resolve any issues you may encounter.

![](https://voiptools.com/wp-content/uploads/2023/05/forums.png)

## Join Our Forum Community

Are you looking to collaborate with other VoIPTools customers facing similar challenges? Our forum is the perfect platform to exchange ideas, solutions, and best practices. Join the conversation at: [**https://www.voiptools.com/community/**](https://voiptools.com/blog/)

![](https://voiptools.com/wp-content/uploads/2023/05/live-chat.png)

## Real-Time Live Chat Assistance

Got questions that need immediate answers? Our chat support team is available to assist you in real time. Just click on the Live Chat button located at the lower right corner of our website, and we'll acknowledge your queries right away.

![](https://voiptools.com/wp-content/uploads/2023/05/email-support.png)

## Efficient Email Support

To ensure a thorough understanding of your concerns, email us at ***support@voiptools.com***. Describe your issue in detail, and we'll get back to you within one business day with the support you need.

![](https://voiptools.com/wp-content/uploads/2023/05/phone-support.png)

## Reach Us by Phone

If you prefer to speak with a representative directly, you can reach us at +1 801-642-4655. Our attentive team is available to take your calls from 8:00 AM to 6:00 PM (Central Standard Time).

# Comprehensive support services:

![](https://voiptools.com/wp-content/uploads/2023/05/free-support.png)

## Free Support

If you've purchased our products through a VoIPTools Partner, rest assured that they provide first-level support at no additional cost. Partners have access to 100% free technical assistance and actively participate in the troubleshooting process.

VoIPTools customers enjoy access to our online manuals and receive support through emails (with responses within one business day) and live chat. However, please note that we do not provide remote server login assistance.

![](https://voiptools.com/wp-content/uploads/2023/05/paid-support.png)

## Paid Support

For a more hands-on experience, consider our "Installation Support" package. Our expert support team can log in to your servers, and install and configure all our tools. This comprehensive service includes setting up SQL Server Express and Internet Information Server if necessary. We'll work closely with you to tailor our applications to meet your requirements.

We're committed to providing top-notch support to ensure your VoIPTools experience is smooth and hassle-free. Contact us today, and let us assist you in making the most of our powerful tools!
