Webhooks

Jam Webhooks allow you to receive real-time notifications when key events happen in your workspace.

Webhooks allow you to connect Jam to external systems and receive real-time notifications when key events occur. This makes it possible to automate workflows, trigger actions in Intercom, or log events in your internal systems without relying on polling.

Webhooks are currently in beta. To enable access for your workspace, please contact our Sales team.

---

🧪 Supported Events (Beta)

At this stage, Jam supports two events related to the Intercom workflow:

• intercom.recorder.recorded – fired when a customer records and submits their screen.

• intercom.recorder.opted_out – fired when a customer chooses not to record their screen.

More events will be added as we expand the webhook beta.

---

Sample Payloads

All webhook events share the same general structure:

• id – unique identifier for the event.

• type – the event type (e.g. intercom.recorder.recorded).

• created_at – timestamp of when the event occurred.

• data – object containing event-specific information.

Example (intercom.recorder.recorded):

{
  "id": "evt_12345",
  "type": "intercom.recorder.recorded",
  "created_at": "2025-09-09T12:00:00Z",
  "data": {
    "conversationId": "215470686832743",
    "jamId": "9573a43b-3ec9-49ab-b7e4-bf6cfc4bdfc",
    "recording_url": "https://jam.dev/r/rec_12345"
  }
}

---

The Webhooks Tab in Jam Dashboard

Inside the Jam Dashboard, you’ll find a dedicated tab for Webhooks under: Settings → Integrations → Webhooks

From this tab you can:

• Create and manage endpoints.

• Subscribe to supported events.

• Monitor active integrations.

---

The Webhook Portal

Beyond the initial configuration, you can monitor and debug deliveries in the Webhook Portal. It allows you to:

• View logs of all delivery attempts (success and failure).

• Replay events that failed to deliver.

• Access your Signing Secret to validate incoming requests.

• Monitor statistics such as delivery success vs failure rates.

• Inspect messages and see full payloads with headers.

---

How to Configure

1. Creating a Manual Endpoint

1. Go to Settings → Integrations → Webhooks → Manage.

2. Click Add Endpoint.

1. Enter your endpoint URL.

2. Select the events you want to subscribe to (e.g. intercom.recorder.recorded, intercom.recorder.opted_out).

3. Click Create.

---

2. Using Connectors

In addition to generic endpoints, Jam also provides specific connectors for popular integrations like Intercom.

a) Intercom Fin Connector

If you’re integrating with Intercom Fin:

1. In the Webhook dropdown, select Intercom Fin.

2. Paste the URL you copied from Intercom.

3. Under Subscribe to Events, ensure only the following are checked:

   • intercom.recorder.recorded

   • intercom.recorder.opted_out

4. Click Create.

That’s it — Jam will now send Intercom events directly into your workflow.