Quickstart Guide

This page is about Chat for JSM Cloud. Using Server or Data Center? Click here.

This 3-step guide will walk you through the key concepts you need to know to get started, help you set up the app, and get you ready to serve your customers with a chat widget.

Step 1: Set up Chat for JSM (Admins only)

After installing Chat for JSM from the Atlassian Marketplace, you need to decide on the project you want to have the Chat Widget on and start configuring. There are three ways to access the Chat for JSM Getting Started setup page:

  • Navigate to the Jira top menu, and click Apps > Chat for JSM.

  • Navigate to Project settings > Chat for JSM.

  • Navigate to the Jira cog icon > Apps > Manage Apps. Find Chat for JSM, and click Get Started.

The "Get Started" screen will help you choose the project where you want to enable chat and the issue type specifically for chat requests. This is because each new conversation on your Jira Customer Portal and/or website will be automatically turned into a Jira issue. These requests will be created based on the issue type you select here and then independently for each project. Selecting the issue type will automatically add the Chat Dashboard to your project page.

Service project selection:

Select the project where you would like to enable Chat for JSM. This screen displays the service projects that are available in the instance. Global Jira Admins can see all the projects, while Project Admins only see the projects they are eligible to configure.

  • Projects with no active chat widgets (Chat Widget on the website, Jira Portal, or WhatsApp integration) will display "CHAT OFF".

  • Projects with at least one active widget will display "CHAT ON".

  • New projects or projects where Chat hasn't been configured yet will display no label.

image-20240306-175439.png

Issue type or request type selection:

We recommend using a separate issue type (request type in team-managed projects) created specifically for chat requests.

  • The app can create a ‘Chat’ issue type for Company-managed projects automatically. This option is available only to Global Jira Admins. Project admins won’t see this option.

  • If you're using a Team-managed project, you will need to create a Chat request type manually or choose one of the other existing request types. Please ensure this request type has no required fields other than "Summary" to receive chat requests.

image-20240306-182414.png

When an Agent clicks on Apps > Chat for JSM, they won’t see the Get Started page. Instead, they will be redirected to the Chats in one of the service project. If the Chat hasn’t been set up yet, they will see an info page.


Step 2: Add the widget to your website and Jira Customer Portal (Admins only)

After selecting the project and issue type, you'll be redirected to the Chat Dashboard. Click Install Chat Widget to configure your chat settings.

In settings, you can easily add the live Chat Widget to your Customer Portal or website by clicking Install and following the instructions, if any. Then, you can head over to Appearance to customize its look according to your brand and preferences.

You can customize the widget’s appearance on your website also by tweaking the HTML code.

Then, you can determine the behavior of the Chat Widget and the information it will provide. For example, you can:

  • Set welcome and greeting messages.

  • Enable a pre-chat form to collect information from customers before the chat starts.

  • Integrate your Confluence knowledge base for self-service options within the chat.


Step 3: Go online (Agents)

The support agents can go to the Chats to follow all the support tickets coming through. Each new conversation on your Jira Customer Portal and/or website will create a Jira issue. Through the dashboard, agents can respond to customer messages for both chat and non-chat Jira issues.

This lets them have conversations in real-time, solve customer support requests faster, and make customers happier. A win-win situation!

Explore the dashboard, and click the agent icon to make yourself online using the Go online button.


All systems are go! Go online, and start rocking.