Skip to main content

Simpro

The Simpro integration is built for trade and field-service businesses (plumbing, electrical, HVAC, and similar) that run their jobs and invoicing in Simpro. Once connected, Knock Knock can:

  • Let your AI voice agent create jobs in Simpro during a call, routed to the right cost centre.
  • Chase overdue invoices with outbound AI calls and log the outcome back on the invoice.
  • Turn Tapi work-order emails into Simpro jobs (see Tapi work orders below).

Connecting Simpro​

  1. Go to Integrations and find the Simpro card, then click Setup.
  2. Enter your:
    • Build URL — your Simpro address, e.g. https://yourbuild.simprosuite.com.
    • API Key — create one in Simpro under System Setup → API → Applications using the API Key authentication method, then paste it here.
  3. If your Simpro build hosts more than one company, pick which one to connect.

Once connected, the card shows the company name and build URL you're linked to. You can disconnect at any time; your data in Simpro is never deleted.

Cost-centre mapping​

The AI voice agent describes the work a caller needs in plain language ("blocked drain", "hot water not working"). Cost-centre mapping tells Knock Knock which Simpro cost centre each kind of job should be created under.

Open Cost Centres on the Simpro card to edit the mappings:

  • Job classification — the kind of work, in your own words (e.g. "Blocked drain").
  • Cost centre — the Simpro cost centre to create the job under (searchable from your Simpro build).
  • High ticket — when ticked, the voice agent never books this job itself; instead it routes the caller to a human callback. Use this for high-value or complex work you want a person to scope.

You can also set a default cost centre as a fallback for classifications you haven't mapped.

In-call job creation​

When the AI voice agent is handling a call, it classifies the work the caller describes and — if that classification isn't marked High ticket — creates the Simpro job during the call, under the mapped cost centre. The job appears in your Simpro build straight away, so a tech can pick it up without anyone re-keying the details.

For high-ticket classifications, the agent collects the details and routes the caller to a human callback instead of booking the job automatically.

Automatic job tags​

Jobs the AI creates in Simpro are tagged automatically: the AI reads the job description and picks the single best-matching tag from your own build's tag list. This applies to jobs booked over the phone and to jobs created from Tapi work-order emails alike, so your Simpro reporting and workflows keep working without anyone tagging jobs by hand.

Invoice chasing​

Invoice chasing places outbound AI calls to customers with overdue Simpro invoices and records the outcome on the invoice. Open Invoice Chasing on the Simpro card to configure and monitor it.

Settings​

  • Chase overdue invoices — the master on/off switch. Calls are placed on weekdays, within your call window, in your company timezone.
  • Outbound agent — which AI agent makes the calls.
  • Max call attempts and Days between attempts — how persistently to retry an unanswered invoice.
  • Grace period (days past due) — how long to wait after an invoice falls due before the first call.
  • Minimum balance to chase — only chase invoices at or above this amount.
  • Call window start / end — the hours (24-hour, in your timezone) during which chase calls may be placed.

Customers flagged Do Not Call in Simpro are never called.

Call queue​

The queue lists invoices in the chase pipeline with their balance, due date, attempt count, and status:

  • Calling — a call is in progress right now. Use Listen to listen in live.
  • Pending / Retry — waiting for the next attempt, with the scheduled time shown.
  • Done / Paid — chasing complete.
  • Failed / Skipped — didn't complete; a short reason or last error is shown.

For finished calls, open the Transcript to read the conversation, play the recording, and see the call summary. You can Skip an invoice you don't want chased, or Call again to requeue one.

Tapi work-order emails​

If you receive work orders from Tapi, Knock Knock can read them from email and turn them into Simpro jobs. Tapi has no API, so the integration reads work-order emails from a dedicated mailbox.

Connecting Tapi​

  1. Forward (or route) your Tapi work-order emails to a dedicated inbox.
  2. On the Tapi card, click Setup and enter the mailbox details:
    • Email provider — pick your provider (Gmail / Google Workspace, Outlook / Microsoft 365, Yahoo, iCloud, Zoho, or custom) for provider-specific instructions.
    • IMAP host, Port, and Folder — the mailbox connection details (e.g. imap.gmail.com, port 993, INBOX).
    • Mailbox email and App password — use an app password, not your normal account password.
    • Tapi sender filter — only emails from this sender (e.g. @tapihq.com) are treated as work orders.

When connected, the card shows the mailbox it's reading.

Work orders​

Open Work Orders on the Tapi card to see the emails that have been read. Use Check now to poll the mailbox immediately. For each work-order email you can:

  1. Extract fields — pull the structured job details (job number, address, description) out of the email.
  2. Create Simpro job — create the job in Simpro from the extracted details. Once created, the row shows the Simpro job number.