​
Introduction

Integrate Gurubase with Jira to deploy a bot that can answer questions within your Jira tickets. The bot scans through tickets specified by a JQL query and provides answers based on its configuration. It can operate in two modes:
  • Auto Mode: Responds to all new tickets and mentions (by tagging @gurubase).
  • Manual Mode: Responds only when Gurubase is mentioned.
For Gurubase Self-hosted version, this integration is currently in beta and available to selected users. For Gurubase Cloud version, this integration is available to all users.

​
Steps to Integrate

  1. Create your Atlassian API token
  2. Navigate to Integrations
    • Go to the Gurubase dashboard
    • Click on “My Gurus” under the profile
    • Click on the Guru you want to integrate with Jira
    • Click on the “Integrations” tab
    • Click on the “Jira Bot” option below “Deployments”
  3. Fill in the fields
    • Domain - Your Atlassian domain (e.g. your-domain.atlassian.net)
    • User Email - Your Atlassian user email
    • API Token - The API token you created in Step 1
Jira Integration Fields

​
Bot Settings

After a successful connection, you can configure the bot’s behavior.
Jira Bot Settings
  • Bot Mode: Choose between Auto and Manual modes.
    • Auto: Responds to all new tickets and mentions.
    • Manual: Responds only to mentions.
  • JQL Query: Define which tickets the bot should monitor and respond to using Jira Query Language (JQL). Click Validate to ensure your query is correct.
Important: The Jira Bot integration only processes tickets created after the initial setup. Any updates to the JQL query will only apply to new tickets created after the changes are saved. The bot does not process historical tickets.

​
Using the Bot

Once configured, the bot will start answering the Jira tickets that match your JQL query.

​
Next Steps

API Reference

Explore our API documentation

Add Slack Bot to Your Workspace

Learn how to add a Slack bot to your workspace