Create an auth link and send it to a customer
One auth link is one customer booking against one existing Simpro project. Click Create link on Auth links to make one, or View on a row to open it. The page is New auth link until it is saved, then Auth link, with four tabs: Settings, Access, Messages and Timeline.
Like the list, it needs the Geosearch plan, and shows "Geosearch subscription required." without one.
Before you start
- A booking form with Allow bookings to existing projects or recurring jobs switched on and a project type saved. See Form properties.
- The page address the form is embedded on, to build the link the customer receives.
- For SMS, a Twilio integration. For email from your own domain, a Mailgun or Mailchimp Transactional integration.
Step by step
- On Settings, choose the Booking form. Each form is listed with its project type, for example "Service call (Job)".
- For a job form, choose Job type: Existing job or Recurring job.
- For an existing job, search Job by job number or name, then choose the Job Cost Centre. For a recurring job, search Recurring job template and choose the Recurring Job Cost Centre. For a quote form, search Quote and choose the Quote Cost Centre.
- Optionally choose a Job Cost Centre Schedule (or Quote Cost Centre Schedule). Use it when a job needs to be re-booked or a particular schedule changed. With a schedule chosen, service selection is turned off on the booking form. A form with dates and times turned off shows "Form has bookings disabled." here.
- Search the Contact by name. The Contact details preview shows the Simpro ID, name, email, work phone and cell phone. Tick Use work phone or Use cell phone to choose the number saved on the link.
- Choose the Expiry. The page shows the estimated expiry date and time.
- Tick One time use - expire link once a booking has been made if the link should stop working after one booking.
- Click Save.
The page says "Passwordless link saved." If you did not pick a cost centre, it says "Please select a cost centre". "Could not save passwordless link." means the save failed.
A saved link cannot be edited. The page shows its Booking form, Project, Schedule (Selected or Not selected), Contact, Expiry and One time use, and for a one time link whether it is Used. To change anything, make a new link. A link with no update requests can be deleted from the list.
With no schedule chosen, the page says a schedule "will be created or moved if an existing schedule exists on the same day".
Podium fields
When the Podium integration is set to update contacts (see Auth link automation), Settings also shows a Podium contact preview and a Form URL to save to Podium list drawn from the form's saved URLs. If Formpiece cannot find the Podium contact, it says "Could not find a Podium contact".
Copy the link (Access tab)
- Open Access. It appears while the link has not expired and, for a one time link, has not been used.
- Under Link generator, pick a Select form URL from the form's saved URLs, or type the URL of booking form.
- Click Copy link next to Unique access link.
The link is your page address with fpresumeid=<link ID> added. It goes after any query string the address already has, and before any # fragment. Copy email and Copy mobile copy the contact's details.
Send the link (Messages tab)
- Open Messages. Enter the page address as above, so Unique access link fills in.
- Choose Message type: Email, or SMS.
- For email, choose the Email provider. Formpiece sends from noreply@formpiece.com. Mailgun and Mailchimp Transactional appear when connected. With a provider you set From email and pick one of its domains.
- For email, set the Subject.
- For SMS, choose Default sender ID or Custom sender ID, and the Destination country: Australia (+61), New Zealand (+64), United Kingdom (+44) or United States (+1).
- Type the Message. The unique access link is added to the bottom of it.
- Check the Preview and click Send.
Send stays off until the message and a valid page address are filled in and the sender is valid. On success the page says "Email sent to
SMS needs a Twilio integration, otherwise the option reads "SMS - Twilio integration required". It is also unavailable ("SMS - not available") when the link has no phone number. A custom sender ID has to belong to your Twilio account, or the default sender ID is used.
Follow the link (Timeline tab)
Timeline lists each event with its Date, Event, Referrer and, for a booking, a View button. It is grouped by month. The events are Loaded form, Form submission, Sent SMS and Sent Email. Other steps the customer reaches on the form appear under their own event names. An empty list reads "No update events logged."
How it maps to Simpro
| On the link | In Simpro |
|---|---|
| Job and Job Cost Centre | The job the booking is made against, J<number>-<cost centre> |
| Recurring job template | A new job is created from the recurring job template when the customer books |
| Quote and Quote Cost Centre | The quote the booking is made against, Q<number>-<cost centre> |
| Job Cost Centre Schedule | The schedule that is moved or re-booked |
| Contact | The Simpro contact the booking is made for |
After a booking against an existing project, a one time link is expired.
When it goes wrong
The Access tab is missing
The link has expired, or it is a one time link that has been used. Make a new link.
A link stopped working
When you open a link's page after its expiry plus one hour, or after a one time link has been used, Formpiece unpublishes it and the form no longer recognises it. Use Check on the list to see which part fails.
There is no Delete for a link
The link has update requests. Anything that loads the form for the link counts, including Check.