TapBook

ServiceM8

Connect ServiceM8 with an API key in a few minutes, so each booking becomes a ServiceM8 job or quote that follows its moves and cancels.

Each new booking becomes a job in ServiceM8, with its client, so you never type it in twice. Add an API key in ServiceM8, 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 ServiceM8 keeps running your jobs. You don't change how you work in ServiceM8.

  • Every booking becomes a scheduled work order in ServiceM8. A quote request, call-back or enquiry becomes a quote. That includes ones the phone assistant takes and ones your team adds.
  • TapBook finds the client in ServiceM8 by email, then by mobile. If they aren't there, it adds them.
  • The job has the address the form asked for and what the customer wrote.
  • 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 ServiceM8 and choose who jobs go to.
  • An admin log-in to ServiceM8, so you can add an API key.
  • The ServiceM8 card on Settings. If Settings has no ServiceM8 card, email hello@tapbook.au and we'll turn it on.

Add an API key in ServiceM8

  1. Log in to ServiceM8 on the web.
  2. In the top bar, choose Account, then Settings.
  3. Choose API Keys.
  4. Choose the green Add API Key button.
  5. For API Key Name, enter TapBook.
  6. For API Key Type, choose Full Access.
  7. Choose Create, then Copy.

TapBook needs Full Access to add clients and jobs. A Read Only key can't, so TapBook won't take one. You can also keep the key somewhere safe, like a password manager.

Connect it in TapBook

  1. Open Settings. The card is ServiceM8.
  2. In Your ServiceM8 API key, paste the key.
  3. Choose Connect.

The toast says ServiceM8 connected. New bookings go there from now on. The card now says Connected to your ServiceM8 account, with a Connected chip and the last 4 characters of the key.

Bookings made before you connect stay in TapBook. Only new ones go to ServiceM8.

Can't do it yourself? Email the key to hello@tapbook.au and we'll connect it for you. Delete the email once it's connected.

Choose who jobs go to

Once it's connected, New jobs go to lists your ServiceM8 staff. Choose who gets jobs. It saves as soon as you change it, and the toast says Saved.

A booking whose team member has the same name as someone in ServiceM8 goes to them. The rest go to the person you chose.

The list is your ServiceM8 staff as they were when you connected, brought up to date with each booking that goes. Someone added in ServiceM8 since shows once a booking has gone. If ServiceM8 has no staff to give jobs to, the card says to add someone in ServiceM8, then connect again.

Check it worked

  1. Make a test booking on your booking page.
  2. Within a minute, it shows under Sent to ServiceM8 on the card as Sent.
  3. In ServiceM8, the client and a work order scheduled at the booking's time are there.

Cancel the test booking in TapBook, and 10 seconds later the job is unsuccessful in ServiceM8, off the schedule.

What changes in ServiceM8

In TapBookIn ServiceM8
A booking with a timeA work order, scheduled at the booking's time
A quote request, call-back or enquiryA quote, not scheduled
The booking moves, from the booking page or on the calendarThe job's schedule moves
A quote or call-back is booked inA work order, scheduled at that time
The booking is cancelledThe job is unsuccessful and off the schedule, 10 seconds later
The cancel is undoneA work order again, back on the schedule
Confirmed, quote sent, completed or no-showNothing changes

A cancel waits 10 seconds so Undo on the booking can stop it before ServiceM8 hears of it. TapBook never marks a job completed: Mark complete in TapBook changes nothing in ServiceM8.

After the first send, TapBook only changes the job's time and status, and its status only while it is still the one TapBook gave it. A job someone has changed in ServiceM8 stays as they left it. A job deleted in ServiceM8 stays deleted.

The log

Sent to ServiceM8, 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 ServiceM8.
  • Trying again: ServiceM8 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 ServiceM8, so TapBook left it. or ServiceM8 was disconnected.

Replace the key or disconnect

Replace key opens Replace ServiceM8's API key. Paste the new key and choose Replace key. The toast says API key replaced. Use it when you've made a new key in ServiceM8.

Disconnect asks Disconnect ServiceM8? New bookings stop going to ServiceM8. The clients and jobs already there stay as they are. Then delete the key in ServiceM8 too, under Account, Settings, API Keys.

Troubleshooting

Key not accepted

The card says ServiceM8 didn't accept that key. Check you copied all of it. If it still says so, add a new key in ServiceM8 and paste that.

Key can only read

The card says That key can only read. Add a key with Full Access in ServiceM8, and paste that.

Account isn't active

The card says ServiceM8 says that account isn't active. Check your ServiceM8 subscription, then try again.

Needs connecting

The card shows a Needs connecting chip when ServiceM8 stopped accepting the key, for example because it was deleted in ServiceM8. The card says why and shows the key field again. Add a new key in ServiceM8 and paste it. Bookings made or changed in the meantime go across when you do.

Phone assistant bookings

They go to ServiceM8 too. Every booking and request goes the same way, wherever it came from.

Using simPRO instead

See simPRO.

Updated . Still stuck? Email hello@tapbook.au