Lead, then a visit, then a customer
Every new lead goes the same way: Lead → Lead visit → Customer. A lead visit is a stop on one technician's day at the lead's address, with an optional arrival window or start time. It can be a Walkthrough (look at the pool, then quote) or a First service or job (do the work on that visit). Visits are booked by the office (Schedule visit on the lead), by a lead provider that sends a booked time through the Leads API, or by your AI Front Desk. Whether those last two book on their own or wait for approval is set on Settings → Lead Booking.
Lead visits replace the old Schedule Quote Walkthrough page and the AI Scheduling Proposals list. Everything about a lead's visits (requests waiting for approval, upcoming visits, past visits and how they went) is now on one Visits card on the lead's page.
Schedule a visit from the web
Open the lead and click Schedule visit at the top right (also in each row's ⋮ menu on the Leads table, and on the Visits card when nothing is booked). It needs the "Manage website leads" permission. The lead's address must be on the map first: if it isn't, the dialog says so and you correct the address in the Route Fit card on the same page.
- 1Technician and day: up to three ranked technician-days over the next two weeks, the one that adds the least driving first (marked Least driving). Each shows the date, the technician, why (for example "Nathan is working nearby (adds 2 mi)"), when the day would end, and the added miles. They respect each technician's time off, the stops their day really has and your Who takes lead visits setting. If no one has a clean opening, it says "No technician has a clean opening in the next two weeks."
- 2Or pick Pick any technician and date and choose a technician and a date yourself. The dialog checks that day for you: Fits with the added miles and when the day ends, or a warning (they are off that day, something else is booked then, past their hours, too many miles) that ends "You can still book it; the technician sees it on their day."
- 3Time: Any time that day (the default) or Set a time. With a time, pick the start and choose Arrival window (for example "Arrives 2:00–3:00 PM", the window length comes from Settings → Lead Booking) or Fixed start ("Starts at 2:00 PM").
- 4What the visit is for: Walkthrough ("Look at the pool, then quote") or First service or job ("Do the first service or the one-time job"). The default comes from Settings → Lead Booking.
- 5Click Schedule visit. The toast says "Visit scheduled: Thu, Dec 3, 2:00–3:00 PM · Nathan" and has Undo.
Booking puts the stop on that technician's route for the date and tells the technician. If they have no route on that weekday, one is made for the visit (and taken away again if the visit is canceled or moved and nothing else used it). The lead moves to Visit Scheduled (the Visit tab on the Leads page), its follow-up texts are re-planned around the date (the reminder the evening before, when lead follow-ups are on), the documents chosen on Settings → Lead Booking are sent to sign, and a confirmation goes to the lead if you turned one on there. Booking another visit adds a second one; it doesn't move the first.
On the route's day view the visit shows with the lead's name as its title, a LEAD VISIT badge and its arrival window. Its estimated time waits for the window to open, so a 1–2 PM visit never shows an 8 AM estimate.
The Visits card
The Visits card on the lead's page lists requests waiting for approval, upcoming visits, then past visits and older requests that were turned down or expired.
- Each visit shows the date, the time ("Any time", "2:00–3:00 PM" or "at 2:00 PM"), the technician, what it is for (Walkthrough or First service or job), who booked it (Booked by Office, Booked by Assistant, or the lead provider's name such as Booked by Rivermount) and, once the visit is over, its outcome.
- Reschedule on an upcoming visit opens Reschedule visit with its technician, date and time filled in; change them and click Move visit. The toast ("Visit moved to …") has Undo.
- Cancel visit takes it off the technician's day and tells them. The toast ("Visit on Thu, Dec 3 canceled") has Undo, which books it again. When no other visit is booked, the lead goes back to Contacted.
- A past visit with nothing recorded shows No outcome recorded and three buttons: Converted (opens Convert), No one home (the lead stays open so you can rebook) and Not interested (the lead is closed as lost).
- When the lead has documents to sign, upcoming visits show a chip: 2 documents not signed (hover it for their names) or Documents signed.
- A visit where the technician signed the customer up without a card shows No card: and the reason they gave.
| Outcome | What it means |
|---|---|
| Converted | The lead became a customer at or after the visit |
| Quoted | A quote was started from the visit |
| No one home | Nobody was there. The lead stays open, back to Contacted when no other visit is booked |
| Not interested | They said no. The lead is closed as lost, with the reason if one was given |
| Canceled | The visit was taken off the schedule |
| Done | The stop was completed on the route without an outcome |
Visit requests and approvals
A visit asked for by a lead provider (an <code>appointment</code> sent with the lead through the Leads API) or by your AI Front Desk waits for a person when your settings say so (the default), or when it doesn't fit. You can also see it as Waiting for approval on the lead's Visits card. Approving needs the "Approve AI-proposed appointments" permission.
Where requests show
- Lead visits to approve on your To do list. Each row names the lead and who asked: From Rivermount (the lead provider's source name), From the office or From the AI Front Desk. One request opens its lead's page, where the Visits card shows it; several open the Leads page with a Lead visits to approve list at the top. This works with or without a phone line.
- The Phone inbox banner, 1 lead visit to approve (or "3 lead visits to approve"), with who they are from. Click it to open the same list.
- The lead's own Visits card, and the lead page's Next step line ("A visit request is waiting for approval", with Review).
What a request shows, and its buttons
- A badge for who asked (the lead provider's name, Office or Assistant), what the visit is for, and the day and time they asked for.
- Not booked: and the reason it waited (see the table below), and what that day already looks like ("North has 12 stops that day") with View day, which opens the Route Schedule on that day.
- Times that fit: up to three other technician-days that do fit, each a Book … button. When the time they asked for doesn't fit, the first of these is the main button and Book Thu, Dec 3 anyway books the asked-for day regardless.
- Approve (when the request fits and was only held because your settings hold these) books the time they asked for.
- Pick another time opens Schedule visit for that lead; booking there answers the request.
- Decline turns it down, and the team is told to follow up.
- An AI Front Desk request texts the customer their confirmation when approved ("Approving texts the customer their confirmation automatically."). If texting isn't live, the toast asks you to call them to confirm. A lead provider's request follows the confirmation setting on Settings → Lead Booking instead.
| Reason shown | Why it waited |
|---|---|
| Your settings hold these for approval | It fits, but the booking path is set to Hold for approval |
| No technician who takes lead visits works that day | Nobody on Who takes lead visits works that day (or they are off) |
| That time is outside the technicians' hours | The time is before or after their hours |
| It overlaps another appointment | Another timed stop is at that time |
| It adds more driving than your limit | More added miles than Book automatically allows |
| It runs past the technician's workday | More overtime than Book automatically allows |
| The technician's earlier stops run past that time | The day is too full to arrive in the window |
| The address isn't verified on the map | The lead's address couldn't be placed |
| That time has already passed | The time asked for is in the past |
| No technician is set to take lead visits | Who takes lead visits has nobody who can take it |
| Less notice than your minimum | Sooner than your notice limit |
| Further out than you book automatically | Further out than your days-out limit |
| The lead provider moved the appointment | A reschedule from the provider is waiting |
| They haven't signed the required documents yet | Book automatically waits for signed documents |
The Next step line
Under the lead's name, a Next step: line names the one thing the lead is waiting on, with a button, in this order:
| Next step | Button |
|---|---|
| A visit request is waiting for approval | Review (scrolls to the Visits card) |
| Record how the visit on … went | Record outcome |
| No visit booked | Schedule visit |
| Waiting on a signature: … / Not sent yet: … | Open / Send (scrolls to the Documents card) |
| Quote … sent: waiting for them to accept | Open quote |
| No card on file yet (for 30 days after converting, when Settings → Lead Booking asks for a card) | Request a card (the customer's Billing tab) |
It only points at what is already waiting; it never sends anything by itself. It shows to people with the "Manage website leads" permission.
At the door: the technician app
A lead visit is a stop on the technician's route, labelled Lead visit. Opening it shows the lead: the time ("Arrive 2:00–3:00 PM" or "At 2:00 PM"), the address (tap for directions), Call and Text, and What they want (Recurring service or A one-time job, the service, the price they were quoted, and "Look first, then quote" or "Do the work today"), plus the message they sent and their pools.
At the bottom is the outcome bar. The main button follows what the visit is for: a Walkthrough leads with Create quote, a First service or job leads with Start service (recurring) or Start job (one-time). The other two are under it, then Not interested and No one home.
- Start service opens a sheet with Service, Rate (prefilled per the "Price at the visit" setting), how often, and Regular route (up to three routes, the best fit first). Confirming adds them as a customer with their recurring service, and today's visit counts as their first service: finish it from your route.
- Start job opens a sheet with Job and Price. Confirming adds them as a customer and the job replaces the visit on your route today; finish it like any other job.
- Create quote adds them as a customer and opens a quote for them.
- Not interested asks why (Too expensive, Went with another company, Just looking, Does it themselves, or your own words) and Close the lead closes it as lost.
- No one home marks the visit a no-show. The lead stays open so the office can rebook, and it shows on the office's To do list under Lead visits with no outcome.
- After Start service or Start job, Open work order (when there is one) and Back to my route take you on.
Only the technician on the visit, on the day of the visit, or someone who can convert leads can record how it went; anyone else sees "Only the technician on this visit can record how it went." These buttons need a connection: offline, the bar says "These need a connection. Try again when you have signal."
Documents and the card at the door
- When the lead has documents to sign, the visit shows 2 documents not signed or Documents signed. Sign in person opens the next document so they can sign on your phone (it needs the "Send documents for signature" permission).
- If Settings → Lead Booking says Tech gets them signed before Start service, Start service and Start job stay disabled with "Get the documents signed before you start." until they sign. Create quote still works. Unsigned documents never cancel a visit.
- With Ask for a card, after starting the app shows Add a card?: Add a card on this phone, Text the link, or Not now.
- With Require a card, it shows Next: get a card on file, and Open work order and Back to my route don't show until a card is on file or the technician taps No card and says why (They'll pay another way, Didn't have a card on them, Will add it from the link later, or their own words) with Tell the office. The office then gets a To do row, "new customers from a lead visit without a card", with Request a card.
Technicians can also book a visit from a lead in the app: Schedule Visit on the lead shows Best times, or pick a technician and date, then Schedule Visit. The app books the whole day (no set time); set a time from the web. See Mobile invoices and leads.
How do I charge for a diagnosis visit?
There is no separate walkthrough or visit fee. To charge for a paid diagnosis, make it a one-time job:
- 1Create a work order template called something like Diagnosis with its price.
- 2On Settings → Lead Booking, set New leads usually want to A one-time job, Default work order template to Diagnosis, and First visit for a new lead to The first service or job (or set these for one lead source only).
- 3Book the visit as First service or job. At the door the technician's main button is Start job with the Diagnosis price filled in; it bills like any other job.
Frequently asked questions
How do I schedule a walkthrough for a new lead?
Open the lead and click Schedule visit. Pick one of the suggested technician-days (the one that adds the least driving is first) or Pick any technician and date, optionally Set a time (arrival window or fixed start), choose Walkthrough, and click Schedule visit. It lands on that technician's day, the lead shows Visit Scheduled, and the toast has Undo.
Where do bookings from my lead provider or the AI Front Desk show up?
Those waiting for a person are under Lead visits to approve on your To do list (one opens the lead's page, several open the list on the Leads page), in the Phone inbox banner, and on the lead's Visits card. Each says why it wasn't booked on its own, with up to three Times that fit. Booked ones are already on the technician's day.
Can my technician sign the lead up at the door?
Yes. The lead visit stop in the technician app has Start service (recurring), Start job (one-time) and Create quote. Start service makes them a customer and counts the visit as their first service; Start job replaces the visit with the job. It needs a connection.
Can I charge a fee for the walkthrough itself?
There is no walkthrough fee setting. Use a one-time job instead: a "Diagnosis" template with its price, set as the default on Settings → Lead Booking with the visit booked as First service or job, so the technician starts that job at the door.
What happens when nobody is home?
The technician taps No one home (or the office does it from the Visits card). The visit comes off the day, the lead stays open, and it shows under Lead visits with no outcome on the To do list until someone rebooks or closes it.
Can I undo canceling or moving a visit?
Yes. Cancel visit, Reschedule and Schedule visit all show a toast with Undo.