Manage one Fergus auth link: settings, emailing it and its timeline
Open a link with View in the Auth Links list. The page is headed with the job, such as the job number and title, and has Reload and Back to Auth Links buttons. It has three tabs: Settings, Messages and Timeline.
Settings
Link shows the address the customer opens, with Copy link. The address is the page your form is on with the link's ID added. Until that page is set the box is replaced by "Set the page the form is on below. The link is that address with this link's ID added."
Page the form is on takes the full address of the page where the form is embedded, such as https://example.com/book,
and Save address stores it. It is saved on the form, so it applies to every auth link on that form. An address that does not
start with https:// or http:// is refused. A second box shows the Link ID with Copy ID.
Details shows:
- Status: Active, Used or Expired. While the link is active, Expire now stops it opening straight away, after a confirmation.
- Mode: New visit or Move visit.
- Expires, One-time link, Form, Service, Fergus job, Job type, Job phase, Visit to move, Customer, Site and Contact. The phase and the visit are shown as their Fergus numbers.
Bookings made from this link lists each booking with its date, time, customer and status, and a View button that opens it under Bookings. Delete link shows only when the link has no bookings.
Check and Preview
Both are in the menu at the end of each row on the Auth Links list.
Check asks the form and the booking API whether the link will work, and lists Pass, Warning or Fail against:
- Link is open: not expired and, for a one-time link, not used.
- Form is published: the form is in the published store. A form missing there says to use Publish again on the form.
- Bookings on existing jobs: the plan includes it, and Allow bookings to existing jobs is on.
- Service: the link's service is still on the form.
- Staff: someone is switched on to take the visit. With nobody, there are no times to offer.
- Page address: the page is set. If not, it is a warning.
- Booking API: the API's own answer, for example "Opens job 1234 - Install". A refusal shows its reason, such as an archived or completed job.
The top of the popup reads "The form will display for this link." or says how many problems were found. Opening the popup is not a customer opening the link, so it is not logged on the timeline.
Preview opens the form in a panel beside the list, exactly as that customer would see it.
Messages
Messages emails the link to the customer. The page says: "The link is added to the bottom of your message, and the email comes from Formpiece in your business's name."
- To starts as the link's contact email. Separate up to five addresses with commas.
- Subject starts as "Choose a time for your visit" and can be up to 200 characters.
- Message starts with a greeting using the contact's first name and the line "Please use the link below to choose a time for your visit." It can be up to 5000 characters.
- The Preview shows once the page address is set and there is a message.
- Click Send and confirm "Send this email?" It goes to the addresses shown and cannot be taken back.
The page says "Email sent to ..." and the send is logged on the timeline.
The button is greyed with a message that starts "Save is off:". The reasons are: no page address set in Settings, the link has expired or been used, no email address, more than five addresses, an address that is not valid, no subject, no message, or the email was already sent. Change the addresses, subject or message to send another.
Limits: one link can be emailed 10 times a day, and the whole account 200 times a day. Past that the page says "This link has already been emailed 10 times today. Try again tomorrow." or "Your account has reached its limit for emailed links today. Try again tomorrow."
On the Free plan a link can only be emailed to the address it was made for. A link with no contact email says "This link has no email address. Enter one to send it to."
Timeline
Timeline lists what happened to the link, newest first and grouped by month, with Date, Event, Detail and a View button for bookings:
- Link created
- Opened link: logged when a customer opens it, at most once every 10 minutes
- Sent email, with the addresses
- Form submission, with the booking's date and time
It reads the latest 100 emails and opens, and the latest 20 bookings. A link with no activity says "No events logged."
When it goes wrong
Copy link is missing
The form has no page address. Save one under Page the form is on.
The link opens a page that shows no form
Check that the page really holds the form. The address has to be the page that holds the embedded form or the Formpiece WordPress plugin, because the link only
adds fpresumeid to it. Embed covers putting a form on a page.
Send says the page address must be set
The send route refuses with "Set the page the form is on before sending the link." when the form has no valid address saved.