Webhooks

Webhooks overview

Webhooks send each call and conversation Jodie handles to a URL you choose, the moment it finishes. Use them to create leads in your CRM, post to a team channel, start a workflow in Make or n8n, or store activity in your own database.

Each delivery is a signed POST request with a JSON body. You manage webhooks in the Jodie app under Manual Setup › Integrations › Webhooks, where you can also send test events, read a 7-day delivery log and redeliver any request.

Which plans include webhooks

PlanWebhooks
Free trialIncluded
BasicNot included. The Webhooks card is shown locked, with an upgrade prompt.
ProfessionalIncluded
PremiumIncluded
EnterpriseIncluded

Accounts run by a white-label partner don't have webhooks. If webhooks were switched on for your account before they came with plans, you keep them on any plan.

Webhooks or Zapier?

The Integrations page in the app has a card for each. Pick the one that fits how you work:

WebhooksZapier
PlansProfessional, Premium, Enterprise and trialsProfessional, Premium, Enterprise and trials
What's sentCalls, WhatsApp, email and website chatNew calls and WhatsApp conversations
Where it goesAny public HTTPS URL: your own app, or a webhook trigger in Make, n8n or similarThousands of apps in Zapier's directory, such as HubSpot, Google Sheets and Salesforce
Set-upPaste a URL. Code is only needed if you build your own receiver.Build a Zap. No code.
SecurityEvery request is signed with your endpoint's secretHandled by Zapier
Debugging7-day delivery log, test events and redelivery in JodieZap history in Zapier

You can use both at the same time.

How it works

  1. You add an endpoint URL and choose which activity it receives. All activity is the default.
  2. When a call ends, or a WhatsApp, email or website chat conversation closes, Jodie sends a POST request to every endpoint that wants that kind of activity.
  3. Your endpoint checks the Signature header, reads event_type from the body, and replies with any 2xx status within 3 seconds.
  4. If it doesn't, Jodie retries twice more. Every attempt is recorded in the endpoint's delivery log for 7 days.

Activity types

Every request body has an event_type field that says what kind of activity it is. The same value is also sent in the Event-Type header.

Activityevent_typeSent when
Callnew_callA call ends, with the transcript and the details collected
WhatsApp conversationnew_whatsapp_conversationA WhatsApp conversation closes, with every message
Email conversationnew_email_conversationAn email conversation closes, with every message
Website chatnew_web_conversationA website chat closes, with every message and the visitor's details

An endpoint set to All activity also receives any new kinds of activity added later, so write your receiver to ignore an event_type it doesn't recognise rather than fail. An endpoint set to Choose activity only receives the types you tick.

The request

PropertyValue
MethodPOST
Content typeapplication/json
Timeout3 seconds
Attempts3 in total: the first try, then after about 10 seconds and about 2 minutes
RedirectsNot followed. A 3xx response counts as a failed delivery.
TLSHTTPS only, with certificate verification

Headers

HeaderExampleWhat it's for
Signature5f2b0c…e91aHMAC-SHA256 of the raw request body, keyed with the endpoint's signing secret, as lowercase hex. Verify it on every request.
Event-Typenew_callThe kind of activity, the same as event_type in the body.
Delivery-Idwhd_d6a3277991f74c498843Unique per delivery. Use it to ignore duplicates.
Account-Idcom_33f0ee0d636d4530b09bYour Jodie account ID.
Test-EventtrueOnly sent on test events.
Content-Typeapplication/jsonThe body format.
User-AgentThe app nameIdentifies requests from Jodie. Don't rely on its exact value; check the Signature instead.

Limits

  • Endpoint URLs must be public https:// addresses. Private and local hosts (such as localhost, IP addresses and .local or .internal names) are rejected.
  • URLs can be up to 255 characters.
  • Each account can have up to 10 endpoints. Each one gets its own signing secret and receives its own copy of every delivery.
  • Delivery history is kept for 7 days.

Next steps

Need a hand?

Our team can help you connect Jodie to your systems.

Email [email protected]