simPRO
Connect simPRO with an API key in about five minutes, so each booking becomes a simPRO service job that follows its moves and cancels.
Each new booking becomes a job in simPRO, with its customer and site, so you never type it in twice. Create an API key in simPRO, paste it on Settings, and new bookings start going across.
What it does
TapBook takes the bookings, from Google, your website and your phone, and simPRO keeps running your jobs. You don't change how you work in simPRO.
- Every booking, quote request, call-back and enquiry becomes a service job in simPRO, including ones the phone assistant takes and ones your team adds.
- TapBook finds the customer in simPRO by email, then by mobile. If they aren't there, it adds them.
- The job goes at the address the form asked for, or the customer's first site, or a new site.
- When the booking moves or is cancelled in TapBook, the job follows.
Before you start
You need:
- An owner log-in to TapBook. Only owners can connect simPRO.
- An admin log-in to simPRO that can open System, then Setup.
- Your simPRO address. It's the address you log in to simPRO at, like jaxplumbing.simprosuite.com.
- The simPRO card on Settings. If Settings has no simPRO card, email hello@tapbook.au and we'll turn it on.
Create an API key in simPRO
- Log in to simPRO. On the home page, choose the cog in the top right, then Setup.
- In the System Setup menu on the left, open API, then choose Applications.
- The Applications page shows either Create Application or Request API Access. Follow the steps below for the one you see.
If you see Create Application
- Choose Create Application.
- Name it TapBook.
- Set Authentication Method to API Key, and save.
- Download the key file. Open it and copy the access_token. Pasting the whole file works too: TapBook takes the access_token from it.
The key doesn't expire. It can add and change customers, sites and jobs in your simPRO company, whoever created it.
If you see Request API Access
simPRO has to switch the API on for your account first.
- Choose Request API Access.
- For the request type, choose Build something myself.
- For the description, enter TapBook.
- Choose Submit.
simPRO emails you when it's done. If the email has an API key, paste that in TapBook. If it says the API is on, go back to Applications and follow If you see Create Application.
Connect it in TapBook
- Open Settings. The card is simPRO.
- In Your simPRO address, enter the address you log in at, like jaxplumbing.simprosuite.com. With or without https:// is fine.
- In Your simPRO API key, paste the access_token.
- Choose Connect.
The toast says simPRO connected. New bookings go there from now on. The card now says Connected to your simPRO company, with a Connected chip, your address, and the last 4 characters of the key.
Bookings made before you connect stay in TapBook. Only new ones go to simPRO.
Can't do it yourself? Email the key file and your simPRO address to hello@tapbook.au and we'll connect it for you. Delete the email once it's connected.
Check it worked
- Make a test booking on your booking page.
- Within a minute, it shows under Sent to simPRO on the card as Sent.
- In simPRO, the customer, their site and a service job due at the booking's time are there.
Cancel the test booking in TapBook, and 10 seconds later the job is archived in simPRO.
What changes in simPRO
| In TapBook | In simPRO |
|---|---|
| A booking with a time | A service job, pending, due at the booking's time |
| A quote request, call-back or enquiry | A service job with no due date |
| The booking moves, from the booking page or on the calendar | The job's due date and time move |
| A quote or call-back is booked in | The job is due at that time |
| The booking is cancelled | The job is archived, 10 seconds later |
| The cancel is undone | The job is back, pending, due at its time |
| Confirmed, quote sent, completed or no-show | Nothing changes |
A cancel waits 10 seconds so Undo on the booking can stop it before simPRO hears of it.
After the first send, TapBook only changes the job's due date and time, and only archives or restores it while its stage is still the one TapBook gave it. A job someone has started, completed or invoiced in simPRO stays as it is. Everything else about a job is yours to change in simPRO.
The log
Sent to simPRO, on the card, lists every job TapBook sent, or tried to: When, Booking, Change and Status. Booking opens the booking. Show more loads older rows.
Status is one of:
- Waiting or Sending: on its way.
- Sent: it's in simPRO.
- Trying again: simPRO didn't answer, so TapBook tries again on its own.
- Not sent: TapBook gave up. Retry sends the booking as it is now.
- Sent with a later change: this change didn't go, but a later one for the same booking did, so the job is up to date.
- Skipped: TapBook left the job alone. The line under it says why, such as The job was changed in simPRO, so TapBook left it. or simPRO was disconnected.
Replace the key or disconnect
Replace key opens Replace simPRO's API key. Paste the new access_token and choose Replace key. The toast says API key replaced. Use it when you've made a new key in simPRO.
Disconnect asks Disconnect simPRO? New bookings stop going to simPRO. The customers and jobs already there stay as they are. Then delete the TapBook application in simPRO too, under System, Setup, API, Applications.
Troubleshooting
Not a simPRO address
The card says That isn't a simPRO address. The address has to be the one you log in at, ending in simprosuite.com or simprocloud.com, like jaxplumbing.simprosuite.com.
Key not accepted
The card says simPRO didn't accept that key. Check you copied all of the access_token, or paste the whole key file. If it still says so, make a new application in simPRO and paste its key.
No answer at your address
The card says simPRO didn't answer at your address. Check the address is the one you log in at. If it is, try again in a minute.
Needs connecting
The card shows a Needs connecting chip when simPRO stopped accepting the key, for example because the application was deleted in simPRO. The card says why and shows the key field again. Make a new key in simPRO and paste it. Bookings made or changed in the meantime go across when you do.
Phone assistant bookings
They go to simPRO too. Every booking and request goes the same way, wherever it came from.
More than one company
If your simPRO has more than one company, jobs go to the first company in your simPRO. If that's the wrong one, email hello@tapbook.au.
Using ServiceM8 instead
See ServiceM8.
Updated . Still stuck? Email hello@tapbook.au