Agent Lesson 11: Forms

Agent Lesson 11: Forms

When you do the same kind of action repeatedly — request approval, escalate to vendor, document an incident — your admin can wire that up as a form. Fill it out once on a ticket and the right thing happens consistently.

Forms

Problem: Some actions on a ticket need the same information captured the same way every time — "request approval to spend over $500", "escalate to vendor", "send to manager for review", "document a security incident". Without a standard way to capture that info, agents free-text it into notes, approvers don't know where to look, and the trigger that should follow (sending an email, creating a sub-ticket, kicking off a workflow) doesn't happen.

Horizon's answer: Custom forms. Your admin defines a reusable form for each repeatable action — fields, validation, what triggers when it's submitted. You fill out the form in the context of a specific ticket. The data gets attached to the ticket, and if the form is wired to a workflow, that workflow fires.

Where forms come from

Forms are created by your admin in the Horizon admin panel. Each form has:

  • A name (e.g. "Request Manager Approval", "Vendor Escalation").
  • A set of fields. Field types include text, number, toggle (yes/no), dropdown, user picker, textarea, date, and datetime.
  • Optional validation rules per field.
  • Optionally: a workflow that fires when the form is submitted.

You don't create or modify forms — that's an admin task. You consume them.

Submit a form on a ticket

  1. Open the ticket in your helpdesk.
  2. In the Rocketship ticket widget, click Submit Custom Form.
  3. Pick the form you want to submit from the dropdown (if your account has multiple).
  4. Fill in the fields.
  5. Click submit.

If the form has a workflow attached, it fires immediately — and depending on what the workflow does, you may see a notification, a new todo, a reassignment, or nothing visible (if the workflow runs silently).

What gets recorded

Each submission is saved against the ticket. Anyone reviewing the ticket later can see:

  • Which form was submitted
  • Who submitted it
  • When
  • All the field values

This is the part that makes forms more useful than internal notes — the data is structured, queryable, and tied to a specific action.

When to use a form vs. a note

Use a form when...Use a note when...
The action is repeatable and standardizedIt's a one-off comment
Specific fields need to be captured every timeThe info is unstructured
Submitting should trigger something (email, workflow, escalation)You just want to leave a record
You need to query or report on these submissions laterThe audience is anyone reading the ticket

Common errors

  • "Form validation failed" — one or more fields didn't pass the validation rules your admin configured. The error message lists which field(s) — fix and resubmit.
  • "Missing form_id" — the form selection got lost. Refresh the page and try again.
  • "No forms configured" — your admin hasn't created any custom forms yet. If you think one should exist for an action you do regularly, ask them.

Tip: If you find yourself writing the same internal note over and over for the same kind of action — "FYI escalating to vendor X for reason Y", "approved by manager M" — that's a strong signal a form should exist for that action. Bring it up with your admin. Replacing five free-text notes per week with a one-click form pays for itself fast.

    • Related Articles

    • Agent Lesson 1: Welcome to Horizon

      First lesson in the agent series. By the end you'll know how to find help when you need it and how to access Horizon — including the per-helpdesk widget setup so Horizon shows up inside ConnectWise, Autotask, and the others. Getting Help Problem: ...
    • Agent Lesson 10: Watchlists

      Some of your tickets are quietly counting down to an SLA breach. Watchlists surface those automatically — color-coded by urgency — so you can spot what's at risk before it bites. Watchlists Problem: You have 22 tickets assigned. Some have SLA ...
    • Agent Lesson 9: How Work Gets to You

      Tickets reach your tray three ways: someone direct-assigns them to you, the system dispatches/escalates them automatically (or via a dispatcher), or you pull them from a ticket queue. This lesson covers all three so you understand where your work ...
    • Agent Lesson 4: Managing Your Availability

      When you can't take new work — lunch, a meeting, sick day — mark yourself Out so dispatch stops routing tickets to you. One toggle, one click. This lesson covers how to use it and what "Out" actually changes. The In/Out Feature Problem: You're at ...
    • Agent Lesson 5: Working with Floating Todos

      Floating todos don't have a fixed start time — the scheduler fits them into your day dynamically. Two skills make floating work work for you: setting rank to tell the scheduler what matters, and deferring to push work back without losing track of it. ...