JIRA Integration

Connect your AI SmartTalk assistant with Atlassian JIRA to enable intelligent project management and issue tracking capabilities. This integration allows your AI assistant to search, create, update issues, log time, and manage sprints directly through natural language interactions.

Overview

The JIRA integration enables your AI assistant to:

• Search Issues: Find issues using natural language queries
• View Issue Details: Get comprehensive information about specific issues
• Create Issues: Generate new tickets, tasks, or bugs automatically
• Update Issues: Modify issue status, priority, assignee, and other fields
• Time Tracking: Log work time with detailed comments and descriptions
• Sprint Management: List boards, sprints, and manage sprint planning
• Project Management: Access project information and team collaboration data

Prerequisites

Before you begin, ensure you have:

• An active AI SmartTalk account with assistant configuration access
• A JIRA Cloud or Server instance with administrator privileges
• API access enabled in your JIRA instance
• User account credentials with appropriate project permissions

Step-by-Step Setup

Step 1: Access JIRA Integration

1. Log into your AI SmartTalk account
2. Navigate to Administration → My Assistants → [Your Assistant Name]
3. Click on Connectors in the left sidebar
4. Locate JIRA in the available connectors list
5. Click on the JIRA integration tile

Step 2: Configure JIRA Connection

1. JIRA URL: Enter your JIRA instance URL (e.g., https://yourcompany.atlassian.net)
2. Username/Email: Provide your JIRA account email address
3. API Token: Generate and enter your JIRA API token
   • Go to your Atlassian account settings
   • Navigate to Security → Create and manage API tokens
   • Generate a new token for AI SmartTalk integration
4. Click Configure to establish the connection

Step 3: Enable AI Capabilities

Configure the AI capabilities you want to enable:

Issue Management (4/4)

• ✅ JIRA_SEARCH_ISSUES: Search and filter issues using natural language
• ✅ JIRA_GET_ISSUE: Retrieve detailed information about specific issues
• ✅ JIRA_CREATE_ISSUE: Create new issues, tasks, and bugs
• ✅ JIRA_UPDATE_ISSUE: Modify existing issues and their properties

Time Tracking (1/1)

• ✅ JIRA_LOG_TIME: Log work time with comments and descriptions

Sprint Management (2/2)

• ✅ JIRA_LIST_BOARDS_AND_SPRINTS: View available boards and active sprints
• ✅ JIRA_CREATE_SPRINT: Create new sprints and manage sprint planning

Step 4: Project Synchronization

1. Click Sync Projects to fetch your JIRA projects
2. Select the projects you want your AI assistant to access
3. Configure project-specific permissions and access levels
4. Wait for the initial synchronization to complete

AI Assistant Capabilities

Issue Search and Management

Your AI assistant can handle natural language queries like:

Search Examples:

• "Find all issues related to cookies"
• "Show me high priority bugs assigned to John"
• "List all tasks in the current sprint"
• "What are the open issues for the CCS project?"

Issue Details:

User: "Tell me about issue CCS-11"
AI: Here are the details for CCS-11:
- Title: Prepare chocolate cookies with detailed content
- Status: To Do
- Priority: Low
- Assignee: Not assigned
- Description: [Full issue description]

Issue Creation

Create issues through conversational commands:

Creation Examples:

• "Create a bug report for the login issue"
• "Add a task to implement user authentication"
• "Create a story for the new dashboard feature"

Time Logging

Log work time with natural language:

Time Tracking Examples:

User: "@PO Bot I confirm that the cookies are in the oven for CCS-11, and I log 2 hours of thermostat 200"

AI Response:
✅ Time successfully logged for CCS-11:
- Time Spent: 2 hours
- Comment: Cookies in oven at 200°C thermostat
- Start Date: November 14, 2025, 12:00 PM

Sprint Management

Manage sprints and boards conversationally:

Sprint Examples:

• "What's in our current sprint?"
• "Create a new sprint for next week"
• "Show me all available boards"
• "Move CCS-11 to the active sprint"

Supported JIRA Features

Issue Types

Type	Supported	AI Capabilities
Epic	✅	Create, update, link child issues
Story	✅	Full CRUD operations, story point estimation
Task	✅	Complete task management and tracking
Bug	✅	Bug reporting, severity assignment, resolution tracking
Subtask	✅	Subtask creation and parent issue linking

Fields and Properties

Field	Read	Write	AI Understanding
Summary	✅	✅	Natural language processing
Description	✅	✅	Rich text and formatting support
Status	✅	✅	Workflow state management
Priority	✅	✅	Smart priority assignment
Assignee	✅	✅	Team member recognition
Reporter	✅	✅	Automatic user mapping
Labels	✅	✅	Intelligent label suggestions
Components	✅	✅	Component-based organization
Fix Version	✅	✅	Release planning integration

Troubleshooting

Common Issues

Connection Problems

• Authentication Failed:
  • Verify JIRA URL format (include https://)
  • Check API token validity
  • Ensure account has proper permissions
• Network Timeout:
  • Verify JIRA instance accessibility
  • Check firewall settings
  • Test connection from AI SmartTalk servers

Permission Errors

• Insufficient Permissions:
  • Review JIRA project permissions for your account
  • Check browse project and create issue permissions
  • Verify admin access for project configuration
• Project Access Denied:
  • Ensure user is added to target projects
  • Check project visibility settings
  • Validate project key spelling

Sync Issues

• Projects Not Loading:
  • Refresh project synchronization
  • Check JIRA instance performance
  • Verify API rate limits
• Issue Updates Failing:
  • Check issue workflow permissions
  • Verify field requirements and validation rules
  • Ensure issue is in editable state

Performance Optimization

API Rate Limits

• Monitor Usage: Track API calls and rate limits
• Batch Operations: Group multiple operations when possible
• Caching Strategy: Implement intelligent caching for frequently accessed data

Large Instance Handling

• Project Filtering: Sync only relevant projects
• Issue Pagination: Handle large result sets efficiently
• Selective Sync: Choose specific issue types and statuses

Best Practices

Project Organization

• Clear Naming: Use descriptive project and issue names
• Consistent Labeling: Maintain consistent label taxonomy
• Regular Cleanup: Archive completed projects and issues

Use Cases and Examples

Daily Standup Automation

Team Member: "Show me what I worked on yesterday and what's planned for today"
AI: "Yesterday you completed CCS-9 (2 hours logged) and CCS-10 (1.5 hours). 
Today you have CCS-11 and CCS-12 assigned in the current sprint."

Sprint Planning

Scrum Master: "Create a new sprint starting Monday for 2 weeks"
AI: "✅ Created new sprint 'Sprint 24' starting November 18, 2025 for 2 weeks. 
Ready to add issues from the backlog."

Bug Reporting

QA Tester: "Create a bug: Login form doesn't validate email format properly, high priority"
AI: "✅ Created bug CCS-15: 'Login form email validation issue'
- Priority: High
- Assigned to: Development Team
- Added to current sprint for immediate attention"

Progress Tracking

Product Owner: "How are we doing on the cookie preparation project?"
AI: "Cookie project (CCS) status:
- 5 issues completed (CCS-1 to CCS-5)
- 3 in progress (CCS-7, CCS-9, CCS-11)  
- 2 to do (CCS-12, CCS-13)
- Sprint completion: 67% on track"