← How StayCharted works

GUIDE · MAINTENANCE · CMMS

Categorize maintenance work orders with AI, the way your team already does

Every work order starts as a few words from whoever found the problem: "pump 3 leaking at the seal again", "conveyor making a grinding noise", "light out in bay 7". Someone then decides what kind of problem it is, how urgent, and which team gets it. When that someone is busy, categories get skipped, everything is "general", and your failure history stops telling you anything.

Your past work orders already hold those decisions. This guide turns them into an AI model that categorizes each new work order the same way, and leaves the unsure ones to a person. The worked example connects it to MaintainX through Zapier; the same model works with any CMMS through StayCharted's API, or a spreadsheet of work orders at a time.

About 7 minutes to read.

Train your work order model ↓

By StayCharted ·

What you can categorize

Question Example answers Learns from
Problem type Leak · Electrical · Mechanical wear · Lubrication · Safety · Cosmetic Past work orders and the category your team gave them
Priority Emergency · High · Normal · Low The priority each one was finally given
Team or craft Mechanical · Electrical · HVAC · Facilities · Contractor Who actually completed the work
Asset class Pumps · Conveyors · HVAC · Lighting · Doors The asset each work order was raised against

Two at once: one model can answer several parts together, for example problem type and team, because StayCharted models can give an answer with several parts. Several tags: if one work order can carry more than one category, a model with a list answer returns all that apply.

Start with whichever question your team answers most often, or gets most wrong.

Before you start

  • StayCharted: an Essentials or Business workspace, which includes the API that Zapier uses. Training works on every plan, Free included, so you can check the model's report before paying for anything.
  • An API key: in StayCharted, Settings → API keys → Create key.
  • Past work orders, exported as a spreadsheet: the description (and title, if you use one) plus the category you want the model to learn. A few hundred is a good start; aim for at least 20 to 50 per category, more for categories that look alike.
  • For the MaintainX part: MaintainX's Zapier integration is on its Premium and Enterprise plans and is set up by an Administrator. On the Zapier side, a Zap with more than two steps needs a paid Zapier plan.

Use 20–50 examples per category as a pilot starting point, not an accuracy guarantee. Validate on work orders the model did not train on before automating decisions.

Part 1: Train the model

  1. Clean the export a little. Keep the columns a person would read to decide: title and description, maybe the location. Drop the answer's give-aways: don't include the assignee as an input when you're teaching the team, or the asset ID when you're teaching the asset class.
  2. Upload it in StayCharted (New model → upload a file), choose the description columns as what the model reads, and the category column as the answer.
  3. Let StayCharted check the data. It flags rows that look like they belong in another category, the same text under two categories, and near-duplicates. "General" or "Other" used as a catch-all is the usual culprit: decide whether it's a real category or rows that need a proper one.
  4. Train the AI Classifier Model first. It reads meaning, not just words, which can help it recognize related descriptions such as "seal weeping" and "leak at the gland". Check that in your test results.
  5. Read the report per category. Look at how often it's right for each category, not only overall, and at the examples it got wrong. Those are often work orders your own team would argue about.
  6. Publish the model when you're happy with it.

Part 2: Connect it to MaintainX through Zapier

Add the StayCharted app in Zapier first (search for StayCharted in the Zap editor; see the Zapier guide for connecting your API key). Then build this Zap:

  1. Trigger: MaintainX → New work order. Test it to pull in a sample work order.
  2. Action: StayCharted → Classify Record. Choose your model. Its fields appear below: map the work order's title and description (whichever fields the model was trained on) from step 1. Test the step: you'll see the model's Answer, its Confidence and Needs Review.
  3. Filter by Zapier: only continue if Needs Review is false. That way only answers above your model’s review cutoff are written back. Confidence is not a guarantee; sample automatic results too.
  4. Action: MaintainX → Add Existing Categories to a Work Order. Map the work order ID from step 1, and map the Answer from step 2 to the corresponding existing category. If the action requires a category ID, use a lookup table to translate each label to its ID. Test with a sample work order before enabling the Zap.
  5. Publish the Zap.

Keep your model’s answers aligned with your MaintainX categories. Check every label and its mapped category or ID. Start with Create Work Order Comment if you haven’t yet verified category mapping; it displays the suggestion without changing the category.

For the unsure ones, use Paths instead of the Filter: one path adds the category, the other uses MaintainX → Create Work Order Comment with something like "StayCharted suggests Leak (64% sure): please check the category." The same answers also wait in StayCharted's Review Queue, where a correction becomes a training example for the next version. Pick one place to review.

Priority or team instead of category? MaintainX’s Update Work Order action includes Priority and Team IDs. Map the model’s answers to the accepted values or IDs and test the update first. For fields the action does not expose, use a custom API request. Or start with a comment to put the suggestion in front of the person who triages.

Part 3: Other CMMS and EAM systems

The model doesn't care where the work order comes from:

  • Any system that can call an API: send the work order's text to POST /api/v1/models/{id}/classify and write the answer back. See Developers.
  • Power Automate: StayCharted's certified connector works the same way as the Zapier action, for systems already connected to Microsoft 365.
  • A spreadsheet at a time: export last week's work orders, fill them in StayCharted, and import the categories back. Good for cleaning up a backlog of uncategorized history before you automate anything.

What it doesn't do

  • It doesn't read photos in Zapier yet. The Classify Record action takes text. Photo models work through the API, files and AI assistants. See condition-based monitoring from photos.
  • It doesn't diagnose. It categorizes the way your team did. A new failure mode needs examples before the model knows it.
  • It doesn't learn from the Zap. Corrections made in MaintainX reach the model when you retrain on a fresh export, or through the Review Queue, whose corrections go into the next version.
  • It doesn't replace triage for emergencies. Keep your safety rules as rules.

If something goes wrong

You see What to do
"Fill at least one of the fields the model was trained on." Map the work order's text into the model's fields in step 2.
The category isn't added in MaintainX Check the model's answer matches an existing MaintainX category exactly, including capitals.
Most answers need review The model needs more examples of the categories it's unsure about, or two categories overlap. Check the report's per-category results.
A "plan" or "limit" message The API is on Essentials and Business, and each answer counts toward your workspace's monthly allowance.

MaintainX and Zapier references

Put it into practice

Common questions

Can AI categorize maintenance work orders?

Yes. A model trained on your past work orders and the categories your team gave them categorizes new ones the same way, with a confidence, and leaves the unsure ones to a person.

How many past work orders do I need?

A few hundred to start: at least 20 to 50 per category, more for categories that look alike.

Does it work with MaintainX?

Through Zapier, on MaintainX's Premium and Enterprise plans: a new work order is sent to your model, and the answer is added as a category or a comment.

Does it work with other CMMS or EAM systems?

Through StayCharted's API or Power Automate connector, or a spreadsheet at a time. There are no built-in connectors to specific CMMS or EAM products.

Can it set failure codes?

If your team records failure codes, yes: train on past work orders with their failure code as the category. A two-part answer can give problem and cause together.

Does our data train anyone else's model?

No. Your work orders train only your workspace's models.

MaintainX is a trademark of MaintainX, Inc. Zapier is a trademark of Zapier, Inc. StayCharted is not affiliated with MaintainX or Zapier.

STAYCHARTED AI MODEL TRAINER

Train AI to categorize the way your team does.

Start with examples you already have, see how often it’s right on items it never saw, and use confidence to prioritize the ones a person should review.

Start free