Connecting your own tools, 3 min read

Send events to your own system (webhooks)

Get a signed message on your own server when a call is analyzed, a lead turns hot or a follow-up is due.

Updated

A webhook is a message ListenFox sends to an address on your server the moment something happens. Your CRM, a script, or a tool such as n8n, Zapier or Make can act on it straight away.

Add an endpoint

  1. Open Settings → Webhooks and click Add endpoint.
  2. Paste the address that should receive events. It must start with https:// and be reachable from the internet.
  3. Choose the events you want, or all of them.
  4. Save, then copy the signing secret. It’s shown once. Your server uses it to check that each message really came from us.
  5. Click Send a test event to check that your server answers.

The events

  • Call created: a call arrived.
  • Call analysed: a call was read, with everything we found in it.
  • Call failed: a call couldn’t be processed, for example because the recording link was broken.
  • New hot lead: a caller became a hot lead for the first time.
  • Follow-up created, and follow-up due.
  • Trigger fired: one of your triggers matched a call.
  • Order matched to a call: a store order was linked to a call before it.
  • Daily brief ready: the morning brief is ready.

If your server is down

We try each message again 7 more times over about two days. After 8 failed tries in a row, the endpoint is turned off and the workspace’s owners and admins get an email. Fix the server, then turn the endpoint back on. The delivery log on the same page shows every message from the last 30 days, with its status and a Retry now button.

For developersHeaders, example messages and signature checks in Python and Node are in the developer docs at listenfox.com/developers/webhooks.

Webhooks reference for developers

More in “Connecting your own tools”

All help articles