Enable appointments
Dashboard → Widget Settings → Appointments. Turn on booking and set slot duration, advance window, and minimum notice.
Developer documentation
Appointment Booking
Let visitors book appointments inside the Wiretalk chat widget. Configure slots, bot follow-up buttons, availability API, and agent inbox management.
Dashboard: Widget Settings → Appointments
Let visitors book time slots directly inside the chat widget — no external Calendly link required. The most common setup is a Book a demo button on your welcome bot or FAQ reply. Appointments respect your business hours, show green available slots and red booked slots, and work from bot quick replies or AI follow-up buttons.
Book a demo — quick setup
Add a bot button
Edit your welcome or pricing bot template and add a follow-up button with type appointment and label Book a demo. See Bot follow-up buttons below.
Pre-fill visitor details (optional)
On logged-in pages, pass visitor: { name, email, phone } in window.wiretalkConfig so the slot picker skips identity fields — see the embed identity guide.
Enable & configure
Open Appointments settings
Dashboard → Widget Settings → Appointments. Toggle booking on for your site.
Set slot rules
Configure duration, interval between slots, buffer time, how far ahead visitors can book (advance_days), and minimum notice (min_notice_hours).
Confirm business hours
Slots are generated only during your weekly schedule. Set timezone and hours under Widget Settings → Online schedule.
Visitor experience
In-chat picker
Visitors pick a date, see all slots for that day, and confirm a time. Available slots are selectable (green); already booked slots appear disabled (red).
Identity capture
Booking requires a visitor name or email. If your pre-chat form collects these, they are reused automatically — including values pre-filled from wiretalkConfig.visitor or data lookup login. Otherwise inline fields appear in the picker.
Bot & AI buttons
Add an Appointment picker follow-up button on bot templates, or let AI suggest booking when configured. See Bot follow-up buttons.
Agent inbox
View upcoming bookings under Widget Settings → Appointments in the agent dashboard. Update status (pending, confirmed, cancelled, completed) and add notes.
Bot follow-up buttons
When editing a bot reply template, add a follow-up button with type appointment:
{
"type": "appointment",
"label": "Book a demo"
}When the visitor taps the button, the widget opens the appointment picker inline. Standard quick-reply buttons use "type": "button" and send a text message instead.
Widget config
The embed bootstrap exposes appointment settings under config.appointments (enabled flag, duration, advance window, timezone). The widget calls the availability and book endpoints automatically — custom embeds rarely need to call these directly.
API
Full request/response examples are in the API reference → Widget appointments and Agent appointments sections.
| Endpoint | Purpose |
|---|---|
POST /api/widget/appointments/availability | List slots for a date (available, status per slot) |
POST /api/widget/appointments/book | Book a slot (requires visitor name or email) |
GET /api/agent/appointments | List organization appointments |
PATCH /api/agent/appointments/{id} | Update status or notes |
GET/PATCH /api/agent/appointment-settings | Read or update slot rules |