Create an auth link for an AroFlo task
You make a link by choosing the form and service, then the AroFlo task it is for, then whether the customer adds a visit or moves one. Create Auth Link on the Auth Links page opens the page. It 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."
- An AroFlo credential has to be chosen for bookings. If not, the page says "Choose which AroFlo credential bookings use before making an auth link." with a Choose credential button. See AroFlo credentials.
- A form needs Allow bookings to existing tasks on in its properties, and a service or a default calendar. The form picker lists only forms that qualify.
- The task needs a site in AroFlo. A task without one is refused.
Step by step
- 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.
- Under AroFlo task, type the client's name into Search for the client by name and click Search. AroFlo can't find a task by its number, so you choose the client first and then the task. With no match the page says "No clients match that name."
- Click Choose on the client. If the client has more than one site, Site narrows the tasks to one, and the default is Any site.
- The client's tasks are listed with their Site and Status. Click Choose on the right one, or Show more tasks. Choose another client or Choose another task starts again. A client with no tasks says "This client has no tasks".
- Under What the customer does, choose Add a new visit or Move an existing visit. Moving is greyed out until the task has a visit, and the page says "This task has no visits to move, so only a new visit can be added."
- For a move, pick the Visit to move.
- 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.
- 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.
- 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 200 rows. Every row costs several lookups in AroFlo, which limits each site to 120 requests a minute, so a bigger sheet has to be done in parts.
- Drop the file in. Download example template gives a sheet with the right columns.
- 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.
- Match your columns to Client (AroFlo name) and Task Number, which are required, and Visit ID (to move a visit), Contact Name, Contact Email, Contact Phone, Expiry (days) and One time (Yes/No).
- Click Next. Formpiece looks each task up in AroFlo ("Looking up tasks 3 of 40").
- The preview shows each row as Ready or Invalid with the reason, and counts 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.
Each row names the client as AroFlo has it, and the task is found among that client's latest tasks. A leading # on the task number is ignored. One time accepts yes, y, true or 1.
When it goes wrong
Create Auth Link is refused
The page names what is missing: "Choose the booking form.", "Choose the service the booking is for.", "Choose the AroFlo client.", "Choose the AroFlo task.", "This task has no site in AroFlo. Choose a task that has one." 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 client name" or "No task number"
- "Client "{name}" was not found in AroFlo"
- "{n} AroFlo clients match "{name}", so use the client's full name"
- "AroFlo could not be asked about this client" or "AroFlo could not be asked about this client's tasks"
- "Task 1234 was not found among {client}'s latest tasks in AroFlo"
- "This task has no site in AroFlo"
- "Visit 7KB8000006G is not on this task", or "The task's visits could not be loaded"
- "This task already has an open link", or "This task 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. A file with more than 200 rows is refused with "The file has {n} rows. Import up to 200 at a time." At the end the popup lists any that failed to save under "These were not made:".