Alerts
Set up alerts that automatically email the right people when a work order is created or updated and your conditions are met.
Overview
The Alerts page lets you set up automatic notifications. When something happens to a work order and your conditions are met, TPTM emails the people you choose — a trade partner, a project manager, or any email address you enter. Use alerts so nobody has to remember to send an update by hand. Alerts are managed by builder admins under Settings.
Getting to the Alerts page
Open Settings from the sidebar navigation.
Click Alerts.
The table lists every alert with its Name and Trigger. Click a row to open and edit that alert.
How an alert is built
Every alert has three parts, shown top to bottom in the alert form:
When the following happens — the trigger. This is the event that starts the alert.
If all of these filters match — optional conditions. If you add filters, every one of them must match for the alert to do anything. With no filters, the alert always runs.
Then perform these actions — what happens when the alert runs. Today the action is sending an email.
How to create an alert
On the Alerts page, click Create.
Optional: pick a ready-made alert from Start from template at the top of the form. The template fills in the name, trigger, filters, and email for you, and you can change any of it.
Enter an Alert name.
Under When, choose a trigger from Select a trigger.
Under If, click Add a filter for each condition you want, then fill in its value.
Under Then, click Add an action and choose Send an email to. Add the recipients, then enter a Subject and a Message. Type @ or use Insert variable to drop work order details into the text.
Click Save. The new alert appears in the table.
How to edit or delete an alert
On the Alerts page, click the alert's row. The form opens with its current settings.
Change anything you need and click Save.
To delete the alert instead, click Delete at the top of the form, then click Delete again in the Delete Alert confirmation.
Supported triggers, filters, and actions
Today there is one trigger. More will be added over time.
Trigger: Work order created or updated
Filters you can add to it:
The work order was — created, updated, or both.
There is a back charge trade — Yes or No.
The changed Not to Exceed amount is greater than — a dollar amount.
The status was changed to — one or more work order statuses.
Action: Send an email to — one or more recipients, each emailed separately.
Frequently Asked Questions
Which alert templates are available?
Which alert templates are available?
When you create an alert, the Start from template menu offers these ready-made work order alerts. Pick one and then adjust anything you like before saving.
Email back charge trade of new work order
Email notification for updated work orders
Email trade partner of new work order
Over $500 WO email alert
WO can be paid email
How are alerts different from Work order changes on the Notifications page?
How are alerts different from Work order changes on the Notifications page?
They are separate. An alert is an email you write yourself, with your own filters, subject and message. Work order changes under Settings → Notifications sends a ready-made email listing exactly what changed — Not to Exceed, status, pay date, back charge or custom fields — with the before and after values, and you tick which kinds of change each person hears about. Both keep working side by side, so if an alert and Work order changes cover the same change, the person gets both emails — unless they made the change themselves. Work order changes never emails the person who made the change, but an alert still emails everyone it is set up to email, including them. See Work Order Change Emails.
Who can an alert email?
Who can an alert email?
In the Send an email to field you can mix two kinds of recipients, in any order:
People connected to the work order — Assigned Trade Partner, Backcharge Trade Partner, or Project Manager. When the alert runs, TPTM looks up who that is for the specific work order and emails them. A trade partner with more than one contact email receives it at each address.
Any email address you type in, which is emailed exactly as written.
Each recipient gets their own separate email.
How do I put work order details into the subject or message?
How do I put work order details into the subject or message?
In the Subject or Message box, type @ or click Insert variable and pick a value: action, back charge trade partner, builder brand, Not to Exceed, number, status, or trade partner. When the email is sent, TPTM replaces the variable with the real value from the work order — for example @number becomes the work order number, and @max_price becomes a dollar amount such as $4,500.00.
Why did the "@" disappear from my email?
Why did the "@" disappear from my email?
Every @ in an alert subject or message is treated as a variable. If the word after it is not one of the variables offered by Insert variable, the @ is dropped and the plain word is sent — "hello @world" arrives as "hello world". Only use @ for variables you insert from the menu.
What happens if the work order has no project manager or back charge trade partner?
What happens if the work order has no project manager or back charge trade partner?
Those two are optional on a work order. If your recipient list names one of them and the work order does not have that person, that recipient is simply skipped and the email still goes to everyone else on the list. If every recipient on the list is missing, no email is sent.
Why won't my alert save?
Why won't my alert save?
Check the form for a red message. An alert needs a name ("Please enter a name") and a trigger ("Select a trigger"). Every filter you added needs a value, and an email action needs a subject and a message. Each recipient must be a valid email address or one of the people options (Assigned Trade Partner, Backcharge Trade Partner, Project Manager); otherwise you see "One or more emails is not valid."
Why can't I see the Create or Delete button?
Why can't I see the Create or Delete button?
Creating alerts needs the Alert: Create permission, and deleting them needs Alert: Delete. If a button is missing, your role does not include that permission — ask your administrator.
Why does the page say "Please use a larger screen"?
Why does the page say "Please use a larger screen"?
The alerts table and form need more room than a phone screen offers. Open the Alerts page on a tablet or computer to view and manage alerts.
Can I undo deleting an alert?
Can I undo deleting an alert?
No. Deleting an alert is permanent and it stops firing right away. If you may need it again later, note down its settings before you delete it, or leave it in place.
Was this helpful?
More in Builder Configuration
BuyersNotifications SettingsWork Order Custom FieldsEnd of the Day TextStill need help? Ask the team