Technical prerequisites

Technical prerequisites

Page warning

Vonage has made all reasonable efforts to ensure that the information contained in this document is accurate at the time of publication. The information in this document is subject to periodic change and applies to the latest versions of our products.

General requirements and recommendations

For information about the requirements of specific Vonage Contact Center features or products, see the relevant sections in this page or in the documentation for those features or products.

Web browsers

For all browsers, you must enable the following:

  • WebSockets

  • Cookies

  • JavaScript

  • TLS 1.2 or later. For further information about supported protocols and cipher suites, see Supported protocol versions and cipher suites.

  • ContactPad users: Web storage (both session storage and local storage).

We support the following browsers:

  • Google Chrome™, latest version

  • Microsoft® Edge, latest version

  • Mozilla® Firefox®, latest version

  • Apple® Safari®, latest version

ContactPad and ContactHub users

For organisations using ContactPad and ContactHub, you must configure your browser to allow cookies.

Browser Restrictions

To ensure full functionality, be aware of the following limitations:

  • We do not support Apple® Safari® on an Apple Mac when using the Mid-Call Payment Transfer solution or Conversation Analyzer Analytics.

  • We do not support privacy mode in any browsers when using ContactPad.

Local Network Access (LNA) restrictions in Chrome

Google Chrome (versions 142 and higher) includes a security feature called Local Network Access, which restricts the ability of websites to send requests to servers on a user's local network or local machine (also known as a loopback connection).

To ensure features like Screen Recording and WebRTC work correctly, users may be prompted by Chrome to grant permission to the site. If these prompts are ignored or denied, functionality will be lost.

Action Required

When you see a Chrome browser prompt asking to connect to a "local network" or "private network," you must allow it.

If these permissions are denied or ignored, the following issues will occur:

Feature

Impact of blocking the prompt

Feature

Impact of blocking the prompt

Screen Recording

ContactPad will not be able to verify if Screen Recording is on.

Salesforce (CTI)

You may experience "dual-ringing" or be unable to answer calls in pop-up windows.

Note for Administrators

You can prevent these prompts from appearing for your agents by configuring the Chrome Enterprise Policy:

  • LocalNetworkAccessAllowedForUrls

Preventing browser tab sleeping

Modern browsers and operating systems suspend JavaScript activity in background tabs to conserve resources. For Vonage Contact Center, this can interrupt the heartbeat that maintains the agent's session, causing agents to be unexpectedly logged out while the tab is running in the background.

To prevent this, add the following URLs to your browser's list of sites that are always allowed to run in the background:

  • [*.]vonage.com.

  • [*.]newvoicemedia.com.

  • [*.]contact-world.net.

  • [*.]vonagenetworks.net.

  • [*.]salesforce.com (Salesforce for Vonage and Service Cloud Voice only).

  • [*.]force.com (Salesforce for Vonage and Service Cloud Voice only).

In Google Chrome:

  1. In the address bar, go to chrome://settings/performance.

  2. Under Always active, click Add.

  3. Click Add sites manually.

  4. Add each URL from the list above.

  5. Turn off Memory Saver.

  6. Turn off Energy Saver.

In Microsoft Edge (Chromium):

  1. In the address bar, go to edge://settings/system.

  2. Under Sleeping tabs, click Add next to Never put these sites to sleep.

  3. Add each URL from the list above.

Note for administrators

It is recommended that these settings be enforced centrally using your organisation's device management or Group Policy (GPO) tooling, so that agents do not need to configure their browsers manually.

Operating System

  • Windows:

    • Windows 11

    • Windows 10

  • Mac OS:

    • macOS 26 (Tahoe)

    • macOS 15 (Sequoia)

  • Chrome OS: latest long-term support channel (LTS) release

Processor and memory

Your processor speed and RAM must meet the recommended system requirements for your operating system. You must also ensure that they meet the specifications required for any applications and browsers you use.

Screen resolution

1024 x 768 pixels

Bandwidth - ContactPad and Real Time

ContactPad uses 8 kilobytes per second (KBps)

Real Time (legacy) uses 16 KBps (based on 100 agents, 2 groups, and 2 queue icons)

Recommendation bandwidth = (number of ContactPad users x 8 KBps) + (number of Real Time (legacy) users x 16 KBps)

A call center with 20 agents using ContactPad, 2 supervisors using Real Time (legacy) and 1 wallboard user using Real Time (legacy) will need: (20 x 8 KBps) + (2 x 16 KBps) + (1 x 16 KBps) = 208 KBps

You can use lower bandwidths, but lower bandwidths will result in slower refresh rates and a poor user experience.

Bandwidth - ContactPad and Real Time - additional notes

  • These bandwidth recommendations are based on call delivery through the PSTN and do not include VoIP (voice traffic). The voice traffic bandwidth is stated in the telephony section below.

  • End users (agents, supervisors and wallboard users) regularly communicate both ways with the host data center. The recommendations apply to upload bandwidth as well as download bandwidth to maintain communication between end-user interfaces and the host data center. Whilst upload bandwidth requirements are not as great as download requirements, having sufficient bandwidth to upload files quickly ensures a good end-user experience.

Latency

Maximum 250 ms for optimum agent experience.

Latency additional notes

This latency recommendation is based on call delivery through the PSTN and does not include VoIP (voice traffic). The voice traffic bandwidth is stated in the telephony section below.

Connections

To meet the demand of real-time communications and avoid call quality issues, you must use a wired Ethernet connection rather than a wireless connection.

Virtual environments

Vonage Contact Center has been verified to work with virtual desktop infrastructures (VDI), Citrix Workspace and VMware Horizon. Therefore Vonage Contact Center is supported in these VDIs as long as the issue in those environments is reproducible in a non-VDI environment. If you are unable to reproduce an issue in a non-VDI environment, Vonage will provide best-effort support, and refer you to your IT support team, provider (Citrix or VMware), or both, for additional support. Other VDIs are not yet supported.

ContactPad with WebRTC in a virtual desktop

If you intend to use ContactPad with WebRTC, VDI support for WebRTC must be enabled for your account and agents must use WebRTC as described in the following page: Using WebRTC in ContactPad with a virtual desktop.

Date and time settings

Accurate time is important for the correct operation of Vonage Contact Center (VCC). Ensure that computers used with VCC have their time correctly set; we recommend that you synchronize the date and time with an external time source such as a Network Time Protocol (NTP) provider.

Vonage Contact Center in Salesforce

Supported versions of Salesforce managed packages

To ensure Vonage Contact Center continues to function correctly, you must maintain supported versions of integrated Salesforce packages. We cannot support deprecated or retired versions.

Item

Requirement/recommendation

Item

Requirement/recommendation

Minimum version

  • Professional edition (Express and Essentials licenses only) - requires Web Services API

  • Enterprise edition

  • Unlimited edition

  • Performance edition

Salesforce accounts and licenses

The Vonage Contact Center managed package requires a Salesforce.com account to establish the API connection between Salesforce and Vonage Contact Center accounts.

You can dedicate this account to Vonage Contact Center or you can share it with other applications. A dedicated account is preferable, as it allows for greater fault finding and auditing without impacting other applications.

All of your Salesforce users must have a Salesforce license—other than a Communities license—to use Vonage Contact Center in Salesforce.

Users with Communities licenses cannot use Vonage Contact Center in Salesforce.

Session Settings

Sessions must not be locked to the IP address from which they originated. For information about this and other session settings, see Salesforce help.

Web browser

For information about required browsers, see Salesforce help.

Number format

Telephone numbers within Salesforce should be in E.164 format (maximum is 15 digits). For information about the E.164 format, see E.164 format. The format of the number is required for dynamic call routing, screen popping and Click to dial.

API calls

Your organization must be enabled for API access. You must also operate within the API request limits set by Salesforce for your account.

As a guide, each read and each write to and from Salesforce makes one API call. For example, 100 calls make 200 API calls.

Data requirements

You must have enough Salesforce data storage available for your use. For information about data storage limits in Salesforce, see Salesforce help.

As a guide, each call made or received in Vonage Contact Center generates a Salesforce task record. Task records are 2 kilobytes (KB).

Salesforce CTI

We provide a Call Center definition file for you to import. The imported Call Center uses Open CTI. You do not need to install a CTI adapter.

Connect

Data requirements

Connect uses several custom objects to manage calls. Each custom object record costs 2 KB against your data storage limit. Many of the custom object records created by Connect are short lived and have a limited impact on your data storage limits; others, such as Dial List and Processed Dial Entry, live as long as you require them for reporting purposes and are not removed until you delete them.

Short lived custom objects

  • Pending Dial Entry

  • Active Dial Entry

  • Dial List Processing Time

  • Dial List Agent

Long lived custom objects

  • Dial List

  • Processed Dial Entry

Example storage usage scenario

In this scenario, a supervisor has created a single dynamic Dial List and assigned 50 agents. All 50 agents are actively working on the dial list and have, so far, completed 5000 calls and skipped 5000 calls. The dynamic Dial List cache size for the org is 500 and the dial list has just been refreshed filling the cache so that there are as many pending calls as possible. All agents take notes on the call and no call transfers occur.

Custom Object

Quantity

Cost KB

Custom Object

Quantity

Cost KB

Dial List

1

2

Dial List Processing Time

1

2

Dial List Agent

50

100

Pending Dial Entry

500

1000

Active Dial Entry

50

100

Processed Dial Entry

10,000

20,000

Interaction Event

5,000

10,000

Interaction Event Note

5,000

10,000

Task

5,000

10,000

Totals

25,602

51,204

Short Lived

602

1,204

Long Lived

25,000

50,000

Advanced Reporting

Item

Requirement/recommendation

Item

Requirement/recommendation

Scheduled jobs

Advanced statistics requires four scheduled jobs.

Salesforce limit is 100 jobs per organization.

Storage requirements

You must have enough Salesforce data storage available for your use. For information about data storage limits in Salesforce, see Salesforce help.

By default, Salesforce stores 8 days' worth of statistics. The retention period is configurable.

Each active agent generates one statistics record per day.
Each call generates one statistics record.
Each statistics record uses 2 KB.
Advanced statistics generates up to 4 MB of rolling transaction logs. 

Use the following calculation to estimate your storage requirements:

(2 KB x (average number of calls per day + average number of active agents per day) x retention period (days)) + 4 MB

For example, if your call center receives an average of 1000 calls per day, with an average of 100 active agents per day, and you use the default retention period, use the following calculation to estimate your storage requirements:

(2 KB x (1000 + 100) x 8) + 4 MB = 21.6 MB

Participation and Conversation Analyzer Storage Impact

If the flags to enable Participation and/or Conversation Analyzer Insights record creation are enabled (recommended when using advanced reporting capabilities), additional storage is required.

Each of these records:

  • Uses 2 KB of Salesforce storage

  • Is created per call

  • The number of records per call depends on:

    • The number of agents involved in the call (Participation records).

    • The number of Conversation Analyzer subcategories matched (Insights records).

Storage consumption therefore varies depending on call complexity and configuration.

Motivate

For information about prerequisites for Motivate, see the relevant sections in Motivate.

Vonage Contact Center for ServiceNow

This section describes the prerequisites for using Vonage Contact Center (VCC) with ServiceNow Voice (SNOW Voice).

ServiceNow Data Connector (optional)

If implementing the ServiceNow integration, the Vonage data connector package must be installed from the ServiceNow Store.

Prerequisites

Prerequisite

Description

Prerequisite

Description

ServiceNow instance

A licensed ServiceNow instance is required. Vonage Contact Center for ServiceNow Voice is available from the ServiceNow Store.

Supported platform releases

Vonage Contact Center for ServiceNow Voice supports current and N-1 ServiceNow platform releases (for example, Zurich and Yokohama).

Administrator access

An administrator role in your ServiceNow instance is required to install and configure the integration.

Llimitations

Limitation

Description

Limitation

Description

Interactive sign-in required

Agents must manually click the Login button in the Vonage Dialpad to sign in to VCC each session. Silent or automatic authentication is not currently supported.

Single browser tab

Only one active browser tab is supported per agent session. Multiple tabs may cause incorrect UI state or dropped calls.

Browser refresh during active calls

Refreshing the browser mid-call may cause the UI to lose the active call state. WebRTC audio may persist, but the UI will not reflect the call.

Live call monitoring

Supervisors can access team monitoring, dashboards, and historical analytics only via the VCC portal.
Listen In, Coach, and Join are not currently supported for ServiceNow Voice calls.

Single VCC account per admin user

A ServiceNow admin user can be linked to only one VCC account per node. Linking the same admin user to multiple VCC accounts on the same node causes an authentication error.

Supported workspaces

Vonage Contact Center for ServiceNow Voice requires a Configurable Workspace. Legacy agent workspaces are not supported.

Workspace

Supported

Additional information

Workspace

Supported

Additional information

CSM/FSM Configurable Workspace

N/A

Service Operations Workspace

N/A

HR Agent Workspace

Voice calls work, but real-time transcription is not available in the UI.

CMDB Workspace

N/A

Knowledge Center

N/A

Process Mining Workspace

N/A

Legacy Agent Workspace

N/A

For more information, see the ServiceNow documentation on workspace types.

ServiceNow application

Install the Vonage Contact Center for ServiceNow Voice application (scope: x_vhr_vonage_omni) from the ServiceNow Store. Follow the guided setup included with the application after installation.

Required plugins

The following ServiceNow plugins must be active in your instance before configuring the integration:

Plugin

Plugin ID

Required

Plugin

Plugin ID

Required

OpenFrame

sn_openframe

Advanced Work Assignment (AWA)

com.glide.awa

Agent Chat

com.glide.interaction.awa

User roles

Each agent using Vonage Contact Center for ServiceNow Voice must be assigned the following roles:

Role

Purpose

Role

Purpose

sn_openframe_user

Required to display the Vonage Dialpad within ServiceNow (OpenFrame).

awa_agent

Required to use Advanced Work Assignment (AWA) routing and to see the Inbox in the workspace.

awa_external_user

Required to work with the external routing API (AWA Offer Work API or AWA Manual Assignment API).

sn_customerservice_agent

Required to access the CSM/FSM Configurable Workspace.

You can assign roles directly to individual users or to a group, and then add users to that group.
For more information, see Configure agent access in Integration logic and end-to-end flow.

Phone number format

Telephone numbers in ServiceNow must be in the E.164 format (for example, +14155552671). This is required for correct call routing, screen popping, and click-to-dial functionality. For more information, see E.164 format.

Web browser

Vonage Contact Center for ServiceNow Voice runs inside the ServiceNow workspace in a browser. For the best experience, use the latest version of Google Chrome or Microsoft Edge (Chromium). Only one active browser tab per agent session is supported; opening multiple tabs can cause inconsistent telephony state or call drops.

SCIM integration

VCC supports automated user provisioning and deprovisioning via SCIM (System for Cross-domain Identity Management) integration with Microsoft Entra ID (formerly Azure AD). When users are added to Entra ID and assigned to the VCC enterprise application, VCC automatically creates their accounts. When users are deactivated or unassigned, VCC immediately revokes access, eliminating manual account management and reducing security risks.

For detailed configuration steps and integration workflows, see Vonage Contact Center and SCIM integration for user provisioning.

Prerequisites

Prerequisite

Description

Prerequisite

Description

Microsoft Entra ID requirements

Your Microsoft Entra ID tenant must meet the following requirements to support SCIM provisioning:

  • Azure AD Premium P1 or P2 license (required for enterprise app provisioning).

  • Global Administrator or Privileged Role Administrator permissions.

  • VCC enterprise application added to Entra ID catalog.

VCC requirements

Your VCC account must meet the following requirements to enable SCIM integration:

  • Administrator role in the VCC Admin Portal.

VCC package availability

SCIM Integration is available in all VCC packages.

Network requirements

Your network connectivity must be configured to allow communication between Entra ID and VCC:

  • HTTPS access from Entra ID provisioning service to VCC SCIM API endpoint.

  • No firewall blocking outbound HTTPS (TCP port 443) from Azure to VCC.

  • Bearer token stored securely (token shown only once at generation).

Identity provider support

This integration only supports Microsoft Entra ID (formerly Azure AD).

Support and documentation feedback

For general assistance, please contact Customer Support.

For help using this documentation, please send an email to docs_feedback@vonage.com. We're happy to hear from you. Your contribution helps everyone at Vonage! Please include the name of the page in your email.