Troubleshooting

Installation error

Symptoms

You cannot install the app and you get the following error:

Installation failed. The app defined an unknown module (jiraProjectPages).

Solution

This error occurs because you are not in Service Management. Switch to the Service Management by clicking the icon with dots in the upper left of the window, and try installing the app again.

Anonymous users cannot open the widget

Symptoms

Anonymous access was configured on your service portal, and non-authenticated users see the widget, but they get an empty area (Error 500) when trying to open it:

Solution

In your Jira project, go to Customers and make sure that Anonymous Kbot User is present in the list. If such a user is absent, re-install the application.

Configuration error

Symptoms

You have changed the configuration in Koji settings, but there are no changes in the chat.

Solution

Option A: refresh the page with your chat.

Option B: click the hamburger menu in the upper left of the chat and select Clear the chat.

Ticket creation error

Symptoms

A user is trying to create a ticket and gets the following error:

Your request could not be created. Please check the fields have been correctly filled in. Please provide a value for required field 'Who is the employee manager?'

Solution

The request that the user is trying to create implies selecting a user from the list. Only Service Desk agents have access to users list.

  • Make sure the user is present in Project settings > People. If the user is not there yet, invite them.

  • Assign the Service Desk Customer role to this user.

Confluence Articles are not displayed

Symptoms

Confluence Articles exist in your knowledge base, but they are not displayed in the Portal and in Koji.

Solution

  • Open your project.

  • Go to Project settings > Knowledge base.

  • Make sure that the space is not “Private”.

Getting the latest configuration updates

Symptoms

An administrator modifies settings, such as user permissions, but they are not applied in users' chats.

Solution

To get the latest updates on the configuration, type renew in the chat.