Your phone system sends each finished call to Repairy. Calls show on the shop's Calls page under your system's name.Dashboard setup: Settings → Integration → Webhooks → Call history.How it works#
1.
Turn on Call history for the shop and copy the Webhook URL and Secret.
2.
Your phone provider POSTs each finished call to that URL with the secret.
3.
Repairy saves the call in Call History (or links it to an existing Carrier/Chloe call).
Webhook URL and Secret#
POST https://<api host>/api/webhooks/calls/:shopId
Authenticate with the per-shop secret from the Call history page:Header x-webhook-secret: <secret>, or
Authorization: Bearer <secret>
Use Show / Copy / Rotate on the Secret row in the dashboard. Rotating invalidates the previous secret.Live / Dev mode#
Next to the on/off switch:Live — calls are saved to Call History (and missed-call SMS may send when enabled).
Dev — requests are checked and listed under Received calls for 24 hours as what would be saved, but nothing is saved and no SMS is sent. Invalid payloads still return 400.
Setup guide and docs#
On the Call history page:Setup guide — payload fields, call types, and sample JSON / cURL
Repairy API Documentation — this partner docs site
How duplicate calls are handled#
If the shop also has a Repairy line (Carrier) or Chloe, the same call can arrive twice. When a webhook call matches an existing Carrier/Chloe call with the same customer number and direction that started within 2 minutes, Repairy links your details onto that call instead of creating a second one. No extra SMS is sent. It is safe to send every call.The dashboard includes How duplicate calls are handled with examples (same call counted once, caller calls back, caller dials the shop directly).Send missed-call SMS#
Optional toggle on the Call history page: Inbound missed calls only. It also needs Missed call follow-up on in Call handling. Re-sending the same callId updates the call and does not send a second SMS.Auto transcribe and Call scoring#
These follow the shop's existing Call recording / Call scoring settings (read-only status on the Call history page, with links to change them elsewhere).Transcripts sent by your provider are always used.
If you send only a recordingUrl, Repairy may transcribe when Call recording is on.
There is no summary field — Repairy writes the summary, action items, and score.
What to send#
Finished calls only (ringing / in-progress → 400). Required fields: callId, direction, status, from, to, startedAt. Optional: recording, transcript, staff (answeredBy), line, provider name, and more — see Call History Webhook.| Call | direction | status |
|---|
| Inbound answered | inbound | answered |
| Inbound missed | inbound | missed, voicemail |
| Outbound answered | outbound | answered |
| Outbound unreached | outbound | no-answer, busy, failed, canceled |
Responses#
| Status | Meaning |
|---|
| 201 | At least one call was created |
| 200 | Updated, linked, or logged as test / Dev mode |
| 400 | Validation failed |
| 401 | Webhook off, or wrong secret |
Modified at 2026-11-09 10:12:10