App Configuration

The Live Chat for JSM administration panel is accessed from the Jira sidebar. From version 1.0.0, you can manage each service portal's configuration independently.

Accessing the configuration panel

1. In the Jira sidebar, click Apps → Your apps → Live Chat for JSM.
2. The configuration panel will open with the list of portals.

Configure multiple portals

Each configuration connects a service portal to the project, Service Desk, and request type where chats will be created. A portal equals a unique serviceDeskId. The Request Type is required when the portal is active.

In the list of configured portals you can review:

• The Jira Service Management project.
• The associated Service Desk.
• The request type.
• Whether the portal is Active.

Add a portal

1. In the Jira sidebar, click Apps → Your apps → Live Chat for JSM.
2. Click Add portal.
3. Select a Jira Service Management project.
4. Select the Service Desk associated with that project.
5. Select the Request Type customers will use to start the chat.
6. Complete the welcome message and chat closing statuses.
7. If needed, configure who can handle chats.
8. Check Active to show the widget on that portal.
9. Save the configuration.

Only Jira Service Management projects are shown. Projects from other products or types cannot be used for chat.

Edit, activate or deactivate a portal

Select a portal from the list and click Edit to change its data. Each portal retains its own configuration:

• Project and Service Desk where requests will be created.
• Request Type, which must include the Description field.
• Welcome message the customer sees when opening the chat.
• Agent access that defines which users and groups can open that portal's tray.
• Polling (ms), which determines how often new messages are checked.
• Closing statuses, which indicate when the conversation ends.
• Active, which controls whether the widget appears on the portal.

Unchecking Active does not delete the portal configuration. The widget stops appearing and no chats are created from that portal until you reactivate it.

Delete a portal

Click Delete next to the portal you no longer want to use and confirm the action. When deleted, the app stops offering chat on that portal. This action does not delete requests or chat history that were already created in Jira.

Control agent access (ACL)

For each portal you can specify which people can handle conversations from the Live Chat tray:

• authorizedUsers: Add individual authorized users.
• authorizedGroups: Add Jira groups whose members can handle conversations.
• You can combine users and groups as needed.

info

Empty lists mean normal access (JSM agent, Browse Projects, project admin). Lists with values mean only those users/groups have access, plus Jira global administrators.

Global administrators retain access even if not included in these lists. Access applies per portal: a person authorized on one portal does not automatically get access to others. If a person is not authorized, they won't see Live Chat on the project page and cannot open that portal's tray.

warning

The widget's public configuration does not expose ACL lists. This information is only visible to administrators in the configuration panel.

Welcome message

The welcome message is displayed when the customer opens the widget for the first time. The suggested value is: Hello, how can we help you?. Use plain text, no HTML tags.

Polling (ms)

Polling (ms) indicates how often the widget checks for new messages. The default value is 5000 milliseconds (5 seconds). A lower value may show messages sooner but increases the number of requests to Jira.

Closing statuses

In Closing statuses, enter the workflow statuses that should end the chat, separated by commas. For example: Resolved,Closed. It's important to enter them exactly as they appear in Jira so the Resolve option finds the correct closure.

Validations

The app checks the following before saving:

• There cannot be two configurations for the same Service Desk.
• The Request Type is required when the portal is active.
• The Request Type must include the Description field.
• The selected project must be a Jira Service Management project.

If data is missing or a configuration already exists for that Service Desk, a message will appear so you can correct it.