Advanced

Integrations with OnBooq

Connect OnBooq to third-party tools to streamline your workflow and enhance lead management.

curl -X POST https://api.example.com/v1/enquiries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Interested in service",
    "phone": "+1234567890",
    "name": "Jane Smith"
  }'

const response = await fetch('https://api.example.com/v1/enquiries', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'Interested in service',
    phone: '+1234567890',
    name: 'Jane Smith'
  })
});

{
  "id": "enq_123abc",
  "status": "received",
  "created_at": "2024-10-15T10:30:00Z"
}

Overview

OnBooq integrates seamlessly with popular tools to automate notifications, sync bookings, and track leads. Use webhooks for real-time alerts, connect calendars for automatic scheduling, link CRMs for lead management, and leverage the API for custom solutions.

Webhooks

Receive instant notifications for new enquiries.

Calendars

Sync bookings with Google Calendar or Outlook.

CRMs

Push leads to HubSpot or Salesforce.

Custom API

Build tailored integrations.

Webhooks for Notifications

Set up webhooks to get real-time updates on new enquiries, bookings, and customer interactions.

Create Webhook

Navigate to Settings > Integrations > Webhooks.

Click "New Webhook" and enter your endpoint URL, like https://your-webhook-url.com/onbooq.

Select Events

Choose events: enquiry.created, booking.confirmed, enquiry.answered.

Test the webhook with the "Send Test" button.

Verify Payload

Check your endpoint logs for the incoming payload.

Use the sample below to handle it.

const express = require('express');
const app = express();
app.use(express.json());

app.post('/onbooq', (req, res) => {
  const { event, data } = req.body;
  console.log(`New ${event}:`, data.enquiry);
  
  // Send Slack notification or save to DB
  res.status(200).json({ received: true });
});

app.listen(3000);

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/onbooq', methods=['POST'])
def onbooq_webhook():
    data = request.json
    event = data['event']
    print(f"New {event}: {data['data']['enquiry']}")
    
    # Send notification or process lead
    return jsonify({'received': True}), 200

Secure your webhook with a signature header. OnBooq sends X-OnBooq-Signature: {signature}. Verify it using HMAC-SHA256 with your secret.

Calendar Integrations

Connect OnBooq to calendars for automatic event creation when visitors book.

Authorize

In OnBooq dashboard, go to Integrations > Calendars > Google.

Click "Connect" and grant permissions.

Map Fields

Map enquiry details: customer name to event title, preferred time to start time.

// Example booking payload sent to Google
{
  "summary": "Enquiry from John Doe",
  "start": { "dateTime": "2024-10-15T14:00:00" },
  "end": { "dateTime": "2024-10-15T15:00:00" }
}