Skip to content

Turtles-AI-Lab/email-to-ticket-parser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📧 Email-to-Ticket Parser

Free web-based tool to automatically extract and structure support ticket information from emails.

Visitors

🎯 Features

  • Smart Email Parsing: Automatically extracts sender, subject, and body
  • AI Classification: Categorizes issues into 8 common support categories
  • Priority Detection: Identifies urgent issues based on keywords
  • Confidence Scoring: Shows how confident the AI is about the classification
  • Export Options: Copy as JSON or formatted text
  • Zero Dependencies: Pure vanilla JavaScript - works offline
  • Mobile Responsive: Works on all devices

🚀 Try It Live

Simply open index.html in your browser - no installation needed!

Or visit the live demo: [Coming Soon]

📋 How It Works

  1. Paste Email: Copy any support email into the text area
  2. Parse: Click "Parse Email" to extract information
  3. Review: See categorized, structured ticket data
  4. Export: Copy as JSON or text for your helpdesk system

🎨 Use Cases

  • Support Teams: Quickly triage incoming emails
  • MSPs: Categorize client requests before creating tickets
  • Helpdesk Systems: Pre-fill ticket forms with extracted data
  • Training: Demonstrate email parsing and AI classification

🏷️ Supported Categories

  • Password Reset
  • Email Issues
  • Printer Problems
  • Network/VPN Issues
  • Software Installation
  • Access Requests
  • Hardware Problems
  • Performance Issues

💡 Example

Input Email:

From: john@company.com
Subject: Can't login to my account

Hi Support,

I've been locked out of my account for 2 hours.
I need access urgently for a client meeting.

Thanks,
John

Parsed Output:

{
  "ticketId": "TKT-L8X9K2M-A3B4",
  "from": "john@company.com",
  "subject": "Can't login to my account",
  "category": "Password Reset",
  "priority": "urgent",
  "confidence": 0.75
}

🛠️ Technology Stack

  • HTML5/CSS3: Modern, responsive design
  • Vanilla JavaScript: No frameworks, fast and lightweight
  • AI Pattern Matching: Keyword-based classification
  • Client-Side Only: Your data never leaves your browser

📦 Installation

Option 1: Direct Use

# Clone the repository
git clone https://github.com/Turtles-AI-Lab/email-to-ticket-parser.git

# Open in browser
cd email-to-ticket-parser
open index.html

Option 2: GitHub Pages

Fork this repo and enable GitHub Pages in settings!

🔧 Customization

Add Custom Categories

Edit js/parser.js and add your category:

your_category: {
    keywords: ['keyword1', 'keyword2', 'keyword3'],
    priority: 'medium'
}

Modify Priority Rules

Edit the determinePriority() function in js/parser.js.

Change Styling

All styles are in css/style.css - customize colors, fonts, and layouts.

🤝 Related Projects

📝 License

MIT License - feel free to use in your projects!

🙋 Support

🌟 Contributing

Contributions welcome! Please feel free to submit a Pull Request.


Built by Turtles AI Lab | Free & Open Source

About

Free web-based email parser that extracts support ticket information with AI-powered classification

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published