Acuity Scheduling Integration

HiLucy integrates with Acuity Scheduling to let you offer time-based services and experiences that guests can book directly. Whether it is spa treatments, guided tours, restaurant reservations, or private excursions, Acuity handles the scheduling while HiLucy handles the guest-facing experience.

How It Works

The integration syncs your Acuity account data into HiLucy's database, making your services available through the Guest Portal and LucyAI:

1. You configure appointment types, calendars, and products in Acuity Scheduling
2. HiLucy syncs that data into local database tables for fast retrieval
3. Guests discover activities through the Explore tab or by asking LucyAI
4. LucyAI can search and book activities on behalf of guests during conversation

Setting Up the Integration

1. Get Your Acuity API Credentials

In your Acuity Scheduling account, navigate to Integrations > API and note your:

• User ID -- your Acuity account identifier
• API Key -- the secret key for API authentication

Each property (listing) in HiLucy can have its own Acuity credentials, allowing different properties to offer different activity catalogs.

2. Configure in HiLucy

From the WordPress admin, edit your listing and locate the Acuity Integration metabox:

• Enable Acuity -- toggle the integration on for this listing
• User ID -- enter your Acuity user ID
• API Key -- enter your Acuity API key

Save the listing to store the credentials.

3. Sync Your Data

Click the Sync Now button in the Acuity Integration metabox. HiLucy will pull from the Acuity API and populate three local tables:

• Appointment Types -- your services (e.g., "60-Minute Massage", "Sunset Sailing Tour")
• Calendars -- your availability calendars (e.g., "Spa Calendar", "Tours Calendar")
• Products -- add-on packages and extras attached to appointment types

Syncing typically completes in a few seconds. You can re-sync at any time to pick up changes made in Acuity.

4. Webhook Configuration

HiLucy provides a webhook endpoint at /hilucy/v1/acuity-webhook for real-time updates. Configure this URL in your Acuity account under Integrations > Webhooks to receive instant notifications when appointments are booked, rescheduled, or canceled.

Guest Booking Flow

Once synced, activities appear in the Guest Portal's Explore tab. The booking process works like this:

1. Guest browses available activities or asks LucyAI "What can I do today?"
2. Lucy searches your synced appointment types and presents matching options with availability
3. Guest selects a time slot and confirms the booking
4. Acuity creates the appointment and sends confirmation to both guest and provider

LucyAI uses three dedicated tools to handle this flow: searching available activities, fetching detailed information about a specific activity, and completing the booking -- all through natural conversation.

Per-Listing Configuration

Because each listing stores its own Acuity credentials, you can:

• Offer different activities per property -- a beachfront villa shows water sports while a mountain cabin shows hiking tours
• Use different Acuity accounts -- if you work with multiple activity providers, each listing can connect to a different account
• Enable selectively -- only activate Acuity for listings where you have activities to offer

Managing Synced Data

All synced data is stored locally for fast access:

| Table | Contents | |-------|----------| | Appointment Types | Service name, duration, price, description, category | | Calendars | Calendar name, timezone, associated appointment types | | Products | Add-on packages, pricing, linked appointment types |

Changes made in Acuity (new services, updated pricing, removed calendars) are reflected in HiLucy after the next sync. Use the Sync Now button or wait for the webhook to trigger an automatic update.