Manage auth links for bookings to existing Simpro projects
An auth link opens a booking form for one customer with an existing Simpro job, quote or recurring job already chosen. The customer books against that project and does not log in. Auth in the Simpro booking forms section lists the links on the account under the heading Auth Links.
Before you start
- Auth links need a subscription with the Geosearch plan. Without one the page shows "Geosearch subscription required." and hides Import and Create link.
- The booking form needs Allow bookings to existing projects or recurring jobs switched on in its properties, and a project type (Job or Quote). See Form properties. A form that is not on this setting is not offered when you make a link.
- Know the page address the form is embedded on. A link is that address with the link's ID added to it.
What the table shows
Three tabs sit above the table: Links, one tab for each bulk filter (named after its filter), and Automation.
| Column | What it shows |
|---|---|
| Contact | The contact's email, or their Simpro ID if there is none. |
| Link ID | The link's ID, with a copy button. |
| Form | The booking form. |
| Project | J or Q and the number, with the cost centre after a dash, for example J1234-56. Recurring jobs read "Recurring job" and the number. |
| Created | The date the link was made. |
| Expiry | The date and time it stops working, with Expired once it has. |
| One time | Yes if the link expires after a booking. |
| Update requests | How many events the link has in its timeline. A dash means none. |
Links a customer portal makes for its own Book a visit button are not listed.
Open appears on a link made by a bulk filter that has a Form URL. It opens the form with the link applied. The ... menu on each row has View, Check, Preview and Delete.
Step by step
Create one link
- Click Create link. See Create an auth link and send it to a customer.
Check a link
- Click ... on the row, then Check.
The check reads what the booking form itself reads, so it tells you whether the form will open for that link. Each line shows Pass, Warning, Skipped or Fail:
| Check | Fails when |
|---|---|
| Form published | The form has never been published. The link sits on a loading spinner until the form is saved and published. |
| Link published | The link has not been published, so the form does not recognise it. Nothing further is checked. |
| Link matches the form | The published link points at another form or account. Re-save the link. |
| Link expiry | The link has expired. A link with no expiry is a Warning. |
| Project details | The link is missing the company, job or quote, section or cost centre. |
| Project loads from Simpro | Simpro does not return the project. Skipped while an earlier check fails. |
The top line reads "The form will display for this link." or "The form will not display for this link" with the number of problems. When only the job or quote section is missing, Look up section ID finds the section holding the link's cost centre in Simpro, saves it to the link and republishes. Open link opens the form with the link.
Project loads from Simpro loads the project the way the form does, which adds a Loaded form entry to the link's timeline. A link with timeline entries no longer has Delete in its menu.
Preview a link
- Click ... on the row, then Preview. A side panel opens with the form as that customer sees it.
Delete a link
- Click ... on the row, then Delete, then Delete again.
Delete only appears for a link with no update requests.
Recreate expired links
- Tick the links, then click Recreate Expired Links.
- Choose a New expiry, then click the Recreate button, which names the number of links it will make.
New links get the same contact, project and settings. The expired links are left as they are. Selected links that have not expired are skipped, and the dialog says how many.
Export links
- Tick the links, then click Export.
- For each form, pick one of its saved URLs or type the page address. It has to start with
http://orhttps://. A*in a saved URL is removed. - Click Export to download
auth-links.xlsx.
The file has Booking Link, Booking Form, Contact Email, Contact Name, Contact Phone and Project (Job or Quote) for each link.
Import links
- Click Import, then drop in or pick an
.xlsx,.xlsor.csvfile. Download example template gives a sample. - On Map Fields, choose the form under Form to create links for. Only forms that allow bookings to existing projects are offered.
- Match your columns to Contact Email, Contact Phone, the job, recurring job or quote fields, Expiry (days) and One time (Yes/No). Set Default expiry (7 days to start) and Default one time for rows that leave them blank.
- Click Next and check the preview. Each row shows Ready or Invalid with the reason.
- Click the Import button, which names the number of links it will create.
Each row needs an email or phone, and a job ID (or recurring job ID) with a cost centre ID or name, or a quote ID for a quote form. Formpiece finds the contact in Simpro by email, then by cell phone, then by work phone, in the form's company. Invalid rows are skipped. The result reads "N links created" and "N failed".
Expiry choices
Links expire after 4 hours, 6 hours, 8 hours, 24 hours, 3 days, 7 days, 14 days, 21 days, 28 days or 30 days.
When it goes wrong
The page says "Geosearch subscription required."
The account needs a plan that includes Geosearch. See Geosearch.
My form is not in the list when I create or import a link
It needs Allow bookings to existing projects or recurring jobs switched on and a saved project type. If a form has no project type, the page suggests re-saving the form and checking that Booking Project Type is Job.
A link shows Expired
Use Recreate Expired Links, or make a new link.
Check says "Link published" failed
The link was never published, or its page was opened after it expired and was unpublished. Recreate it.