Skip to content

Convert incoming support emails into Jira tickets, so employees can report IT issues by simply sending an email.

License

Notifications You must be signed in to change notification settings

octokerbs/TicketBridge

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎫 TicketBridge

TicketBridge is a lightweight automation tool that turns incoming support emails into Jira tickets using AI. Employees simply send an email to the IT department's mailbox, and TicketBridge automatically:

  1. Reads unread messages from the IT inbox.
  2. Uses AI (Google Gemini) to summarize and categorize the request.
  3. Creates a properly formatted Jira ticket with the relevant details.

This removes the need for non-technical staff to learn Jira — they just write an email, and the IT team gets an actionable ticket.

Example

How It Works

  1. Email Intake – Connects to your IT department’s Gmail inbox via IMAP.
  2. AI Analysis – Uses Google Gemini to summarize the issue, detect priority, project, issue type, and assignee.
  3. Jira Publishing – Creates a ticket in Jira with the extracted data and any attachments.
  4. Repeat – Checks the mailbox every minute for new, unread emails.

Requirements

  • Java 17+
  • Gradle
  • Gmail account with App Passwords
  • Jira Cloud account and API token
  • Google Gemini API key

Local Run

./gradlew clean build run

Environment Variables

Before running, configure your .env file or environment variables:

# Google Gemini
GEMINI_API_KEY=AAAAAAAAAAAA_AAAAAA_AAAAAAAAAAAAAA-AAAAA 

# Gmail (IT department inbox)
GMAIL_HOST=imap.gmail.com
GMAIL_ADDRESS=[email protected]
GMAIL_APP_PASSWORD=aaaabbbbccccdddd

# Jira
JIRA_URL=https://kerbsod.atlassian.net/
JIRA_MAIL=[email protected]
JIRA_TOKEN=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA...

Note:

  • Your Gmail account must have IMAP enabled.
  • Use an App Password, not your Gmail password.
  • Jira token can be generated in Account Settings → Security → API Tokens.

Pipeline Overview

Pipeline

Why TicketBridge?

  • Frictionless – No Jira onboarding for non-technical staff.
  • Automated – Tickets appear in Jira within a minute of email arrival.
  • AI-Powered – Summaries and categorizations are generated automatically.
  • Extensible – Easy to adapt to other ticketing platforms or AI models.

About

Convert incoming support emails into Jira tickets, so employees can report IT issues by simply sending an email.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages