Connect ServiceM8 to Pivra

What this integration does

When a visitor submits their details in your chatbot (either via the lead capture form or a quote request), Pivra automatically creates a new job in ServiceM8 with:

• Job status: Enquiry
• Contact name, email, and phone
• Company / billing name (if provided)
• A job description containing the enquiry source and any quote details (suburb, service type, urgency, property type, etc.)

This means your team sees a fully populated job in ServiceM8 the moment someone enquires — no manual data entry.

---

Before you start

You need:

• A ServiceM8 account (any plan)
• A ServiceM8 private app API key with permission to create jobs

---

Step 1 — Get your ServiceM8 API key

Follow ServiceM8's current developer getting-started guide to create or obtain a private app API key. ServiceM8 controls the exact account screens and permission workflow, so use its documentation if the labels differ from older screenshots.

Keep your API key private — it gives full access to your ServiceM8 account.

---

Step 2 — Connect in Pivra

1. Go to Dashboard → Integrations
2. Find ServiceM8 under Field Service & Trades and click Connect
3. Paste the Private app API key
4. Click Connect

---

Step 3 — Test the integration

1. Click Test on the ServiceM8 integration card
2. Log in to ServiceM8 and go to Jobs
3. A new job called "Enquiry via Pivra chatbot (Test Chatbot)" should appear within a few seconds
4. Open it — you'll see the test contact details in the job fields and description

---

How quote request fields appear

If you have Quote Requests enabled on your chatbot, the quote details are automatically written into the job description. For example, a tradie chatbot might produce:

Enquiry via Pivra chatbot (My Plumbing Bot)
Email: jane@example.com
Phone: 0412 345 678

Suburb: Bondi Junction
Service Needed: Burst pipe
Description: Kitchen pipe burst under sink, water everywhere
Urgency: Emergency
Property Type: House

No extra configuration needed — any fields you add to your quote form appear here automatically.

---

Frequently asked questions

Does Pivra create a client record in ServiceM8? Not automatically — ServiceM8 links the job to an existing client if the email matches, or leaves it unlinked. You can manually assign the client from the job view.

What if the test job doesn't appear?

• Generate a fresh private app API key and confirm that it can create jobs
• Make sure your ServiceM8 account is active
• Check the error message on the integration card (click Test again to refresh)

Can I connect multiple chatbots to ServiceM8? Yes. Each chatbot can have its own integration, or you can connect one integration to all chatbots (leave Chatbot field as "All chatbots").

Does it work for quote requests as well as contact leads? Yes — both lead.captured events (contact form and quote request) trigger the integration. Quote fields appear in the job description automatically.