Getting Started

Prerequisites

Before moving to Step 1, verify the following:

• Scroll Sites is installed on your Confluence Cloud instance.

• A Site is created and published: You must have at least one live Scroll Site URL (e.g., https://your-company.scroll.site).

• Permissions: You must have Administrator permissions for both Confluence Cloud and Jira Cloud.

Step-01: Install the app

• You can install the app from the Atlassian Marketplace.

Step-02: Configure Service Management Integration app

In this step, you will set up the connection between your Jira Service Management (JSM) project and your Scroll Site.

1. Open the app's configuration page: Navigate to "Jira settings" → "Apps" → "Service Management Integration".

2. Add your Site: In the app settings, register the URL of the Scroll Site where the widget will be displayed.

   • 

     
     

3. Define Default Portal & Request Types: Select the specific JSM Portal you want to integrate. Choose the default request types that users will see when they open the widget.

4. Generate Connection Code: Once the configuration is saved, the app will generate a Custom JS Connection Code. Copy this snippet to your clipboard; you will need it for the next step.

   • 

     
     

Step-03: Configure your Scroll Site

Now, you need to tell your Scroll Site to load the widget using the code you just generated.

1. Create a custom link: In your Scroll Site theme configuration, create a new link in the Header Section with a name like “Service Management” and URL of your choice (e.g., /service-management) where the widget will live.

   • 

     
     

2. Insert the JS Connection Code: Navigate to the Code section of your theme settings. Paste the code snippet you copied from the Service Management Integration app.

   • 

     
     

3. Publish the Site: Save your changes and click Publish. This makes the script active and prepares the "handshake" between the systems.

Step-04: Verify the Integration

Finally, ensure that the widget is functional and that the extended features are working as expected.

1. Access your Scroll Site: Open your live Help Center in a browser.

2. Interact with the Widget: Locate the widget page (like “Service Management”) in header menu and open it.

3. Check JSM authentication: Authenticate via the JSM portal using your Atlassian account (ensure you have customer permissions on the JSM Portal) or use a dedicated customer account (Portal-only account).

   • 

     
     

4. Check Request Availability: Verify that you can see your existing tickets.

   • Confirm that the Status is displayed correctly.

   • Try adding a Comment to a ticket to ensure the two-way integration is fully active.

   • 

     
     

   •