Workvivo
The Workvivo integration lets you connect your Workvivo employee-experience platform as a Knowledge Base source in Harmony. Once connected, your Workvivo content becomes available to support workflows, so agents and automated processes can draw on the same articles and pages your employees rely on every day.
What gets imported
When you set up the Workvivo integration, you choose exactly which content to bring in using the space picker. The following options are available:
Company-wide articles - Select the [Global] option to include org-wide articles that live outside any specific space. These are the articles published to your entire organization.
Public space content - Select one or more individual public spaces to import their pages, articles, and documents, including file attachments and external links.
Content safety
By default, only org-visible content is imported. Private team-only content is excluded by default, so you never have to worry about surfacing restricted material to unintended audiences.
Prerequisites
Before you begin, make sure you have:
A Workvivo account with administrator access
A Workvivo API token, your organization's Workvivo ID and, if your organization is not hosted in the US, its API URL. In Workvivo, open Administration > API Keys and JWT Settings, click Add New App, choose API Key as its authentication method and give it read permissions for articles, documents, pages, spaces and users. Then click Manage Keys > Add New Key and copy the token before you close the window: Workvivo does not show it again. The same page shows your Workvivo ID and your organization's base API URL. It requires the Developer role, and Workvivo Support must first enable API access for your organization
Permission to manage integrations in your Harmony workspace
Connect Workvivo as a Knowledge Base source
In Harmony, go to Settings > Integrations and click the Workvivo card under Knowledge Base.
Enter:
API key: your Workvivo API token
Workvivo ID: your organization's numeric Workvivo ID
API URL: the base API URL for your Workvivo region, for example
https://api.workvivo.us/v1. Leave it empty only if your organization is hosted in the US (api.workvivo.us); other regions must enter theirs
Click Connect.
The window stays open and the space picker loads. Use it to select the content you want to import:
Select [Global] to include company-wide articles.
Select any individual public spaces whose content you want to bring in.
Click Save Changes. Harmony will begin importing the selected content. Nothing is imported until you select [Global] or at least one space.
Managing your Workvivo source
After the initial setup you can return to Settings > Integrations > Workvivo at any time to:
Add or remove spaces from your selection, then click Save Changes
Refresh the list of available spaces
Replace the API key: click Replace next to API key, paste the new token and click Save Changes
Disconnect the integration entirely
Content scope reference
Org-wide articles
Select [Global] in the space picker
Public space pages
Select the relevant space in the space picker
File attachments in public spaces
Included automatically when a space is selected
External links in public spaces
Included automatically when a space is selected
Private or team-only content
Not imported - excluded by default
Last updated
Was this helpful?
