Skip to main content

Booking Flow Integration

Learn how to integrate Skaala’s AI-powered booking system into your application.

Overview

Skaala’s booking system enables customers to schedule appointments through natural conversation with your AI receptionist. The system handles:
  • Availability Checking: Real-time calendar integration
  • Slot Booking: Automatic reservation and confirmation
  • Conflict Prevention: Double-booking protection
  • Customer Notifications: SMS/email confirmations

Integration Steps

1

Configure Services

Define your bookable services with duration and pricing
curl -X POST https://www.skaala.ai/api/v1/services \
  -H "X-API-Key: sk_live_..." \
  -d '{
    "name": "Haircut",
    "duration_minutes": 60,
    "price": 500
  }'
2

Connect Calendar

Link your Google Calendar or Outlook calendar for availability sync
3

Configure Agent

Set up your AI agent to handle booking requests naturally
4

Test Booking Flow

Call your Skaala number and request an appointment

Webhook Events

Monitor booking events in real-time:
// Listen for new bookings
app.post('/webhooks/skaala', (req, res) => {
  const { event, data } = req.body;

  if (event === 'booking.created') {
    console.log('New booking:', data);
    // Send confirmation email
    // Update internal systems
  }

  res.status(200).send('OK');
});

Best Practices

Add 10-15 minute buffers to prevent scheduling conflicts
Require customer phone/email before confirming bookings
Configure cancellation windows and automated reminders

Bookings API

Full API reference for booking endpoints

Webhooks Guide

Set up real-time event notifications