(New) The Workvivo connector enables Appspace to synchronize content from Workvivo. Workvivo posts are synchronized as Appspace User Posts, while Workvivo articles and events can optionally be ingested as Stories and Event Posts.
When configuring the connector, you can select the Workvivo spaces to synchronize, map Workvivo spaces to Appspace tags, restrict synchronized content by Workvivo author roles, and use Workvivo Space as a property in output rules.
Prerequisites
Before configuring the connector, ensure that the following information is available:
-
A Passport that can be used to access the Workvivo organization. See Create Application Passport for Third-Party Integration.
-
The Workvivo API URL.
-
The Workvivo Organization ID.
-
The Workvivo spaces that you want to synchronize with Appspace.
-
For general information about creating and managing Post Connectors, see Configure Post Connectors for Third-Party Integration.
Create and Configure the Workvivo Connector
-
Log in to the Appspace console.
-
Go to ☰ > Integration > Connectors.
-
Click + CREATE, select Workvivo, and continue to the connector setup.
-
On the Setup tab, configure the Workvivo connection:
-
Passport – Select the Passport used to access Workvivo.
-
API URL – Enter the API URL for the Workvivo organization.
-
Organization ID – Enter the Workvivo Organization ID.
-
Spaces – Select one or more Workvivo spaces from the spaces discovered for the organization.
-
-
Configure the content types that Appspace should ingest:
-
Enable Ingest articles to ingest Workvivo articles as Appspace Stories. When this option is disabled, Workvivo article webhooks are not ingested.
-
Enable Ingest event to ingest Workvivo events as Appspace Event Posts. When this option is disabled, Workvivo event webhooks are not ingested.
-
-
To apply Appspace tags based on the source Workvivo space, configure a tag mapping and select the applicable Workvivo Space and Appspace tags.
-
Use the webhook callback information and authentication key displayed for the connector when configuring webhook delivery from Workvivo. If the authentication key is rotated, update the corresponding webhook configuration in Workvivo.
-
Open the Output tab.
-
Under Allowed Roles, select the Workvivo author roles whose content may be processed by the connector.
-
When creating an output rule that filters content by its source space, select Workvivo Space as the rule property and select the applicable Workvivo space.
-
Save the connector.
Important: Avoid configuring multiple active Workvivo connectors for the same Workvivo tenant solely to separate content by Workvivo Space. Workvivo does not filter webhook delivery by space, so multiple connectors configured for the same tenant can receive the same webhook.
If one connector is mapped to the Workvivo space and another connector is not, both connectors may process an update to the same Workvivo item. The unmapped connector may remove the content while the mapped connector is updating it. This limitation can affect Workvivo Posts, Stories, and Events.
Review the connector logs for warnings or cleanup entries when troubleshooting content that is unexpectedly removed.
How Workvivo Content Is Synchronized
Workvivo content is synchronized according to the content type and the ingestion options configured for the connector.
Workvivo posts are processed as Appspace User Posts. When a source post is created, updated, or deleted, the corresponding Workvivo webhook is processed by the connector. Images contained in Workvivo content, including gallery and inline images, are processed as Appspace attachments rather than retained as temporary external image links.
When Ingest articles is enabled, Workvivo articles are ingested as Appspace Stories. Article information such as the title, subtitle, body, cover image, author, publication time, and source permalink is synchronized. Supported article formatting includes media alignment, image sizing, direct video URLs, bold table headers, and strikethrough formatting.
When Ingest event is enabled, published, updated, and deleted Workvivo events are processed as Appspace Event Posts. Event information includes the title, subtitle, location, start and end times, all-day status, publication time, cover image, and source permalink. The event timezone is based on the event author's timezone.
Workvivo events that are successfully ingested are available in Posts and in the Employee App.
For information about viewing and managing content in the Posts Management module, see Add and Manage Posts Management.
Remove a Workvivo Space
To stop using a previously configured Workvivo space:
-
Edit the Workvivo connector and open the Setup tab.
-
Remove the Workvivo space.
-
Save the connector.
After the connector is saved, the removed space no longer appears on the Setup or Output tabs. The last configured space can also be removed. Configuration associated with the removed space is cleared so that the space does not reappear when the connector is reopened.