Skip to content
Skip to content

Practical reception guide · By Yes AI

AI phone bookings in ServiceM8, Fergus and Tradify

Published 5 min read

Trade businesses want a phone enquiry to land as a job in the software the team already uses, not as an email someone has to retype. Whether that is possible depends on what each job management system lets another program create through its API. This guide sets out what to check, using the published developer documentation for ServiceM8, Fergus, simPRO and Tradify.

Quick answer

An AI receptionist can only create jobs or bookings in trade software that offers an API with write access. ServiceM8's API can create jobs and scheduled job activities with the right permission. Fergus publishes endpoints for enquiries, customers, sites, jobs and calendar events. simPRO documents leads, jobs and schedules. Tradify's help centre lists accounting and payment integrations, so ask Tradify about direct booking before relying on it.

Plumber in workwear reviewing a new job on a tablet beside a van outside a Perth suburban home

What does integration with job software actually mean?

Providers use the word integration for very different things. At one end, the receptionist emails or texts you a summary and someone types it into your software. Further along, it creates an enquiry or lead. Further again, it creates the client, the site and the job. The deepest level books a time on a named technician's schedule. Each step needs more access to your account and more rules written down, such as job types, service areas and travel buffers. Ask any provider which level it will deliver for your system, and ask to see it working in a test account.

  • Notification: a summary by email or text
  • An enquiry or lead created for the office
  • Client, site and job created, not yet scheduled
  • A booking placed on a technician's schedule

What can ServiceM8 accept from another system?

ServiceM8's developer documentation includes endpoints to create a new job and to create a new job activity. A job activity assigns work on a job to a staff member, with a scheduled start and end time. Creating one requires the manage_schedule OAuth scope, which gives full access to that endpoint. That is a meaningful level of access, so decide whether the receptionist really needs to book a technician's time, or whether creating the job and leaving scheduling to the office is enough. ServiceM8 also publishes a platform policy that covers API use, privacy and customer data.

What about Fergus and simPRO?

Fergus publishes an OpenAPI specification for its API. It accepts a personal access token or OAuth 2.0, and lists endpoints for enquiries, customers, sites, jobs, quotes and calendar events. It applies a rate limit of 100 requests per minute per company, shared across every endpoint and token, so a receptionist and your other integrations draw on the same allowance. simPRO's API documentation covers leads, quotes, jobs, schedules and webhooks, and sets out its API call limits. For both, agree which records the office wants created from a phone call before anyone requests access.

What if you run Tradify?

Tradify's own help centre documents integrations with accounting and payment services such as Xero, MYOB and Stripe. When this guide was written we could not find a published developer API in Tradify's own documentation. That does not rule out other arrangements, so ask Tradify directly what is available for your account. Until you have a written answer, plan for a request workflow: the receptionist captures the job details and sends them to the office, and staff create the job in Tradify. That keeps the schedule accurate while the integration question is settled.

Which caller details should a new job hold?

Agree the fields before connecting anything, because a job created with half the details costs the office more time than a complete message. Keep the site address and the billing contact separate, since tenants, property managers and owners are often different people. Match returning customers by phone number to avoid duplicate client records, and decide what happens when the number is new but the address already exists in your system.

  • Site address, with access notes such as gate codes or pets
  • Site contact and billing contact, if they differ
  • Job type from your own list, plus the caller's description
  • Urgency and the caller's available times
  • How the caller found you, if you track lead sources

How should you test it before callers rely on it?

Use a test client and a test staff member in your real account rather than a demo account, because your own job types, statuses and permissions are what matter. Make test calls that create a new client, a returning client and a job at a new site for an existing client. Try booking over an existing job, outside working hours and on a day the technician is on leave. Check what the technician sees on their phone. Then break the connection on purpose and confirm the caller is told their details were taken, not that a booking is confirmed.

What each system's published documentation shows (checked October 2026)

SystemHow access is grantedBooking-related records documentedWhat to confirm
ServiceM8OAuth scopes; manage_schedule is needed to create job activitiesJobs and job activities (scheduled work for a staff member)Whether the receptionist needs scheduling access or only job creation
FergusPersonal access token or OAuth 2.0; 100 requests per minute per companyEnquiries, customers, sites, jobs, quotes and calendar eventsWhether calls should become enquiries or calendar events
simPRODocumented REST API with published call limitsLeads, quotes, jobs and schedulesWhich records the office wants from a phone call, and who approves access
TradifyNo public developer API found in Tradify's own help centreAccounting and payment integrationsAsk Tradify what is available; use a request workflow meanwhile
Any other systemAsk the vendor for its developer documentationLook for endpoints that create records, not only read themWhether a test booking can be made in your own account

Practical checklist

  • You know whether calls should create enquiries, unscheduled jobs or confirmed bookings.
  • The access requested is the least that does the job, and the account owner approved it.
  • Test jobs were created in your real account and checked on a technician's phone.
  • Returning callers are matched to existing clients without creating duplicates.
  • A failed write sends the details to the office and never tells the caller a booking is confirmed.
  • Job types, service areas and minimum call-out rules are written down for the receptionist.

Common questions

Can the receptionist quote prices from our price list?

It can read approved prices if you give them to it, but many trade jobs cannot be priced until someone sees the site. A safer pattern is to give only the call-out fees or price ranges you already publish, and log everything else as a quote request for the office. Our guide to quote request intake covers the wording.

Do we need a developer to connect our job software?

If you use a managed service, ask whether the provider builds and maintains the connection. Your part is approving access in your account and supplying the rules. Also ask who maintains the connection when your software vendor changes its API, and who you contact if bookings stop appearing.

Will the receptionist see all our customer records?

That depends on the access you grant. Some permissions cover a whole area of the account, such as every job or every client. Ask which permissions the provider requests and why, and avoid granting access to invoices or financial records unless the workflow needs them. Read the vendor's documentation on what each permission allows.

What if our software is not listed here?

Ask the vendor for its developer or API documentation and look for endpoints that create records, not only read them. Then ask about rate limits, how access is granted and removed, and whether a test account is available. If there is no API, a structured message to the office is still better than a voicemail.

Is a booking request worse than a direct booking?

Not for every business. If your team checks addresses, travel time or parts before committing to a time, a request that the office confirms during business hours avoids double bookings and wasted trips. Direct booking suits fixed-length jobs with clear service areas, such as regular servicing or inspections.

Sources and further reading

Continue planning

Turn the guide into your call flow

Bring your current call-handling process and the exceptions your team encounters. We can discuss what to automate, what needs staff approval and what to test before changing your live phone service.