ThreadWare User Guide

Support Desk

Where you ask for help when something in ThreadWare is not working, or you cannot do something you should be able to. Everybody can log a ticket - no special permission needed.

You only see what you have been given access to

ThreadWare is built from modules - Sales, Production, Quality and so on. An administrator gives you a role in each module, for each company you work in. The menu is built from those roles. So if something in this guide is not in your menu, it has not been given to you yet. Ask your administrator, or log a support ticket.

Logging and following your own ticket is the exception. Every approved user can do it without being granted anything - it would defeat the point to need permission before you can ask for help.

Can I use it?

WhoWhat you can do
Any approved user Log a ticket and follow your own tickets.
Support Viewer Read tickets in the queues you are assigned to.
Support Agent Work tickets in your queues - reply, take them, change the status.
Support Supervisor Every queue in the company: reassign, merge, reopen, and run reports.
Support Admin Set up statuses, priorities, categories, queues, SLA policies and the mail channel.

Logging a ticket

Two ways in:

Log it from the screen where it went wrong

ThreadWare quietly attaches which screen you were on, your app version and your browser to the ticket. That saves you describing it and saves the agent asking. So raise the ticket from the page with the problem rather than going home first.

Writing a ticket that gets fixed quickly

  1. What you were trying to do - "capture a scoresheet for order 12345".
  2. What happened instead - the exact message if there was one. Copy the wording; do not paraphrase it.
  3. When - roughly what time, and whether it happens every time.
  4. Attach a screenshot if you can. One picture usually saves a day. If you email the desk instead, pasting the screenshot straight into the message works just as well as attaching it.

Choose the category and priority honestly. Marking everything urgent is how genuinely urgent things get missed.

If none of the categories fits, choose Other. A box appears underneath asking Which category is it? - type a few words, such as "Printer toner". The ticket cannot be sent with Other chosen and that box empty, because "Other" on its own tells the desk nothing.

If you cannot sign in

The ? button on the sign-in page opens an anonymous ticket form. Being locked out is exactly when you need the desk most, so it does not require a login. You get a reference you can use to check progress.

Following your ticket

Menu ▸ Support Desk ▸ My Support Tickets

Open a ticket to read replies and add more information. If an agent asks a question, answering it quickly is the single biggest thing you can do to speed the fix up.

If you are a Support Desk agent, the tickets assigned to you are listed here too, marked Assigned to you, and open in the agent workspace so you can work them. Only tickets in queues you can see are listed. On a ticket assigned to you, Waiting on me means it is waiting on the person who logged it (or on a third party), not on you.

You can also ask the AI Assistant "show me my open tickets" - your own tickets need no special role.

You can simply reply to the email. Every notification the desk sends you can be answered like any other message, and your reply lands on the ticket it came from - you do not have to sign in to keep a conversation going. Reply to the notification itself rather than starting a fresh message, so it attaches to the right ticket. (This depends on your organisation having set reply-by-email up. If your replies do not appear on the ticket, tell your administrator - collecting a mailbox and telling people which address to reply to are two separate settings, and the Inbound Mail Triage page shows them side by side.)

Every reply carries the conversation so far. Underneath the new message, below a line reading Earlier on this ticket, is what was reported and everything said since, oldest first - so you can read the whole exchange without signing in or hunting through old emails. On a very long ticket only the most recent messages are included and a line says how many were left out. Type your answer above that line; anything below it is treated as quoted history and is not added to the ticket twice.

Every email also carries a Track this ticket here link that needs no sign-in. It shows the ticket's status and the same full conversation, starting with the request you sent, and stays valid for as long as the ticket is open.

Working the desk

These pages need a Support Desk role.

PageWhat it is for
Support Queue Tickets in the queues you belong to. Take one, reply, change its status. Pictures on a ticket - including ones pasted into an email - show as previews; click one to see it full size.
Support Hours When the desk is open, which is what the SLA clock counts against.
Knowledge Base Written answers to things that come up repeatedly. Check here before answering from scratch, and add to it when you solve something new.

Agents see the queues they are a member of. Supervisors see every queue in the company and can reassign, merge duplicates and reopen closed tickets.

To look at one person's tickets, pick them in the Agent box on the Support Queue. The list then shows only the tickets assigned to that person, and the Open, Pending, Resolved, Closed and All buttons count only theirs - click through them to see how much they have open, waiting and finished. Export to Excel exports the same tickets and names the person at the top of the sheet. The box lists everyone with at least one ticket in what you are looking at, and the number beside each name is how many tickets you will see if you pick them. Picking someone switches off Assigned to me and Unassigned, and switching either of those on clears the Agent box. You only ever count tickets you can see: an agent's view covers their own queues, a supervisor's the whole company.

Overdue emails go to the assigned agent only. When a ticket misses its first-response or resolution target, the agent it is assigned to is emailed once for each - nobody else. A ticket with nobody assigned goes to the Support Supervisors and Support Admins instead, so someone can allocate it.

You are told when somebody answers on a ticket you hold. When the person who logged it replies - in the app, by email, or by reopening it with a reason - the agent it is assigned to gets an email and a notification in the bell menu. The email carries the whole conversation underneath the new message, so you can pick the ticket up from your phone. A ticket nobody is assigned to notifies its queue instead.

An internal note tells the agent who holds the ticket. Notes are how one agent hands another what they have found out, so the assigned agent is emailed and notified when somebody else leaves one - including when an administrator files a stray email onto their ticket as a note. You are never notified about your own note, the requester is never told about any note, and a ticket with nobody assigned notifies nobody.

The internal-note email says Internal note in its subject line, and replying to that email adds another internal note rather than a message to the requester. Replying to any other notification about the ticket answers the requester, as it always has - so check which email you are answering before you type.

Picking Other in the Category box under Properties does not save straight away. A Which category is it? box appears underneath: type what the category actually is and press Enter or the tick to save both together. Every other category saves the moment you pick it, and moving a ticket off Other clears the text.

Picking Resolved in the Status box under Properties does not save straight away either. A box asks for the resolution summary - what was wrong and what fixed it - and the ticket moves to Resolved when you click Save. Cancel leaves the status as it was. If the ticket was resolved before and has been reopened, the earlier summary is filled in for you to update. You can also resolve while replying: pick Resolved under Set status on send and fill in the summary box that appears.

A ticket filed under the wrong company is moved, not logged again: open it and pick the right company in the Company box under Properties. You can only move it to a company you hold a Support Desk role in, and you are asked to confirm, because the ticket then belongs to that company's support team and may leave your own queues. The site is cleared, the queue is re-routed if it belonged to the old company, the SLA targets are recalculated for the new company, and the move is recorded in the ticket's history.

If you can work a ticket you can also delete it: the bin icon at the end of its row on the Support Queue, or Delete ticket under Actions when you have it open. You are asked to confirm first. The ticket leaves the queue and the requester's list and its SLA reminders stop; the requester is not told. Nothing is erased: a Support Admin can see every deleted ticket, and restore it, under Administration → Support Desk → Deleted Tickets. Keep deleting for tickets that should never have been logged. For junk mail use Discard as spam instead, which also blocks the sender.

Searching all tickets with the AI Assistant needs a Support Desk role and membership of the queue the ticket is in. Your own tickets are always available to you.

Administrator setup

Support Admins configure the desk under Administration → Support Desk: Settings, Statuses, Priorities, Categories, Queues & Agents, SLA Policies, Work Types, Canned Responses, Inbound Mail Triage, Outbound Mail and Deleted Tickets. You do not need to be a system administrator to see this - holding Support Admin is enough, and the Administration menu then shows you only the Support Desk section. The day-to-day screens stay in the Support Desk menu.

Deleted Tickets is the other side of the Delete button: every ticket taken off the desk, when, and by whom. The counts at the top include how much logged time is sitting on deleted tickets - time the Support Hours report no longer shows. Restore puts a ticket back on the queue exactly as it was and adds an internal note saying who deleted and restored it. The requester is not told, its SLA dates are unchanged (so it may come back overdue), and a ticket discarded as spam keeps its sender blocked from the anonymous form until the 30 days run out.

Settings holds four things you can change yourself, which take effect immediately:

The mail pages are worth knowing about: tickets can arrive by email as well as through the form, and replies can go back out by email, so somebody who never opens ThreadWare can still be supported.

Email into the desk is off until it is switched on, and it is off on a new installation. Once it is on, ThreadWare collects a mailbox on your own mail server every few seconds, turns what it finds into tickets, and removes each message from the server once it has been safely filed - so the folder empties itself. A copy of every message is kept inside ThreadWare for 30 days first, so nothing is lost if something is handled wrongly.

The top of Inbound Mail Triage shows whether mail is actually being collected, from which server and folder, when it last looked and - when something is wrong - what the mail server said. If it is not running, the card names the reason. Switching it on is a server task: see THREADWAREV4_INSTALLATION_MANUAL.md section 7. Which queue a message lands in is set in the app, on the queue's Inbound mailbox field.

Three behaviours to know: mail from an address with no ThreadWare account becomes a ticket like any other (only the Turn incoming email into a ticket automatically setting above holds it on Inbound Mail Triage instead); when you do raise a ticket from a held message with Create ticket, the dialog asks you to choose the company it belongs to and will not pre-select one for you if you work in more than one - pick it deliberately, because that is where the ticket lands; and inbound mail is stored as plain text, so an HTML message keeps its words and line breaks but not its layout. Pictures are kept: a screenshot pasted into an email, a photo sent from a phone and an ordinary attachment all land on the ticket as files. Pictures emailed before 10 September 2026 can be pulled back from the emails the desk has kept (30 days by default) with Recover missing attachments at the top of Inbound Mail Triage.

When something looks wrong

What you seeWhat it means
Support Desk is not in your menu at all Your account has not been approved yet. Even the log-a-ticket item needs an approved account - use the anonymous form from the sign-in page instead.
You can log tickets but cannot see the queue Correct. The queue needs a Support Desk role.
You are an agent but a queue is missing You are not a member of it. A supervisor adds you under Queues & Agents.
No reply on a ticket Check Support Hours - the clock only runs while the desk is open.
You cannot reopen a closed ticket Reopening needs Supervisor. Reply on it and ask.