{"versionId":"d1bae2b9-97a4-4c2b-73be-08df015ff374","articleId":"f1682ec0-9cf1-4b3f-fcf8-08de8ebcacf6","title":"Ticketing: setup guide for admins","tags":["AI","setup","ticketing","All articles"],"content":"<html><head></head><body><p>Helpfruit Ticketing helps your team manage customer support work in one place. You can receive support requests, send an automatic first reply, organise tickets by status and type, assign work to teammates, and respond from within Helpfruit.</p>\n<div class=\"mce-toc\">\n<h2>In this article...</h2>\n<ul>\n<li><a href=\"#overview\">What Ticketing does</a></li>\n<li><a href=\"#before-you-start\">Before you start</a></li>\n<li><a href=\"#setup\">Set up Ticketing</a>\n<ul>\n<li><a href=\"#mcetoc_1jouq4a22j2\">Enable Ticketing</a></li>\n<li><a href=\"#mcetoc_1jouq4a22j3\">Set up email</a></li>\n<li><a href=\"#mcetoc_1jouq4a22j4\">Review core ticket settings</a></li>\n</ul>\n</li>\n<li><a href=\"#ai-processing\">Set up AI processing</a>\n<ul>\n<li><a href=\"#mcetoc_1jouq4a22jd\">Enable AI processing</a></li>\n</ul>\n</li>\n<li><a href=\"#mcetoc_1jtuo0osfkg\">User roles</a>\n<ul>\n<li><a href=\"#mcetoc_1jtuo0osfkh\">When to use each role</a></li>\n</ul>\n</li>\n<li><a href=\"#mcetoc_1jtuo0osfki\">Roll out Ticketing</a>\n<ul>\n<li><a href=\"#mcetoc_1jtuo0osfkj\">Recommended minimum checks</a></li>\n</ul>\n</li>\n<li><a href=\"#mcetoc_1jtuo0osfkk\">Related articles</a></li>\n</ul>\n</div>\n<h2 id=\"overview\">What ticketing does</h2>\n<p>Ticketing gives your team a shared place to manage support requests. Ticketing includes:</p>\n<ul>\n<li>rapid setup for ticket types, statuses, priorities, and SLA policies — use the defaults or customise them to suit your organisation</li>\n<li>a ticketing email address for creating tickets by email</li>\n<li>multiple ticket views, including Board, Table, Agent, Inbox, and Calendar</li>\n<li>ticket assignment, comments, history, and customer records</li>\n<li>Helpfruit-powered automatic first replies and draft replies for later messages</li>\n<li>optional AI processing for analysing tickets and comments</li>\n</ul>\n<h2 id=\"before-you-start\">Before you start</h2>\n<p>Before setting up ticketing, make sure you:</p>\n<ul>\n<li>have admin access to the Helpfruit portal</li>\n<li>have a Standard or Premium Helpfruit plan</li>\n<li>know which team members should receive and manage tickets</li>\n</ul>\n<h2 id=\"setup\">Set up Ticketing</h2>\n<h3 id=\"mcetoc_1jouq4a22j2\">Enable Ticketing</h3>\n<ol>\n<li>In the Helpfruit portal, open <strong>Configuration &gt; Ticketing</strong>.</li>\n<li>Turn on <strong>Enable ticketing system</strong>.</li>\n<li>If prompted, select <strong>Create default Ticketing setup</strong> to create the default ticket types, statuses, and priorities.</li>\n</ol>\n<p>This gives you a starting configuration that you can customise later.</p>\n<h3 id=\"mcetoc_1jouq4a22j3\">Set up email</h3>\n<p>Your Ticketing configuration includes a unique ticketing email address. Customers or staff can use this address to create support tickets by email.</p>\n<ol>\n<li>Go to the <strong>Email setup</strong> section.</li>\n<li>Copy your ticketing email address.</li>\n<li>Optional: enter an <strong>Organisation name for emails</strong>.</li>\n<li>Select <strong>Save</strong>.</li>\n</ol>\n<p>The organisation name appears in outgoing ticket emails. If left blank, Helpfruit uses your company name.</p>\n<h4>Auto-forward emails to create tickets</h4>\n<p>After you set up and test Ticketing, you can set up auto-forwarding rules in your support inbox to route support emails to your ticketing address. This means you do not need to change your existing support email address to use Helpfruit Ticketing.</p>\n<h4>Custom email address</h4>\n<p>You can also set up a custom email address. Select <strong>Customise</strong> to set this up.</p>\n<div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_ticketing-get-started_1c79b6a6-75dc-4cad-a687-9543399116af.png\" alt=\"Ticketing email address in Helpfruit.\" width=\"800\"></div>\n<h3 id=\"mcetoc_1jouq4a22j4\">Review core ticket settings</h3>\n<p>From the Ticketing configuration screen, review and complete these sections:</p>\n<h4>Ticket types</h4>\n<p>Categories such as support question or bug report.</p>\n<h4>Default email ticket type</h4>\n<p>The default type for tickets created by email.</p>\n<h4>Ticket statuses</h4>\n<p>Workflow stages such as New, In Progress, Pending Customer, Resolved, and Closed.</p>\n<div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_ticketing-get-started_a34dabd5-0eb7-4c05-a1bf-8f9fd7520e45.png\" alt=\"Ticket status settings in Helpfruit.\" width=\"600\"></div>\n<ul>\n<li>Each status can have a colour and icon. You can also set it as a start or terminal status.</li>\n<li>You can specify allowed transitions — the statuses that this status can move to. This affects whether users can drag and drop cards in Board view.</li>\n</ul>\n<div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_ticketing-get-started_457a3a62-ed3d-41f1-bf18-c70a3a9b8298.png\" alt=\"Allowed ticket status transitions in Helpfruit.\" width=\"600\"></div>\n<h4>Ticket priorities</h4>\n<p>Urgency levels for triage and reporting.</p>\n<h4>SLA policies</h4>\n<p>Service targets for response and resolution.</p>\n<p>All of these settings are configurable to suit your organisation.</p>\n<h2 id=\"ai-processing\">Set up AI processing</h2>\n<p>Ticketing includes an AI processing option. Access it from <strong>Configuration &gt; Ticketing</strong>.</p>\n<p>When AI processing is enabled, AI can analyse new tickets and comments and change these fields:</p>\n<ul>\n<li>status</li>\n<li>priority</li>\n<li>type</li>\n<li>assignee</li>\n</ul>\n<p>You can use the default prompt or customise it to suit your workflow.</p>\n<div><img src=\"https://storage.faqbot.nz/prod/079d861d72cc4aca80c65588df217079/files/pasted_image_article_ticketing-get-started_7bc6fe72-1c97-49fb-93a2-f1d91a98b07d.png\" alt=\"AI processing configuration in Helpfruit Ticketing.\" width=\"800\"></div>\n<h3 id=\"mcetoc_1jouq4a22jd\">Enable AI processing</h3>\n<ol>\n<li>Go to <a title=\"Ticketing configuration\" href=\"https://portal.helpfruit.com/configuration/ticketing\" target=\"_blank\" rel=\"noopener\"><strong>Configuration &gt; Ticketing</strong></a>.</li>\n<li>Open <strong>AI processing configuration</strong>.</li>\n<li>Turn on <strong>Enable AI processing</strong>.</li>\n<li>Enter or review the <strong>Processing prompt</strong>.</li>\n<li>Select <strong>Validate prompt</strong>.</li>\n<li>Select <strong>Save configuration</strong>.</li>\n</ol>\n<p>You can also select <strong>Use default prompt</strong> to start from the default AI instructions.</p>\n<p><strong>Important:</strong> Review AI-generated changes before relying on them in live workflows.</p>\n<h2 id=\"mcetoc_1jtuo0osfkg\">User roles</h2>\n<p>Use roles to control who can configure Ticketing and who can work on tickets.</p>\n<div>\n<table style=\"width: 739.650696px; border-collapse: collapse;\">\n<thead>\n<tr>\n<th style=\"border: 1px solid grey; text-align: left; vertical-align: top; padding: 2px;\">Role</th>\n<th style=\"border: 1px solid grey; text-align: left; vertical-align: top; padding: 2px;\">Access</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td style=\"border: 1px solid grey; text-align: left; vertical-align: top; padding: 2px;\">Admin</td>\n<td style=\"border: 1px solid grey; text-align: left; vertical-align: top; padding: 2px;\">Can manage Ticketing configuration and tickets.</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid grey; text-align: left; vertical-align: top; padding: 2px;\">Agent Admin</td>\n<td style=\"border: 1px solid grey; text-align: left; vertical-align: top; padding: 2px;\">Can manage Ticketing configuration and tickets. This is a combined <a href=\"https://help.helpfruit.com/article/live-chat\" target=\"_blank\" rel=\"noopener\">live chat</a> and Ticketing administrator role.</td>\n</tr>\n<tr>\n<td style=\"border: 1px solid grey; text-align: left; vertical-align: top; padding: 2px;\">Ticket Agent</td>\n<td style=\"border: 1px solid grey; text-align: left; vertical-align: top; padding: 2px;\">Can view and edit tickets.</td>\n</tr>\n</tbody>\n</table>\n</div>\n<h3 id=\"mcetoc_1jtuo0osfkh\">When to use each role</h3>\n<ul>\n<li>Use <strong>Admin</strong> for platform or product administrators.</li>\n<li>Use <strong>Agent Admin</strong> for people who manage Ticketing.</li>\n<li>Use <strong>Ticket Agent</strong> for team members who handle tickets but do not need to change Ticketing configuration.</li>\n</ul>\n<h2 id=\"mcetoc_1jtuo0osfki\">Roll out Ticketing</h2>\n<p>After you finish the initial set-up, test your configuration before rolling it out more widely.</p>\n<h3 id=\"mcetoc_1jtuo0osfkj\">Recommended minimum checks</h3>\n<ul>\n<li>create a test ticket by email, including formatted content such as links, headings, or lists, and confirm the content appears correctly in Ticketing</li>\n<li>create a test ticket directly in Ticketing</li>\n<li>create a test ticket from a live chat conversation, if your team uses live chat</li>\n<li>confirm the default email ticket type is correct</li>\n<li>check that statuses and allowed transitions match your workflow</li>\n<li>close a test ticket, reply to its ticket email address, and confirm the ticket reopens as expected</li>\n<li>confirm the right team members can view and manage tickets</li>\n<li>test AI processing with a safe prompt before using it in production</li>\n</ul>\n<h2 id=\"mcetoc_1jtuo0osfkk\">Related articles</h2>\n<p><a href=\"https://help.helpfruit.com/article/ticketing-user-guide\" target=\"_blank\" rel=\"noopener\">Ticketing: user guide</a></p>\n<p><a href=\"https://help.helpfruit.com/article/user-management\" target=\"_blank\" rel=\"noopener\">User management</a></p></body></html>","description":"Learn how to enable and configure Ticketing in Helpfruit, set up workflows and email, manage roles, and prepare your team to support customers with ticketing.","isMarkdown":false,"publishedOnUtc":"2026-08-24T02:14:14.9464427","modifiedOnUtc":"2026-03-31T03:23:44.8067395"}