Home
This open source Node.js application provides a sample implementation for syncing data into Genesys Knowledge. You can customize it to create your custom connectors between your own knowledge management solution and Genesys Knowledge. Running the application will perform one synchronization operation. For periodic synchronization, customers have to setup a way (e.g.: a cron job) that will start and run the knowledge connector application with the desired frequency.
- Sync articles from 3rd party Knowledge Bases to Genesys Knowledge
- Sync from one Genesys Organization to the other
- The sample data loader implementations can be used as starting points to implement your own
- HTML converter that converts articles from HTML to Genesys Knowledge's JSON format
- Image uploader for transferring attachments from the source solution to Genesys Assets Management service
- Syncing only the new and updated entities
- Open source project repository: https://github.com/MyPureCloud/knowledge-connector-app
- Project documentation: https://github.com/MyPureCloud/knowledge-connector-app/wiki
- Knowledge HTML Converter library: https://github.com/MyPureCloud/knowledge-html-converter
The configuration contains data for connecting to the source system and Genesys Cloud's API as well. For API-based systems, you need to configure the base URL of the API and Client ID, Client Secret for authentication.
When the app is run, it performs the following actions:
- Fetches data from source system
- Transforms data into Genesys Knowledge format
- Uploads new images
- Uploads new and updated articles to the target Knowledge Base
- Removes articles from target Knowledge Base which have been deleted from the source system since the last run of the app
For using this application to sync data from your Knowledge Management System, you need to create a data loader class that implements the Loader interface.
Performing a synchronization will pull new and updated entities from the source into Genesys Knowledge. It will also delete existing entities that got removed from the source. The application is capable of recognizing already synced entities and thus they won't be duplicated.
Changes done to the synced entities in Genesys knowledge will be overwritten by the source entities during the sync process. This is a one way synchronization, meaning changes done in Genesys Knowledge won't affect the source entities.
A synced entity is recognized by an external id, that is a combination of EXTERNAL_ID_PREFIX config constant and the entity's id in the source. It is possible to sync from multiple sources to one single Genesys Knowledge Base by using different EXTERNAL_ID_PREFIX-es and multiple knowledge connector app instances.