Reservation Skill
Enable your agents to manage bookings, table reservations, and calendar slots automatically.
This guide begins with Overview, continues through How to use, Managing calendar, Connecting your calendar to Google Calendar, and finishes with Customization options.
Overview
The Reservation Skill lets your agents accept, modify, and cancel bookings on behalf of your business. It supports:
- Restaurant table reservations
- Appointment scheduling
- Event registration
- Room booking
All through natural language commands.
How to use
Install the skill from the Skill Marketplace, then assign it to any agent. Once active, your agent will respond to booking requests automatically.
Example interactions:
Customer: "I'd like a table for 4 at 7pm tomorrow"
Agent: "I've booked a table for 4 at 7:00 PM on Feb 19.
Confirmation #BK-2847. See you then! π"
Customer: "Can I change that to 8pm?"
Agent: "Done! Your reservation is now at 8:00 PM.
Updated confirmation sent to your email."
The skill creates a reservation record and sends a confirmation message to both the customer and your team.
Managing calendar
The skill maintains its own internal calendar viewable at Agent β Skills β Reservation β Calendar View.
You can manually:
- Block time slots β right-click any slot and select "Block"
- Set capacity limits per hour (e.g., max 10 tables per hour)
- Define blackout dates for holidays or maintenance
{
"capacity": {
"default": 10,
"peak_hours": {
"18:00-21:00": 15
}
},
"blackout_dates": [
"2026-12-25",
"2026-01-01"
]
}
Connecting your calendar to Google Calendar
Go to Skill Settings β Integrations β Google Calendar and click Connect. After the OAuth flow, the skill will sync all reservations bi-directionally.
Changes in Google Calendar will automatically update the reservation system and vice versa.
| Direction | Sync Interval | Conflict Resolution |
|---|---|---|
| Botonom β Google | Real-time | Botonom wins |
| Google β Botonom | Every 30s | Last write wins |
Customization options
- Confirmation templates β customize the message sent to customers
- Auto-reminder β send reminders 1h, 2h, or 24h before the reservation
- Waitlist β enable a waitlist when all slots are full
- No-show policy β automatically mark no-shows after a configurable grace period
Example reminder template:
Hi {{customer_name}},
This is a friendly reminder about your reservation:
π
**Date:** {{date}}
π **Time:** {{time}}
π₯ **Party size:** {{party_size}}
Reply "cancel" to cancel, or "change" to modify.
API reference
| Method | Endpoint | Description |
|---|---|---|
POST | /skills/reservation/book | Create a new reservation |
PUT | /skills/reservation/:id | Modify an existing reservation |
DELETE | /skills/reservation/:id | Cancel a reservation |
GET | /skills/reservation/slots | List available slots |
Example β create a reservation:
curl -X POST \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"date": "2026-02-19",
"time": "19:00",
"party_size": 4,
"customer": {
"name": "Jane Smith",
"phone": "+1234567890"
}
}' \
https://api.botonom.com/v1/skills/reservation/book
