Send Events

Send Events forwards all agent communication events — inbound and outbound, across all channels — to a webhook URL you specify. Use this to sync conversations with your CRM, trigger workflows, or build custom integrations.

Configuration

Navigate to your Agent → Advanced tab and enter your webhook URL.

How it works

Every time your agent sends or receives a message (or call), BookedIn POSTs a JSON payload to your webhook URL containing the event details, lead information, and channel-specific metadata.

Request format

POST https://your-webhook-url.com/endpoint
Content-Type: application/json
User-Agent: Backend-System-Webhook/1.0

Base payload structure

Every webhook follows this base structure:

1
{
2
  "event": {
3
    "id": "evt_abc123",
4
    "channel": "sms",
5
    "timestamp": 1706640000.0,
6
    "data": { }
7
  },
8
  "lead_id": "lead_xyz789",
9
  "lead_contact": {
10
    "number": "+15551234567",
11
    "email": "john@example.com",
12
    "name": "John Doe"
13
  },
14
  "business_id": "biz_123",
15
  "lead_created": false
16
}

Base fields

Direction values

Channel payloads

Each channel has specific fields in event.data. See detailed documentation:

Receiving webhooks

1
const express = require('express');
2
const app = express();
3
4
app.use(express.json());
5
6
app.post('/bookedin-webhook', (req, res) => {
7
  const { event, lead_id, lead_contact } = req.body;
8
  
9
  console.log(`${event.channel} - ${event.data.direction}`);
10
  
11
  // Always respond quickly
12
  res.status(200).json({ received: true });
13
  
14
  // Process asynchronously
15
  processEvent(event);
16
});