Vonage Business Cloud AU Support

Vonage Business Communications Support

Enter a search topic

Vonage Support

Vonage Integration Suite (VGIS) - Mobile

Updated: 4/19/2024 12:24 AM

VGIS - Mobile seamlessly combines your productivity tools with our business services allowing you to easily manage activities related to your contacts directly in the VBC Mobile App. It is available for the following devices:

MobileApple (IOS) and Android Phones
Tablet
  • Apple (IOS) 
  • Android (experience is the same as mobile)

Supported productivity tools include SalesforceBullhornG SuiteSugarCRMHubSpotOffice 365ZendeskMicrosoft Dynamics, and NetSuite.

Administrators can manage account-wide settings in the VGIS Config Portal.

IMPORTANT NOTES:

  • Limitation: Productivity tool contacts currently do not sync with the VGIS Mobile Integration.
  • Tablets and phones can offer limited space for filling out data. Use Custom Layouts to keep only the required fields visible.
  • Microsoft Dynamics is not supported outside of the US at this time.
  • The Vonage Integration Suite is also available for Desktop App or as a Web Browser Extension.

Order and Assign Licenses (Admins Only)

To add a productivity tool for use with VGIS Mobile, order the product for your Vonage Business account and assign licenses to your users.

Order Licenses
  1. Sign in to Admin Portal.
  2. Click Store, then click Plugins.
  3. Choose productivity tool, enter the number of licenses, then click Add
  4. Click Checkout, verify, and then click Submit
Assign Licenses to Users

Once an order is placed, licenses are immediately available to assign to your users. By default, licenses are randomly assigned to your extensions. To reassign:

  1. Click Billing and then click Manage Services.
  2. Hover over your productivity tool, then click the Magnifying Glass.
  3. Review the number of services available and assign as applicable:
     
    Assign to Available ExtensionClick Select from Available Extensions and select the extension. 
    Move to Different Extension
    1. Click the X icon next to the assigned extension to un-assign. 
    2. Click Select from Available Extensions and select the extension to assign. 
    An email is sent to assigned 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
  1. Click Setup > Company > Enable Features.
  2. Click the Suite Cloud tab and enable applicable settings:

    Client Script
    ServerScript
    Token - Based Authentication
  3. Click Save Changes.
Step 2: Retrieve Account Number
  1. Click Support, then go to SuiteAnswers
  2. Click Contact Us by Phone. The NetSuite Account Number is listed in the new window. 
  3. 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. 

  1. Go to Setup > User / Roles > Manage Roles.
  2. Identify the role and click Edit.
  3. Go to Permissions Lists.
  4. Add or enable the following permissions:
     
    CustomersFULL
    ContactsFULL
    Phone CallsFULL
    VendorsFULL
    PartnersFULL
    CompaniesFULL
    Other NamesFULL
    NotesFULL
    CasesFULL
  5. Go to Permissions > Setup
  6. 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
  1. Go to Customization > SuiteBundler.
  2. Enter Vonage for NetSuite in the Search field.
  3. 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
  1. Sign in to NetSuite with your Admin credentials.
  2. Search for Two Factor and select. The Two Factor Reset Tool is displayed.
  3. Enter the user login email address and click Reset (and repeat for each licensed user). 
  4. Inform your NetSuite users that they must complete authentication as described in Access Your Productivity Tool.  
JobDiva Configuration for Vonage Integration Suite

The JobDiva Administrator must complete the following steps before users can authenticate with JobDiva.

  1. 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.
  2. 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.
  3. Set up the API user in VGIS:
     
    1. Click Vonage Integration Suite extension.
    2. Click My Account; the config portal opens.
    3. Click on the circle inside the JobDiva rectangle, select JobDiva API user and then Link Now when prompted.
    4. 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)

Step 1: Sign in to the Microsoft portal.
Step 2: Click Accept. Close window if a blank page appears. 
Step 3: Inform your users that they can as described in Access Your Productivity Tool.

Access Your Productivity Tool

All users sign in/out of their productivity tools in the same manner but NetSuite users have some additional steps they must complete before doing so initially. 

All Users Except NetSuite
Sign In
  1. Sign in to the Mobile App.
  2. Tap your profile picture on the top left to access the menu, then select the App Center icon.
  3. In the My Apps tab, select the icon for your productivity tool. 
  4. Use your CRM login credentials.
  5. After logging in, close the window and return to the Vonage app.
  6. Tap the back arrow and return to see the app's home screen.
     
    Zendesk Users OnlyBefore you sign in, you must specify the Subdomain. This field is optional for all other productivity tools. 
    MS Dynamic Users OnlyBefore you sign in, you are prompted to enter and save the Custom Domain for your company before you sign in to MS Dynamics. The Custom Domain is the URL/Domain displayed in your browser when you sign in to MS Dynamics.
Sign Out
  1. Tap your profile picture on the top left to access the menu, then select the App Center icon.
  2. In the My Apps tab, select the icon for your productivity tool
  3. Click on your user name and select Log Out from the menu.
 
NetSuite Users Only
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 account before you sign in. 

  1. Download the Authenticator to your Chrome browser.
  2. Sign out of NetSuite.
  3. Sign back into NetSuite using Two-Factor validation process (email or text token).
  4. Set up the Authenticator Chrome extension to create a token as follows:
     
    1. Mark Authentication app, then click Next
    2. Click on the - (minus) or + (plus) icon in the Authenticator browser extension to add NetSuite as a resource.
    3. Highlight QR Code on the NetSuite page. Browser extension registers and generates a code. 
    4. Enter the generated code under Verify that your configuration is set up successfully (Step 3) and then click Next.
    5. Mark SMS or phone call and then click Next.
    6. 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
    7. Save the list of backup codes presented. 
  5. Sign In/Sign Out of NetSuite.
Sign In to NetSuite
Sign In
  1. Sign in to the Mobile app
  2. Tap your profile picture on the top left to access the menu, then select App Center.
  3. In the My Apps tab, select the NetSuite icon.
  4. Enter NetSuite credentials and account information:
Account IDEnter the account number and if unknown, ask your Administrator.
UsernameSpecify your NetSuite user name. 
PasswordSpecify your NetSuite password.
Verification CodeEnter the authentication code you generated. 
    5.  After logging in, close the window and return to the Vonage app.

    6.  Tap the back arrow and return to see the app's home screen.
    Sign Out
    1. Tap your profile picture on the top left to access the menu, then select the App Center icon.
    2. Select the icon for your productivity tool.
    3. Click on your user name and select Log Out from the menu.
    ​​​​​​
    Manage Activities
    Manage Activities
    Create / Update Activity

    If there is a magnifying glass inside the field, it will search Salesforce objects and allow you to select a value.
     

    Your administrator may have created mobile layouts with only the fields that are absolutely needed in the VGIS Config Portal.  Select the layout at the bottom of the screen.

    If there is a + at the end of a field, you can use it to add an object of that type, for example, Contact.
     

    In-Call
    1. While on a call, select your app by pulling up on the My Apps slider and selecting your app.
    2. Select the object type and tap on Add.
    3. Click Create or Update as applicable.
    Calls (Call History)
    1. Tap Calls and select a call to view.
    2. Click on your productivity tool under Apps.
    3. Modify activity as needed. 
    4. Click Create or Update as applicable.
    App Home
    1. Tap your profile picture on the top left to access the menu, then select the App Center icon. 
    2. In the My Apps tab, select the icon for your productivity tool
    3. Use the options at the top to filter by activity type and time span.
    4. Tap the activity to modify.
    5. Modify activity as needed. 
    6. Click Update to save your changes.
    Apply a Custom LayoutYour Administrator can customize the view of your activity window by creating custom layouts. To apply:
     
    1. Open Activity window from the In-Call, Call History, or App Home screen.
    2. Click Layout (next to Create / Update) if available. 
    Use the Web Portal (Admins Only)
    Access the Portal Dashboard
    1. Sign in directly or access from VGIS Panel:
       
      Direct LinkClick Web Portal.
      VGIS Panel
      1. Click the icon next to your address bar to open the VGIS Panel.
      2. Click the blue Person (Avatar) icon and then click the Web Portal icon.  
    2. Manage options:
       
      Account Management
      My Account
      • Edit account name/organization.
      • Update service providers.
      • Synchronize contacts (right panel)

        IMPORTANT: A full sync pauses contact lookup and takes quite some time. It is recommended you apply a full sync after hours. 
      • Enable/disable popup for internal calls and/or log of internal calls.
      • Manage User Integrations as follows:
         
      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.
        • Obtain their unique Activation Code
        • Add or update Service Provider.
        • Resend Welcome Email (right panel).
        • Set up a personal conference (right panel)
        • Review call details records (bottom)
      Reports
      Calls SummaryView a summary of all calls for the duration you specify.
      Call Detail RecordsView call details of all call you answered or placed for the duration you specify. 
      Calls SummaryView the account-wide call summary for the duration you specify. You can also choose to view by user.
      Call Details RecordsView 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

    You can set up personal conferences for your users or yourself using preferred meeting tools such as Chime, Slack, Webex and so forth and more than one is allowed. Conferencing details are required to set up.

    1. Sign in to the Web Portal.
       
      For Your Users
      1. Click Users.
      2. Click on a user name.
      3. Go to Personal Conferences (on right) and click Gear icon.
      For Yourself
      1. Click on your user name (top right) and select My User
      2. Go to Personals Conferences (on right) and click Gear icon.
    2. Click + ADD NEW
    3. Add personal bridge information.
       
      NameEnter the name of the Conference Service (Vonage Meetings, Chime, and so forth). 
      ADD PHONE NUMBER / PINEnter the phone number you must dial to join the conference. Enter the PIN/Meeting ID.
      ADD VIDEO LINKEnter the URL link to your conference bridge. 
      ADD SIP URIEnter the VH ID of the SIP URI. Some conference systems have a SIP URL or IP address that they phones can join. We have this feature on the Polycom conference systems that are our conference rooms in Atlanta.
      ADD LINKIf your conferencing solution has a link to instructions, you would include that here. They appear smaller and in a light gray color in the Vonage for Slack integration.
    4. Click Save
    Apply General Account Integration Settings

    These account-wide settings applied by an Administrator for their account.

    1. Access Web Portal.
    2. Click on My Account, then go to User Integration section.
    3. Click on the actual integration name (not the Hamburger or Wrench icon).
    4. Choose to enable Call Auto-activity Settings and/or SMS Auto-activity Settings and apply options. 
       
      Call Activity SettingsResource typesSelect the activity type(s) to use for these settings.
      Skip internal callsMark 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 descriptionDisplays the format used for the comment for your activity. Values are predefined but you can customize as needed.
       
      SMS Activity SettingsResource TypeSelect the activity type(s) to use for these settings.
      Skip internal smsMark exclusions to auto log SMS activity types. 

      For example, skip when multiple contacts are found. 
      Skip when multiple contacts are found
      Default SMS SubjectDisplays the format used to describe the subject of your activity. Values are predefined but you can customize as needed.
      Default SMS descriptionDisplays the format used for the subject of your activity. Values are predefined but you can customize as needed.
       
      Account level AccessLeave as blank.
    5. Click Save.
    Create Custom Layouts

    Customer Admins can customize the view of the 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
    1. Sign in to the Web Portal.
    2. Click My Account and go to the User Integrations section (top center).
    3. Locate the integration you want to modify, then click on the Wrench icon. 
    4. Select your name in the View as User popup box.
    5. Go to Resource Type and select the object you want to modify. For example, a Case, Lead, or Task are objects.
    6. 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.
    7. Go to Layout Name (bottom) and specify a name for your layout. 
    8. Click CREATE if this is a new layout. Otherwise, click UPDATE.
    Test / Apply Layout
    1. Log into your Mobile App.
    2. Open a Call Activity window, then click on the Custom Layout menu (bottom center) to select the one you want to test. 
    3. Verify your layout and if correct, inform your users of availability. Otherwise, you can return to the Layout Builder to UPDATE or DELETE.
    4. Inform your users that a new custom layout is available. 
    Unlock Custom Resources

    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.

    1. Sign in to the Web Portal.
    2. Click My Account and go to the User Integrations section (top center). 
    3. Locate the integration you want to modify, then click on the Hamburger icon. 
    4. Select your name in the View as User popup box.

      The Integration Resources panel first lists your Contacts followed by Activities.
       
      For Contacts
      1. Select the items to display.
      2. Turn on Auto Sync to if you want to automatically sync with phone numbers. 
      For ActivitiesChoose the items that the user can display as tabs in their Call Activity window (specifically on their Home page).

      Selections are saved automatically and applied to all users under the VGIS account.
    Troubleshooting
    I don’t see any apps available to select within VBC MobileIf you cannot see any integration apps available to select within the VBC Mobile application, it is possible that you do not have any licenses assigned to your user.  To purchase a license, an administrator must follow the steps to Order and Assign Licenses.
    The page in the app doesn’t refresh after I’ve logged inIf you do not see the page in the VBC app refresh after you have completed the CRM / productivity tool login, then move to another option in the app (e.g. tap one of the icons on the bottom) and navigate back to the phone call details.  You should now be able to select the app and see the activities related to that call and also see the interface to add new activities.
    There is not enough room on the screen to update activitiesDepending on the CRM / productivity tool and the objects selected, there could be too many fields on a very small area of the screen to work with.
     
    • Use objects that are optimized for mobile data entry.  Make sure that there are as few mandatory fields as possible, and use a layout that removes unnecessary fields from view unless the user taps to see them.  For help with layouts, see Custom Layouts
    • Use a tablet or a phone with a larger screen.  The interface works well with the latest iPhone and Android devices.

     

    Did this article answer your question?