Fergus Booking Forms

Create an auth link from a Fergus job, or import many from a spreadsheet

5 min read Fergus booking form

You make a link by choosing the form and service, then the Fergus job it is for, then whether the customer adds a visit or moves one. Create Auth Link on the Auth Links page opens the page. The same page is titled Create Auth Link, with a Back to Auth Links button.

Before you start

  • The account needs the Geosearch plan. Without it the page shows "Geosearch subscription required."
  • A Fergus credential has to be chosen for bookings. If not, the page says "Choose which Fergus credential bookings use before making an auth link." with a Choose credential button. See Fergus credentials.
  • A form needs Allow bookings to existing jobs on in its properties, and a service or a default calendar. The form picker lists only forms that qualify.

Step by step

  1. Under Form and service, choose the Booking form and the Service. The service sets the staff, calendar and length of the visit, and the customer only picks a time. A form with a default calendar lists it as Default calendar.
  2. Under Fergus job, type a job number, customer, site or title into Search by job number, customer, site or title and click Search. The results list each job's number, customer, type and status. Click Choose on the right one. With no match the page says "No jobs match that search." Choose another job starts again.
  3. If the job needs one, choose the Job phase. Every job type except Quote and Estimate is booked by phase, and the page says "A {type} job is booked by phase." A job with no phases says "This job has no phases", and a link cannot be made for it.
  4. Under What the customer does, choose Add a new visit or Move an existing visit. Moving is greyed out until the job (or phase) has an active visit, and the page says "This job has no active visits to move, so only a new visit can be added."
  5. For a move, pick the Visit to move. A visit that repeats cannot be moved, since moving it would change every repeat, so add a new visit instead.
  6. Under Link settings, choose Expires after (24 hours, 3 days, 7 days, 14 days or 30 days, with 7 days to start with) and switch on One-time link if it should stop after the first booking.
  7. Optionally fill in the Contact name, email and phone. They are kept with the link for your own reference. The email is also the address Messages sends to by default.
  8. Click Create Auth Link. The link's own page opens.

A link is the form's page address with the link ID added, so set Page the form is on on the link's Settings tab if the form does not have one yet.

Import from a spreadsheet

Import on the Auth Links page takes a spreadsheet (.xlsx, .xls or .csv) of up to 1000 rows. Every row costs a lookup in Fergus, so a bigger sheet has to be done in parts.

  1. Drop the file in. Download example template gives a sheet with the right columns.
  2. Under Map Fields, choose the Form to create links for and the Service, then set a Default expiry and Default one time for rows that leave those blank.
  3. Match your columns to Job Number (required), Job Phase (title or ID), Visit ID (to move a visit), Contact Name, Contact Email, Contact Phone, Expiry (days) and One time (Yes/No).
  4. Click Next. Formpiece looks each job up in Fergus ("Looking up jobs 3 of 40").
  5. The preview shows each row as Ready or Invalid with the reason, and counts how many are ready and how many will be skipped. Click Import to make the ready ones. A row with a Visit ID moves that visit, and any other row adds a new one.

A blank contact column falls back to the job's main contact. A blank Job Phase works when the job has exactly one phase, and a Quote or Estimate needs none. A leading # on the job number is ignored. One time accepts yes, y, true or 1.

When it goes wrong

The page names what is missing: "Choose the booking form.", "Choose the service the booking is for.", "Choose the Fergus job.", "Choose the job phase. A job of this type is booked by phase." or "Choose the visit to move." A bad contact email says "The contact email is not a valid address."

The import marks a row Invalid

  • "No job number"
  • "Job 1234 was not found in Fergus"
  • "Fergus could not be asked about this job"
  • "Phase "Install" is not on this job"
  • "This job has no phases", or "This job has 3 phases, so a job phase is needed"
  • "Visit 98765 is not on this job", or "A repeating visit cannot be moved"
  • "This job already has an open link", or "This job is repeated in the file"
  • "The contact email is not valid"
  • "The expiry is not a number of days"

Invalid rows are left out. Fix them and import the sheet again, or make them one at a time. At the end the popup lists any that failed to save under "These were not made:".