Create auth links in bulk and save them to Podium or Simpro
Automation on the Auth links page has three tabs. Bulk filters makes auth links for the Simpro jobs a Workflow Filter finds. Podium and Simpro decide where each new link is saved so staff can send it. The page is headed Auth Links automation, and like the rest of auth links it needs the Geosearch plan.
Before you start
- A job filter under Workflow Filters. Only job filters are offered. A filter with no project type counts as a job filter.
- A booking form with Allow bookings to existing projects or recurring jobs switched on.
- For Podium, a Podium integration. See Podium. For Simpro, a custom field of type Text or Hyperlink on your jobs.
Step by step
Make a bulk filter
- Open Automation, then Bulk filters.
- Under Create new bulk filter, choose the Filter and the Form.
- Pick a Select Form URL from the form's saved URLs, or type the Form URL. It is required, and is the page the link opens.
- Under Default contact record - must be the contact that is making the booking, choose Site contact or Customer contact.
- Choose the Default expiry.
- Optionally choose the Phone country code (Podium integration required): Australia (+61), New Zealand (+64), United Kingdom (+44) or United States (+1).
- Optionally choose one or more Regions. "Filter is applied after Simpro retrieval".
- Click Create bulk filter.
The button stays off until the filter, form, expiry and form URL are set. The create form is hidden when the account has no job filter or no booking form. The table lists each bulk filter with Filter, Booking form, Form URL, Contact record, Phone code, Default expiry, Region and Last updated, with Update and Delete. A bulk filter whose filter or form was deleted reads "Bulk filter is incomplete. (Filter or form is no longer available)".
Each bulk filter also gets its own tab beside Links, named after its filter.
Create links from a bulk filter
- Open the bulk filter's tab. Formpiece asks Simpro for every job the filter matches, 25 at a time.
- Tick the jobs, then click Create links. Or click Create link on one row.
For many jobs the page says "N links will be created in the background and will be ready soon." Each row shows Created or Not created in the Link column, with the Expiry, and Open once a link exists.
A job can be selected only when:
- It has no link yet. The page matches on the Simpro job number.
- Its chosen contact record (site or customer) has a cell phone or an email.
- It has a cost centre to book into. If the bulk filter was made with a form that has a default cost centre, the job must have that cost centre. Otherwise Formpiece uses the first cost centre on the job that is not fully claimed.
When the bulk filter has regions, a job whose site is outside them is greyed out with a warning icon, and its tooltip shows the Simpro site ID and coordinates. Check site appears for a site with no coordinates yet. It looks the site up, which counts towards Geosearch usage.
If Save auth link to Podium contact is on, creating a link first searches Podium for the contact. When it finds none, the page asks "Would you still like to create the booking link?" and lets you create it anyway.
Save links to Podium
- Open Automation, then Podium.
- Switch on Save auth link to Podium contact.
- Choose which field to match contacts on, Phone or Email. The Podium contact needs that field filled in before a link can be made.
- Choose the Podium contact field to update. Only text fields are offered.
- Optionally switch on Remove auth link from Podium contact after a booking is made.
- Click Save.
Without a Podium integration the tab says "Podium integration required" with a Go to Podium settings button.
Save links to Simpro
- Open Automation, then Simpro.
- Switch on Save auth link to Simpro job (recurring jobs are not supported).
- For each company your forms use, choose the Job custom field. Only Text and Hyperlink fields are listed.
- Optionally switch on Remove auth link from Simpro project after a booking is made.
- Click Save.
Saving shows "Podium settings updated." or "Simpro settings updated.", or the matching "Could not update" message. Quotes are not supported on this tab.
How it maps to Simpro
| Setting | What Formpiece writes |
|---|---|
| Save auth link to Simpro job with a Job custom field | The auth link address, as the value of that custom field on the job |
| Remove auth link from Simpro project after a booking is made | Empties that custom field on the job once a booking is made |
| Save auth link to Podium contact | The auth link address, in the Podium contact field to update on the Podium contact |
| Remove auth link from Podium contact after a booking is made | Clears that Podium field once a booking is made |
The address is the bulk filter's Form URL with the link's ID added. Removal after a booking needs the link to have a Podium contact (for Podium) or a Simpro job (for Simpro).
Links made automatically
A bulk filter also makes links without anyone opening the page. When Simpro tells Formpiece a new job has been created, Formpiece checks it against each bulk filter's workflow filter and its exclude fields and region, and makes the link, then saves it to Podium and the Simpro custom field as set above. It does nothing unless Save auth link to Podium contact or Save auth link to Simpro job is on, and it uses the form's default cost centre, which the job must have. The Simpro webhook that Geosearch sets up (named "Formpiece Webhooks" in Simpro, and listening for new jobs among other events) has to be active. See Geosearch.
When it goes wrong
There is no create form on Bulk filters
The account has no job filter or no booking form. Create a filter in Workflow Filters first.
The Podium tab asks for an integration
Link a Podium integration in Podium settings.
A job has no checkbox
It already has a link, or its contact record has no cell phone or email, or it has no cost centre to book into. Create link is greyed out on the row for the same reasons.
"Could not bulk create links. Please try again."
The links could not be saved. Try again.