How do I import articles from TOPdesk to Spotler AIgent?

To automatically import articles from TOPdesk, you provide your TOPdesk details, and we synchronize the articles every night or you can manually synchronize them. This article explains how TOPdesk can be synchronized.

Step-by-step guide

Step 1: First, we need to generate an "application password" via TOPdesk. To synchronize the knowledge base from TOPdesk to Spotler AIgent, it's important to note that the credentials used for synchronization are an "application password" generated in TOPdesk.

We need this password for the TOPdesk Configuration in Spotler AIgent. You can find the TOPdesk configuration on the left under Integrate.

Step 2: This "application password" can be generated in TOPdesk via Open user menu -> Settings and then Add application passwords.

Please note: These passwords have an expiration date; make sure to keep an eye on that! Use the generated application password in Spotler AIgent and synchronize the knowledge base.

image2.png

Step 3: The content needs to be maintained in TOPdesk itself. The integration daily imports new content from TOPdesk or overwrites existing content. The Published or Unpublished status of the imported content remains intact.

Maintaining the knowledge base

Once you have synchronized the knowledge base, it's important to manage the content within TOPdesk. There's also an option to create a knowledge base article within Spotler AIgent.

  • If an article is created within Spotler AIgent, you can synchronize it with TOPdesk using the 'Sync TOPdesk' button on the Integrate or Knowledge page.
    • This button only activates synchronization from Spotler AIgent to TOPdesk. Synchronizing articles from TOPdesk to Spotler AIgent happens automatically every night or manually by clicking 'Sync TOPdesk.'

image1.png

Managing articles in TOPdesk

  • Users can create and manage knowledge articles in TOPdesk via the Dashboard through the TOPdesk menu.

  • Knowledge articles can be edited via the Explorer menu. 

  • When these knowledge articles are synchronized with Smart AIgent, the structure and order need to be the same. For example, the IT homepage falls under the IT category in Smart AIgent.

  • Knowledge articles from TOPdesk will synchronize with the following information:
BOTS TOPDESK
Title Title
Category Section
Keywords Keywords
Body

Content

 

TOPdesk example: 

Screenshot 2023-12-06 at 14.55.30.png

Smart AIgent example: 

Screenshot 2023-12-06 at 14.55.48.png

This is how the knowledge article will be displayed in the chat widget: