> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.poly.ai/feedback

```json
{
  "path": "/integrations/liveres",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# LiveRes (Zonal)

> Connect your PolyAI agent to LiveRes for restaurant reservation management.

Connect PolyAI to [LiveRes](https://www.zonal.co.uk/products/liveres/), a restaurant reservation system owned by Zonal and widely used across the UK hospitality industry. Your agent can interact directly with LiveRes, letting callers make, modify, and cancel reservations through natural conversation.

<Note>This is a managed integration. Prepare the credentials below, then contact your PolyAI account manager to complete setup.</Note>

<Warning>LiveRes is being phased out by Zonal and replaced by Zonal Events. If you are setting up a new integration, check with your Zonal account manager whether LiveRes or Events is the active booking system for your property.</Warning>

## Capabilities

* **Check availability**: Query available time slots for specific dates, party sizes, and dining areas
* **Make reservations**: Create bookings with guest details, special requests, and occasion information
* **Modify bookings**: Update reservation details including time, date, party size, or special requirements
* **Cancel bookings**: Process cancellation requests with appropriate policies
* **Menu availability**: Check and communicate menu availability for specific booking times
* **Deposit requirements**: Retrieve deposit and card guarantee requirements for bookings

## Getting started

### Prerequisites

* An active LiveRes account with API access enabled
* Zonal API credentials
* Your outlet/restaurant ID(s)

### Step 1: Request API access

1. Contact your Zonal account manager to enable API access for your LiveRes account
2. You will receive:
   * **API Base URL**: Your LiveRes API endpoint
   * **Username and password**: For Basic Authentication
   * **Outlet list**: IDs for your restaurant locations

### Step 2: Configure authentication

LiveRes uses Basic Authentication. Provide the following to PolyAI:

* API endpoint URL
* Username
* Password (stored securely as a secret)
* Outlet IDs for each location

### Step 3: Define booking parameters

Work with your PolyAI representative to configure:

* Available booking areas (main dining, private rooms, bar, etc.)
* Party size limits
* Booking lead times and cutoffs
* Deposit requirements and policies
* Menu options and special experiences

## Dining areas

LiveRes supports multiple dining areas per venue. The voice agent can:

* Offer specific areas based on availability
* Handle area preferences from callers
* Fall back to alternative areas when first choice is unavailable

## Special requirements

### Occasions

LiveRes supports occasion tags for bookings. Common examples:

* Birthday
* Anniversary
* Business meeting
* Special celebration

### Deposit handling

For bookings requiring deposits or card guarantees:

* The voice agent will inform callers of deposit requirements
* Card details must be collected through secure channels (transferred to staff or online completion)
* Deposit policies are communicated based on your LiveRes configuration

## Limitations

* **Payment processing**: Card payments for deposits cannot be processed over voice; callers are directed to complete payment online or with staff
* **Complex modifications**: Significant booking changes may require human assistance
* **Menu pre-orders**: Detailed menu selections are typically handled post-booking

## Error handling

Common scenarios the integration handles:

| Scenario           | Response                                          |
| ------------------ | ------------------------------------------------- |
| No availability    | Offers alternative times/dates                    |
| Invalid party size | Requests correction or suggests alternatives      |
| Booking not found  | Asks for additional details to locate reservation |
| System timeout     | Gracefully informs caller and offers callback     |

## Support

For integration questions, contact your PolyAI account manager or reach out to PolyAI Support.

## Related pages

<CardGroup cols={2}>
  <Card title="DesignMyNight" href="/integrations/design-my-night" icon="champagne-glasses">
    Alternative restaurant and venue booking platform.
  </Card>

  <Card title="Managed services" href="/integrations/managed-services" icon="handshake">
    Other managed integrations requiring account manager setup.
  </Card>
</CardGroup>