VGIS Web is a browser extension that seamlessly combines our business services with your productivity tools allowing you to easily manage contacts, related activities, reporting, and more. Some of our customers also use VGIS Web as a CRM without linking any productivity tools.
Click to Connect lets you place a call or send an SMS message and is also immediately available to you and present on the websites you visit if enabled.
Supported productivity tools include Salesforce, Bullhorn, G Suite, SugarCRM, HubSpot, Office 365, Zendesk, and NetSuite (Coming Soon!).
IMPORTANT NOTES:
Order and Assign Licenses (Admins Only)
- Identify the users who require a license for your productivity tool.
- Contact us at 1300 10 81 84 to place your order.
Once your order is completed by Vonage, licenses are assigned to your users. An email is sent to your users informing them to download and register their browser extension.
Administrator Configuration for NetSuite, JobDiva and Office 365
IMPORTANT:
NetSuite Admins,
JobDiva Admins and
Office 365 Admins must perform some additional steps as follows before their users can download and register VGIS.
Apply Configuration Settings (NetSuite Admins Only)
Before your licensed users can sign in, some additional setup is required as follows:
NOTE: You may also want to view our Video Tutorial or our Instructional Guide which includes useful images.
Step 1: Enable Account Features
- Click Setup > Company > Enable Features.
- Click the Suite Cloud tab and enable applicable settings:
Client Script
ServerScript
Token - Based Authentication - Click Save Changes.
Step 2: Retrieve Account Number
- Click Support, then go to SuiteAnswers.
- Click Contact Us by Phone. The NetSuite Account Number is listed in the new window.
- Send or provide users with Account Number as this is needed when they register NetSuite.
Step 3: Update or Create New User Role
Your users must have a Custom role and if not, one must be created.
NOTE: You can customize a role but you cannot change permissions for Standard roles.
- Go to Setup > User / Roles > Manage Roles.
- Identify the role and click Edit.
- Go to Permissions > Lists.
- Add or enable the following permissions:
Customers | FULL |
Contacts | FULL |
Phone Calls | FULL |
Vendors | FULL |
Partners | FULL |
Companies | FULL |
Other Names | FULL |
Notes | FULL |
Cases | FULL |
- Go to Permissions > Setup.
- Add or enable the following:
Login Using Access Tokens
User Access Tokens
Set Up Web Services
Step 4: Search and Install Vonage for NetSuite Bundle
- Go to Customization > SuiteBundler.
- Enter Vonage for NetSuite in the Search field.
- Click Vonage for NetSuite Bundle and then click Install.
A green checkmark appears under the Status column when the installation is complete, which can take up to 30 minutes.
Step 5: Enable User Authentication
- Sign in to NetSuite with your Admin credentials.
- Search for Two Factor and select. The Two Factor Reset Tool is displayed.
- Enter the user login email address and click Reset (and repeat for each licensed user).
- Inform your NetSuite users that they must complete authentication as described in download and register the browser extension
JobDiva Configuration for Vonage Integration Suite
The JobDiva Administrator must complete the following steps before users can authenticate with JobDiva.
- Send an email to support@jobdiva.com to request your Client ID or Team Id.
NOTE: Instruct your users to use this code every time they authenticate with JobDiva through the Vonage Integration Suite. - Create a JobDiva user with API access within JobDiva.
- This user cannot login to the JobDiva interface.
- This user accesses the JobDiva APIs in the background on behalf of your users.
- An API Username/password can be created in JobDiva by a Diversant Team Leader under Settings/My Team/Add User; this is a regular User account, with the User Permission to access the API.
- Set up the API user in VGIS:
- Click Vonage Integration Suite extension.
- Click My Account; the config portal opens.
- Click on the circle inside the JobDiva rectangle, select JobDiva API user and then Link Now when prompted.
- Login as the JobDiva API user.
Once complete, your users can authenticate with their regular JobDiva credentials.
Allow Additional Domain Access (Office 365 Admins Only)
Download and Register Browser Extension
To use VGIS, download and register the browser extension and if you are a NetSuite user, additional steps are required if you use 2-Factor Authentication.
All Users Except NetSuite with 2-Factor Authentication
Download Browser Extension
IMPORTANT: You must enable desktop notifications to see screen pops on incoming and outgoing calls. To do this, click OK when asked to Let extenstions.gunify.vonage.com show notifications. You MUST keep the Vonage Panel open to get screen pop notifications.
Register and Sign In
You must register VGIS to your account and sign in using your Vonage Business credentials or an Activation Code.
If: | Then: |
Business Credentials | If you have Vonage Business credentials, such as those for the Desktop or Mobile App or the Vonage Enterprise Portal or MobileConnect App, you can use either to register.
- Click the V icon (next to your browser address bar) to open the VGIS Panel.
- Click SIGN IN.
- Enter your Vonage Username and Password (used for Mobile app or Desktop app, as applicable).
- Click SIGN IN.
|
Activation Code | If you do not have Vonage Business credentials, you must use the Activation Code included in the email you received in the Welcome email you received for the Vonage Integration Suite.
- Click the V icon (next to your browser address bar) to open the VGIS Panel.
- Go to Setup with code and click on SETUP.
- Enter the Activation Code from your email and click SUBMIT.
- Go to your CRM (such as Salesforce) and click SIGN IN.
- Enter your credentials for your CRM, then follow prompts to allow access to the integration.
|
NetSuite Users with 2-Factor Authentication Only
You must reset authentication for your account before you download the VGIS extension and register your account.
Reset Authentication for Your Account
Once your Administrator has enabled theTwo-Factor Authenticator and notified you (by email or text token), you must reset for your personal NetSuite account.
- Download the Authenticator to your Chrome browser.
- Sign out of NetSuite.
- Sign back into NetSuite using Two-Factor validation process (email or text token).
- Set up the Authenticator Chrome extension to create a token as follows:
- Mark Authentication app, then click Next.
- Click on the - (minus) or + (plus) icon in the Authenticator browser extension to add NetSuite as a resource.
- Highlight QR Code on the NetSuite page. Browser extension registers and generates a code.
- Enter the generated code under Verify that your configuration is set up successfully (Step 3) and then click Next.
- Mark SMS or phone call and then click Next.
- Enter the phone number, select how to receive the verification code, then enter the code you receive under Verify that your configuration is set up successfully (Step 3) and then click Next.
- Save the list of backup codes presented.
Download Browser Extension
IMPORTANT: You must enable desktop notifications to see screen pops on incoming and outgoing calls. To do this, click OK when asked to Let extenstions.gunify.vonage.com show notifications. You MUST keep the Vonage Panel open to get screen pop notifications.
Register and Sign In to NetSuite
You must register VGIS to your account and sign in using your Vonage Business credentials or an Activation Code.
If: | Then: |
Business Credentials | If you have Vonage Business credentials, such as those for the Desktop or Mobile App or the Vonage Enterprise Portal or MobileConnect App, you can use either to register.
- Click the V icon to open the VGIS Panel.
- Sign in using your Vonage Business credentials for Vonage Desktop or Mobile app.
- Click NetSuite to register.
- Enter NetSuite credentials and account information:
Account ID | Enter the account number and if unknown, ask your Administrator. | Username | Specify your NetSuite user name. | Password | Specify your NetSuite password. | Verification Code | Enter the authentication code you generated. |
|
Activation Code | If you do not have Vonage Business credentials, you must use the Activation Code included in the email you received in the Welcome email you received for the Vonage Integration Suite.
- Click the V icon (next to your browser address bar) to open the VGIS Panel.
- Go to Setup with code and click on SETUP.
- Enter the Activation Code from your email and click SUBMIT.
- Click NetSuite to register.
- Enter NetSuite credentials and account information:
Account ID | Enter the account number and if unknown, ask your Administrator. | Username | Specify your NetSuite user name. | Password | Specify your NetSuite password. | Verification Code | Enter the authentication code you generated. |
|
Manage Calls, SMS, and Contacts (Contact Activity)
All calls/SMS messages you place or receive open a Contact Activity window that lets you manage your contacts:
Salesforce Lightning Users Only: To use Click to Connect, you must also force the detection of suppressed phone numbers. See VGIS Panel > Integrations > Click to Connect.
Make and Receive Calls/SMS
Place Call / Send SMS | You can place a call or SMS as follows:
Click to Connect
Call | Click the Phone icon to place the call. The call is sent and rings your Vonage phones. | SMS | Click the SMS icon, enter a message, then click the Arrow to send. |
VGIS Panel
Contact History |
- Open the VGIS Panel.
- Click Contact History icon.
- Hover over an entry, then click on the Dial Pad icon.
Place Call | Click the Phone icon to place a call to that contact. | Place SMS | Click the SMS icon (next to Phone icon), enter a message, then click the Arrow to send. |
| Contact Activity | Click on Phone icon or SMS icon (right). | Dial Pad |
The Dial Pad is available on all windows of the VGIS Panel.
- Open the VGIS Panel.
- Click on Dial Pad (lower right) of every screen.
Place Call | Search for or enter the phone number for contact, then click on Phone icon | Place SMS |
- Search for or enter the phone number for contact.
- Click on the SMS icon, enter a message, then click the Arrow to send.
|
|
|
Receive Call / SMS |
- Answer incoming calls on your Vonage desk phone and apps. The Contact Activity window is opened.
- Review SMS messages in Contact History or Contact Activity.
If you click the SMS icon in the Contact Activity or Contact History window, the SMS page is opened in Vonage Desktop App.
|
Manage Contacts
Add / Edit Contacts | Add or edit contact information.
Contact Activity Window
Save your contacts to the Contact Activity window to ensure they are available in the CRM.
- Click on the + icon to the right of the contact field name.
- Enter or update First Name, Last Name, and Type.
- Click CREATE or UPDATE CONTACT as applicable.
VGIS Panel
Fast Dial |
- Open the VGIS Panel.
- Click Star icon (top) to access Fast Dial.
- Click on + Add New (top).
- Enter or update Label (Name), Phone Number, and Type.
- Click Save.
| Contact History |
- Open the VGIS Panel.
- Click Contact History.
- Navigate to the phone number to add and click Star icon (on right). A popup box is displayed.
- Enter or update Label (Name), Phone Number, and Type.
- Click Save.
|
|
Create / Update Notes | Add or edit notes.
Contact Activity Window
- Click CREATE NEW NOTE (bottom right) to add a new one.
- Click on the Pencil icon in a note to edit the existing note.
- Double-click on the Note icon to view or update existing notes. The number indicates how many notes there are for that contact.
VGIS Panel
If you create a note in the VGIS Panel, it is not pushed to your CRM. Create notes in the VGIS Panel only if you are not using a CRM.
- Open the VGIS Panel.
- Click Contact History icon.
- Click on a call record.
- Enter or update Subject and Description.
- Click CREATE or UPDATE NOTE as applicable.
|
Open Related Websites (Web Launcher) | Click on the Link icon (lower left) to display and search associated websites, if Web Launcher is enabled and set up for the integration. |
Manage Activities | Click on the Home icon to open a screen to manage the contact:
- Create Contact shortcuts upon receiving an incoming call.
- Set up the activity types that open automatically.
- Display Activities (such as a Lead, Task, or Case) as tabs next to the Home icon.
- Drag and drop a contact to an available resource type to automatically log the necessary contact detail fields for that activity.
- Click on a custom layout (bottom) to apply. The layout defaults to the last selected, even if it is not saved.
|
Navigate and Use VGIS Panel
To open, click the V icon in the upper right corner of your browser next to the address bar.
Icon | Use |
Contact History |
- Filter by missed, dialed, received, or rejected contacts.
- Click on a record to access the Contact Activity window.
- Hover over an entry, then click the Dial Pad icon to call that number.
- Click on the Voicemail icon to listen to messages.
- Click the SMS icon to open messages in the Vonage Desktop App.
- Click on the Person icon to see Contact History.
- Click on the Playback icon to listen to On Demand Call Recordings, if enabled your account. This is available to Vonage Business Communications only.
- Click on the Star next to a call to log as a Fast Dial.
|
Fast Dial |
- Lists your favorite contacts. The digit (upper right) indicates the number of favorites.
- Includes "starred" contacts from Contact History.
- Click +Add New to enter a new favorite manually.
- Click Pencil icon next to an entry to edit details or delete the contact.
|
Integrations |
- Shows your integrations and if signed in, a checkmark is present.
- Lists features that you can enable and disable for your integrations. Click the ? (question mark) to obtain more information about that feature.
If a Gear icon is present, apply options as described under Settings (Global Settings).
Click to Connect |
Places a Phone and SMS icon next to phone numbers on supported web pages. Click the Gear icon to set the following:
- Auto confirm Click to Dial (default device)
- Click to Connect Prompt
- Phone Number Detection Settings
NOTE: Salesforce Lightning users must force detection of suppressed phone numbers.
See Settings (Global Settings) for instructions. | SMS Messaging | Turns on click to send an SMS message. The SMS icon appears next the Phone icon on pages where you can Click to Connect. Your Admin must provide you permission before you can enable this feature. | Web Launcher |
Add unique URLs that will launch a website and search based on the settings you apply. You must be signed in to the website that you want to launch. Click the Gear icon to set up your web launcher sites. See Settings (Global Settings) for instructions.
| Speech Recognition | Use voice to deliver Notes in Contact Activity, where supported. | Dial Prefix | Set a prefix or any special code that is supported by the service provider. Example: [Caller ID Code]+** | Contact History | Shows all inbound and outbound Call/SMS events received on your Vonage phone number. | Fast Dial | Enables quick access to phone numbers marked as favorites. | Call Notes | Add notes to voice calls in the Contact Activity window. To access, click on the call event item in the Contact History. |
|
Announcements | Shows details about the latest VGIS releases. |
Feedback | Rate your experience and provide comments on your use of VGIS. |
Person (Avatar) |
Web Portal | See Use the Web Portal for complete details.
Customer Admins
Customer Admins can manage settings for users that indicate how Contact Activity is handled, provide user access to features, set rules for pop-ups, and obtain account-wide call summary/call detail reports. You can also create custom layouts and make custom resources available to users.
End Users
End Users can view their profile and reports for call summary and call details. You can also access Configuration Tools, where you can manage your access to features, set rules for the pop-ups, set up personal conferences, and push notifications.
| Reports | Lets you view the total number of calls you placed and received. | Account | View your account information. | Settings | Manage settings for your account and window appearances.
Global Settings
Disable Desktop Notifications | Blocks pop up notifications when a call or SMS message is received. | Auto Confirm Click to Dial (default device) | Automatically answers the incoming call that triggers the outbound call for Click to Connect. If disabled, you must first answer the inbound call before the system places the outbound call. | Auto Pop Manager | Lets you set up rules that specify how automatic pop-ups are handled when an Inbound, Outbound or Internal event (Call, SMS, or Voicemail) is received.
- Select the Event, State, and Pop-Up type.
- Click Save.
To test your auto pop rules:
- Click Test (upper right).
- Select the Type, State, Direction, and Phone Number.
- Click Generate.
A test Call, SMS, or Voicemail is generated.
| Synchronize Contacts | Click to manually sync the contacts/entities between your business application and VGIS. | Web Launcher Sites |
Lets you add unique URLs that will launch a website and search based on the settings you apply. You must be signed in to the website that you want to launch. Click the Gear icon to set up your web launcher sites.
Set Up Web Launcher
- Click Web Launcher Sites and then click ADD.
- Enter a name for your query.
- Specify the URL for the website and include a tag: Name, Direction, Phone Number, Service Provider, Call Status. The tag is added next to the URL in braces.
- Click Validate to confirm the string you entered is valid.
- Select when you want to open the website.
- Mark to add a Links icon (lower left) in the Contact Activity window, so you can access this feature directly from that window.
- Click SAVE.
Sample Web Launcher Queries
- Open Salesforce and search by incoming call:
https://cs51.salesforce.com/search/SearchResults?searchType=2&str={{phoneNumber}} - Open LinkedIn and search by contact name:
https://www.linkedin.com/search/results/all/?keywords={{name}} - Open Facebook and search by contact name:
https://www.facebook.com/search/top/?q={{name}}&epa=SEARCH_BOX
| Click to Connect Prompt | Unmark this option to disable the confirmation pop up that appears. This is enabled (marked) by default. | Phone Number Detection Settings |
- Restrict display of Click to Connect -- Click to Connect can interfere with some web pages. To restrict these pages from displaying Click to Connect, click Add (upper right)
- Force detection on web pages where it is suppressed -- If enabled, web pages that automatically suppress Click to Connect will display this feature.
NOTE: Salesforce Lightning users must enable this option. - Include Possible Numbers -- Allow Click to Connect to appear next to numbers that may be phone numbers.
|
Window Appearance
Panel | Specify a size for the VGIS Panel. | Activity | Specify a size for the Contact Activity window. | Auto close activity window on save (delay) | Indicates how to treat the Contact Activity window once actions are complete for a contact. | Auto close abandoned activity windows on Panel close (delay) | Indicates how to treat open Contact Activity windows when the VGIS Panel is closed. |
| About | Opens the Vonage website. | Logout | Sign out of VGIS |
|
Dial Pad | The Dial Pad icon is available on each window of the VGIS Panel.
Place Call | Lets you initiate a call to a contact. Once initiated, your Vonage Desktop softphone and any connected device will ring and VGIS screen pop appears. Once the call is accepted, the call rings the destination number. | Place SMS | Search for phone number for contact, then click on SMS icon (next to Phone icon). |
|
Use the Web Portal
Access the Portal Dashboard
- Sign in directly or access from VGIS Panel:
Direct link: | Click Web Portal. |
VGIS Panel |
- Click the V icon next to your address bar to open the VGIS Panel.
- Click the blue Person (Avatar) icon and then click the Web Portal icon.
|
- Manage options:
Account Management
End User | My User |
- View and edit your profile information.
- Go to Configuration Tools (left) to your access to features, set rules for the pop-ups, set up personal conferences, and manage push notifications.
|
|
Admin | My Account | Manage account options, where you can perform a search for a user (top right) or click on your user name for quick access to options, including signing out of the Web Portal. There are three primary areas:
Manage Account (center)
- Edit account name/organization. Click Pencil icon.
- Update Service Providers. Click Settings icon.
- Manage User Integrations as follows
Configuration Tools (top right)
- Account User Features -- Click to enable and disable features account-wide. You can also lock features to prevent users from changing the setting. You can also manage these per user to override settings applied account-wide.
- Users Auto Pop Manager -- Lets you set up rules that specify how automatic pop-ups are handled when an Inbound, Outbound or Internal event (Call, SMS, or Voicemail) is received.
- Synchronize Contacts -- Perform a full sync of contacts across all users for the account.
IMPORTANT: A full sync pauses contact lookup and takes quite some time. It is recommended you apply a full sync after hours.
Account Users (bottom)
Click a user to update or set information for the individual
|
Users |
- Perform a quick search for a user.
- Click + Create User to add a user
- Click a user to update or set information for the individual:
- Click the Edit icon (next to name) to update contact information.
- Click the Sheild icon (next to status) to set user roles: Account User, Customer Admin, End User.
- Apply Configuration Tools (right panel) options per user that include User Features, Auto Pop Manager Settings, Personal Conferences, Push Notifications, and Resend Welcome Email.
|
Reports
End User | Calls Summary | View a summary of all calls for the duration you specify. |
Call Detail Records | View call details of all call you answered or placed for the duration you specify. |
|
Admin | Calls Summary | View the account-wide call summary for the duration you specify. You can also choose to view by user. |
Call Details Records | View the account-wide details for all call details for the duration you specify. You can also choose to view by user. |
Set Up Personal Conferences
Set up personal conferences using preferred meeting tools such as Chime, Slack, Webex, and so forth, and more than one tool is allowed. Conferencing details are required to set up.
- Access Web Portal.
End Users |
- Click My Account.
- Go to Configuration Tools (on right) and then click Personals Conferences.
|
Admins |
For a User |
- Click Users.
- Click on a user name.
- Go to Configuration Tools (on right) and then click Personals Conferences.
| For Yourself |
- Click on your user name (top right) and select My User.
- Go to Configuration Tools (on right) and then click Personals Conferences.
|
|
- Click + ADD NEW.
- Add your personal bridge information.
Field | Action |
Name | Enter the name of the Conference Service (Vonage Meetings, Chime, and so forth). |
ADD PHONE NUMBER / PIN | Enter the phone number you must dial to join the conference and the PIN/Meeting ID. |
ADD VIDEO LINK | Enter the URL link to your conference bridge. |
ADD SIP URI | Enter the VH ID of the SIP URI. Some conference systems have a SIP URL or IP address that is used to join, such as some Polycom conference systems. |
ADD LINK | If your conference solution has a link for instructions to join, enter that information here. |
- Click Save.
Apply General Account Integration Settings
Apply Contact Activity (Call and SMS) settings for all users across the account.
- Access Web Portal.
- Click on My Account, then go to User Integration section.
- Click on the actual integration name (not the Hamburger or Wrench icon).
- Choose to enable Call Auto-activity Settings and/or SMS Auto-activity Settings and apply options.
Contact Activity Settings | Resource types | Select the activity type(s) to use for these settings. |
Skip internal calls | Mark activity types to exclude from automatically logging. For example, skip when multiple contacts are found. |
Skip zero duration calls |
Skip when no contact was found |
Skip when multiple contacts are found |
Default Subject |
Displays the format used to describe the subject of your activity. Values are predefined but you can customize as needed.
|
Default Call description | Displays the format used for the comment for your activity. Values are predefined but you can customize as needed. |
|
SMS Activity Settings | Resource Type | Select the activity type(s) to use for these settings. |
Skip internal sms | Mark activity types to exclude from automatically logging. For example, skip when multiple contacts are found. |
Skip when no contact is found |
Default SMS Subject | Displays the format used to describe the subject of your activity. Values are predefined but you can customize as needed. |
Default SMS description | Displays the format used for the subject of your activity. Values are predefined but you can customize as needed. |
|
Account level Access | Leave as blank. |
- Click Save.
Create Custom Layouts (Admins Only)
Customer Admins can customize the Contact Activity window for their users by creating custom layouts. These layouts let Admins hide, show or order fields in integrations to allow quicker access to what is needed.
IMPORTANT: If the Layout Builder is not set up correctly, it can result in an error when a user attempts to save their work activity in the Vonage Integration Suite (VGIS). We advise that you work with your CRM Administrator if you are not familiar with the roles/permissions of your users.
Create Layout |
- Access Web Portal.
- Click My Account and go to the User Integrations section (top center).
- Locate the integration you want to modify, then click on the Wrench icon.
- Select your name in the View as User popup box.
- Go to Resource Type and select the object you want to modify. For example, a Case, Lead, or Task are objects.
- Scroll to the bottom and click SHOW ALL to list all available fields.
Any field/item preceded by the Up/Down Arrows icon can be arranged. If an item has a Settings icon, you can further define the use of that field.
- To Exclude fields, click and drag the Up/Down Arrows icon and move to Excluded Fields (left side).
- To Reorder fields, click and drag the Up/Down Arrow icons up or down.
- Go to Layout Name (bottom) and specify a name for your layout.
- Click CREATE for new or UPDATE to modify.
|
Test / Apply Layout |
- Access Web Portal.
- Open a Contact Activity window, then click on the Custom Layout menu (bottom center) to select the one you want to test.
- Verify your layout and if correct, inform users of availability.
Otherwise, return to the Layout Builder to UPDATE or DELETE. - Inform users that a new layout is available.
|
Unlock Custom Resources (Admins Only)
Customer Admins can unlock Custom Resources from the Integration Resources panel within the Web Portal. These extended resources provide access to ALL fields in an integration, instead of just a few pre-configured resources.
IMPORTANT: Unlocking certain Custom Resources can adversely affect users if the user does not have access (permissions) for that field. We advise that you work with your CRM Administrator if you are not familiar with the roles/permissions of your users.
- Access Web Portal.
- Click My Account and go to the User Integrations section (top center).
- Locate the integration you want to modify, then click on the Hamburger icon.
- Select your name in the View as User popup box.
The Integration Resources panel first lists your Contacts followed by Activities.
For Contacts |
- Select the items to display.
- Turn on Auto Sync to if you want to automatically sync with phone numbers.
|
For Activities | Choose the items that the user can display as tabs in their Contact Activity window (specifically on their Home page). |
Selections are saved automatically and applied to all users under the VGIS account.
Auto-Activity Behavior
Most CRMs include a Status field in the objects, most likely used for auto activities. VGIS sets this field using the following method:
- VGIS looks for a default Status from the CRM. In the absence of this, the system will look for a Completed status.
- If no such status exists, the system selects the first available status provided by the CRM. In most CRM systems, this allows the CRM administrator to control the value by setting a default.
- In systems that don't support this, the "Completed" status is the most common choice for this field.
For Vonage for SugarCRM, it is not possible to target the completed status, so in that case, the Status will use the default settings in SugarCRM. For Calls, it's recommended to set the default to Completed so that users will not get notified from Sugar regarding calls that have already taken place.