The FAQ editor allows you to You can create and edit FAQ articles in the FAQ editor one by one. However, if you need to add multiple articles at once, the importing/exporting functionality comes in handy. This page describes the key points of managing articles.

FAQ files

When you export or

Importing articles

To import FAQ articles, go to Content > FAQ and click Import articles at the top of the window, and select the file that you want to import. If you want to overwrite articles that already exist, toggle the Overwrite switch. Finally, click Import.

...

FAQ file structure

To import FAQ articles, you have to deal with XLSX files. These are spreadsheets with 5 need to have an Excel file (XLSX) file containing the FAQs. This file needs to have the following five columns:

• Lang: the language of a given article. For example, en for English and fr for French.

• KB: the associated knowledge base

...

• . In this field, you must type the host of your Koji. Typically, it is something like: your-host.atlassian.net

...

• .

If the field is empty, Koji cannot import the file and displays the error: Http failure response for https://kjira.konverso.ai/api/article/import/: 500 OK.

If the field is not empty and has random symbols, the file is uploaded, but this given string is not displayed in the UI.

...

...

• Article ID: a unique identifier of the article.

...

• You don’t need to specify anything here, because once the file is uploaded, Koji assigns IDs automatically.

• Title: the title serves as of the article, which can be the question that users are going to ask.

What about “Learning phrases”? They are not included into exported file.

• Content: an actual answer to a user’s statement.

Exporting articles

• may ask in the chat.

• Content: the answer to the user’s question.

• Keywords: the keywords related to the article. If there are no keywords, leave the cell empty.

...

Creating a file with articles

To help you get familiar with FAQ files, we have created one for you. Its purpose is to demonstrate the structure, so the file contains a number of generic questions. To test it, perform the following:

1. Download the test file:

2. Modify the KB column by typing your Koji’s host. It might be something like your-host.atlassian.net.

...

3. Import the file by clicking Import articles at the top of the window in Content > FAQ.

Now the articles are available both in your FAQ editor and in the chat.

Testing articles

Once your articles are in place, you might want to see them in action. To do so, just ask Koji the question defined in one of your FAQs.

...

Exporting articles

You can also export FAQ articles. Exporting FAQ articles allows you to create a backup of your internal knowledge base. You can send it to another Koji instance or modify it the file’s content and reuse it later on.

To export FAQ articles, go to Content > FAQ and click Export articles at the top of the window. That’s it, the file is downloaded and ready to go.

Importing articles

Let’s say you have an XLSX file (you got it from another instance, for example). You can import it and enrich the list of your FAQ articles. To do so,

To import FAQ articles, go to Content > FAQ and click Import articles at the top of the window, and select the file. Now the articles are added to your FAQ set.

Creating a file for import

You can create a file from scratch. Just bear in mind the format that is described above: an XLSX file with 5 columns.

… An Excel file with your FAQ articles, in the same format described above, is downloaded. Note that the articles in this file will have an ID.

...

What’s next?

View the tutorial explaining how to quickly train Koji. It demonstrates managing FAQ and associated files: The quickest way to train Koji.