Chain
Connections to your website and other systems
Connect your website, a fleet customer's portal or another tool to SmartMy Garage. Each connection has its own key, its branches and what it may do: read job cards, vehicles, customers and invoices, create appointments and enquiries. Job card events are sent to it as signed messages, with retries.
PlansEnterprise only
The problem it solves
- A fleet customer wants to see its cars' job cards in its own portal and asks for spreadsheets every week.
- Your website books visits in a form that someone retypes into the workshop system.
- Another system needs to know when a car is ready or invoiced, and nobody tells it.
How it works
- 01
An administrator opens Garage > Configuration > General > Integrations and clicks New, and names it, for example "Fleet portal of a leasing company".
- 02
Choose the branches it may see, and tick what it may do.
- 03
Save, then make a new key. The key is shown once: copy it and give it to the other system's people safely.
- 04
On the Webhooks tab, add the other system's address and the events it wants. Send a Test checks it.
- 05
Each message is signed with a secret the receiver uses to check it came from you. New Secret changes it.
- 06
Garage > Configuration > General > Webhook Deliveries lists every message with the answer; Send Again repeats one.
Everything it does
What a connection may do
- Read Job Cards and Read Vehicles: on to start with
- Read Customers and Read Invoices: off to start with
- Create Appointments and Create Enquiries: off to start with
- Webhooks: on to start with
- Only the branches you choose
Keys and limits
- One key per connection, shown once; a new key stops the old one
- Revoke Key stops the connection until it gets a new key
- Key Expires: empty means it does not expire
- Requests per Minute: 120 to start with (0 means no limit)
- Last used, last address and the number of requests kept
Events sent
- Job card created, stage changed, checked in, ready, delivered, cancelled, invoiced
- Appointment created, enquiry created
- Each message signed (HMAC-SHA256) with a delivery ID
- Retried up to 8 times, from 1 minute up to 24 hours apart
- Paused after 5 failed deliveries in a row; Resume when the other system works again
For the other system's people
- A technical description is given by SmartMy support on request
- Lists can be read page by page and since a given time
Who uses it
Where you use it
- Web: Garage > Configuration > General > Integrations and Webhook Deliveries
- Not in the SmartMy Garage app
What you control
Settings
- Per connection: branches, what it may do (read job cards and vehicles, webhooks on; the rest off), 120 requests a minute, key expiry (none)
- Per webhook: address, events, signing secret
FAQ
Questions, answered.
Can our website create appointments directly?
Yes, if you tick Create Appointments on its connection. The appointment arrives in the branch it names, for an advisor to confirm.
How does the other system know a message is really from us?
Each message is signed with the webhook's secret, and carries a delivery ID. The receiver checks the signature.
What happens if the other system is down?
The message is sent again up to 8 times, from 1 minute up to 24 hours apart. After 5 failed deliveries in a row the webhook pauses until you click Resume.
Can a connection see all our branches?
Only the branches you choose on it, and only what you tick.
Related
Related features.
Enquiries from walk-ins, calls and your websiteFrom Growth
Note every call, walk-in, WhatsApp message and website request about a vehicle as an enquiry, before anything is booked. Each one has an owner who follows it up, and moves through New, Contacted, Quoted, Booked and Lost. It becomes an appointment or a job card in one click.
Appointments on a bay calendar with daily capacityFrom Growth
Book visits by customer, vehicle, services, time and bay. The booking warns when the bay is taken, the branch is closed or the day is full. The customer is reminded, the arrival opens the job card, and no-shows are counted.
Single sign-on on the web and in the staff appEnterprise only
Garage staff sign in with their company account, from Microsoft, Google or another OpenID Connect provider, on the web and in the SmartMy Garage app. An administrator adds the provider, people are matched to their users, and an Entity can close password sign-in for its staff.
Head office scorecards across branchesEnterprise only
Head office sees one scorecard per branch and month. It shows job cards, revenue split into labour and parts, average repair order, labour efficiency, comeback rate and approval rate. Compare branches for any dates with a group total, follow the trends, and give head office staff a role that only reads.
Fleet accounts on monthly creditFrom Scale
Taxi firms, leasing companies and delivery fleets get an account with a credit limit and their own approvers. Every job card carries a purchase order number. Their job cards are delivered without an invoice. They are billed once a month in one invoice with a section per job card, with a printed statement.
Want to see it on your own job cards? Book a demo and we walk you through it with your workshop's work.