Top
Login
Contents x
Integrate your Content Repository with Whatfix
  • 11 Oct 2024
  • 3 Minutes To Read
  • Print
  • Dark
    Light
  • PDF
Contents

Integrate your Content Repository with Whatfix

  • Updated On 11 Oct 2024
  • 3 Minutes To Read
  • Print
  • Dark
    Light
  • PDF
Article summary

Note

The content fetched from your content repository is encrypted at all times, that is, while fetching the content from your knowledge base (during transfer) and upon receiving the content on Whatfix servers.

Whatfix enables you to integrate your existing content repository such as Confluence, Zendesk, Freshdesk, SharePoint, etc., and display the articles you have created in these repositories as contextual links in the Self Help widget that appears on your desktop.

DAP on OS uses a proprietary crawler that can index all the pages of your repository and make them available for search inside Self Help on your application.

For example, if you have your help content in Confluence and your application is Salesforce, then the Confluence articles can be shown as links in the Self Help that appears in Salesforce.

Once the repository has been enabled, you can define the repository that Whatfix needs to index using the following procedure.

Note
  • Integrate up to 5 repositories and crawl 1000 articles per Whatfix account. To integrate more repository content, contact support@whatfix.com.
  • Whatfix supports any HTML-based repository hosted over the Internet. PDF content or XML content is currently not supported.
  • Whatfix can also crawl authenticated repositories and those that are accessed via SSO.

Steps to Integrate a Repository for the First Time

  1. On the Whatfix Guidance dashboard, click Settings.
    ia_left_nav_settings

  2. Click Repositories.
    ia_left%20nav_repositories%20

  1. Click Custom Repository.
    RB_DB_CAggclickcustomrepo1

  2. Enter the title and URL of your repository and specify if the URL is password-protected, and then click Next.
    RB_DBCAggclicknext

your title goes here

If the URL is password-protected, enter the username and password, and then click Next.
username.png

your title goes here
  • The title you provide here is used as the tag name for the default tag attached to all the content fetched.
  • Whatfix automatically converts the URL to lowercase before integration.
  1. Under Crawl Settings, choose from the following options,
  • All Content - This option fetches all the content from the whole repository.
  • Specific Content - This option lets you configure conditions to fetch content from specific folders or spaces of the repository.
    RB_DB_CAggclickIntegrate2
  1. Click Integrate.
    RB_DB_CAggclickIntegratebutton1
your title goes here
  • Once you have created an Integration request, your repository is listed under Applications in the Processing state.
  • Depending on how big your repository is, the content sync might take between 24 - 72 hours to complete.
  • The content fetched can be added to the Self Help widget in the same way as you would add any other Whatfix content.

Steps to Integrate an Additional Repository

Use the following steps if you have already integrated a repository and want to integrate another one with Whatfix,

  1. On the Whatfix Guidance dashboard, click Settings.
    ia_left_nav_settings

  2. Click Repositories.
    ia_left%20nav_repositories%20

  1. Under Integrate Additional Repositories section, select the repository you want to integrate.
    RB_DB_Caggintegraterepos2

  2. Enter the title, URL of your repository, specify if the URL is password-protected, and then click Next.
    RB_DBCAggclicknext

your title goes here

If the URL is password-protected, enter the username and password, and then click Next.
username.png

your title goes here
  • The title you provide here is used as the tag name for the default tag attached to all the content fetched.
  • Whatfix automatically converts the URL to lowercase before integration.
  1. Under Crawl Settings, choose from the following options,
  • All Content - This option fetches all the content from the whole repository.
  • Specific Content - This option lets you configure conditions to fetch content from specific folders or spaces of the repository.
    RB_DB_CAggclickIntegrate2
  1. Click Integrate.
    RB_DB_CAggclickIntegratebutton1
your title goes here
  • Once you have created an Integration request, your repository is listed under Integrated Repositories in the Processing state.
  • Depending on how big your repository is, the content sync may take between 24 - 72 hours to complete.
  • The content fetched can be added to the Self Help widget in the same way as you would add any other Whatfix content.
  • If you click Cancel or close the integration pop-up, the integration request is Saved as a draft in the Integrated Repositories section.
Note

  • The Content Repository links are available in the Ready Stage only after you perform a crawl from your repository to Whatfix.

  • The Content Repository links can’t be pushed to the Draft Stage and you can’t make any edits to the Content Repository links using Whatfix.

  • Once you push the Content Repository links to the Production Stage and you can’t move them back to the Ready or Draft stages like the other Whatfix content and widgets.

  • Unlike other content and widgets that can be tagged in the Draft stage, the repository links can be tagged only in the Ready Stage.

Was this article helpful?
What's Next
Privacy Policy | Whatfix Glossary | Whatfix Platform Status
Copyright © 2024 WHATFIX TM. All rights reserved.
Change password!
Changing your password will log you out immediately. Use the new password to log back in.
Change profile
Success!
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
Logout