Enable your AI agent to book appointments through Square Appointments with a complete multi-step flow including service selection, staff preferences, time slots, and optional payment.
8 min read
Updated October 2026
The Square integration enables full appointment booking directly through your AI agent. Customers can browse services, select staff members, choose available time slots, and optionally pay, all through a guided conversational flow.
This is one of our most powerful AI Actions, providing a complete booking experience that rivals dedicated booking websites.
When a customer asks to book an appointment, the AI initiates an interactive flow with rich UI elements:
The flow state is preserved, so customers can take their time without losing progress. Sessions expire after 30 minutes of inactivity.
Available actions depend on your agent type and plan. Customer-facing actions serve customers. Internal team actions are for authenticated team use. AI CoPilot is Enterprise-only. Plus enables up to 5 actions per agent, Pro enables 40, and Enterprise has no enabled-action limit.
| Action | Description | Audience |
|---|---|---|
| Book Appointment | Book an appointment via Square | Customer-facing |
| Book Appointment Copilot | Book an appointment for a customer (CoPilot staff-initiated, single-step) | Internal team |
| Cancel Booking | Allow users to cancel an existing Square appointment through the chat | Customer-facing |
| Get Bookings | List upcoming appointments for the business (CoPilot internal use) | Internal team |
| Get Customer | Get a Square customer's full profile and recent booking history (CoPilot internal use) | Internal team |
| Get Payments | List recent payments and revenue summary (CoPilot internal use) | Internal team |
| Reschedule Booking | Reschedule an existing appointment to a new date/time (CoPilot internal use) | Internal team |
| Search Customers | Search Square customers by name, email, or phone (CoPilot internal use) | Internal team |
Before setting up the Square integration, you'll need:
The Square integration uses OAuth for secure authentication. This means you authorize ChatSpark to access your Square data rather than manually entering API keys.
If you have multiple Square locations, you can specify which one to use. If not specified, the AI will ask customers to select a location or automatically detect based on context.
Here's what customers experience when booking through your AI Agent:
If you have multiple locations, customers choose where they want to book. Single-location businesses skip this step.
Customers see a carousel of available services with:
They can also type a service name or ask the AI for recommendations.
Customers can choose a specific staff member or select “Any available.” The AI uses fuzzy matching to understand names like “I want to see Sarah” or “book with the same person as last time.”
An interactive calendar shows available time slots based on:
Customers can also use natural language like “next Tuesday afternoon” or “this weekend.”
A form collects:
If your services require prepayment or a deposit, customers enter their card details through Square's secure payment form. Payment is processed via Square. ChatSpark never sees card details.
Customers see a summary of their booking and receive confirmation. The booking is created in Square Appointments and appears on your calendar.
After setup, test the booking flow:
Ensure your Square location has services configured with “Online booking” enabled in Square Appointments settings.
Try disconnecting and reconnecting your Square account. Make sure you're logging into the correct Square account.
Check that staff members are assigned to services and have availability set in Square. The AI can only show times when staff are available.
Verify your Square account has payment processing enabled and is in good standing. Test payments may not work in sandbox mode.