# Bókun

The integration with Bókun allows Chaty to:

* Get Experience Information - To allow Chaty to answer questions about your experiences
* Check Availability for Experiences - To allow Chaty to check and give availability options to bookers
* Make Bookings (Including Custom Fields and Special Requirements)
  * Pay with a Credit Card
  * Customers can choose a 'Pickup' and 'Drop-off' location 
* Manage Existing Bookings 
  * Cancel Bookings  - Allows the cancellation of bookings that don't have payments associated with them outside the cancellation window.
  * Modify Bookings - Cancels the old booking and creates a new one if there's no payments associated with it, and if it's outside the cut-off period.
  * Confirm a booking 

### Setting up your Bókun Integration with an API key

To setup your Bókun integration, you'll need create an API key in your [Bókun.io](https://www.bokun.io) account. To do this;

1. Navigate to [Bókun](https://extranet.bokun.io/app/signin?from=%2F)
2. Update each of the bookings in Bókun and ensure that phone number is a requested for new bookings (If it isn't already) by:
   1. Navigating to *Experiences > Experiences Overview* > then edit the Experience
   2. Toggle "*Show Additional Options*"
   3. Click on "Booking" and toggle on the phone number as a field (You can decide whether it's required or not).
3. Then, click on the Settings cog in the bottom left, then **Connections**, then **API Keys**
4. Click Add and then complete the form, including:
   1. Title: "Chaty" 
   2. User role: Admin 
   3. Booking channel: "Default Channel". (You can create a custom one for Chaty in Settings > Sales Settings > Booking Channel)
5. Once you have the API key and Secret, 
   1. Login to Chaty, 
   2. Click on "Integrations", and search in the Marketplace for Bókun. 
   3. Click on the Install button, and Paste the API key and Secret from Bókun into Chaty and click "Install".
6. Choose the products available to Chaty - Once Bókun is installed, you need to choose the products that Chaty will be able to book. 
   1. Click on the "Products" tab within Bókun the integration settings
   2. If the products are not listed, click on the "Sync Products" button to download the products from Bókun
   3. Click on the tick box next to each product you want to be available to Chaty. 
   4. If a product is named something that you'd like to change or you want to update the product description to help Chaty understand more about it, click on Edit next to each product to make the change.

**Booking Links:**

To create a public booking page in Bókun for your experiences, please follow the steps below:

1. Log in to your Bókun Dashboard
2. Navigate to Agents > Booking Areas
3. Click “Add”
4. Enter a 'Title' for your booking area
5. Select the 'Product List' containing the experiences you would like customers to view and book
6. Click Save
7. Click on the tab "Agents Using this Area", and Add an agent
8. Complete the form, to create a new Agent for Chaty. Ensure you;
   1. For Booking Area, choose "Chaty"
   2. Subdomain - input a unique value here that bokun will use to create you a booking link
   3. Public Area - Tick this field to ensure the booking link is public on the internet.
9. Once you click "Save" you'll need to choose "Enabled" for the status.\
   \
   Once created, Bókun will generate a public-facing booking area link that customers can use to browse and book your experiences.\
   \
   Your Company Alias is the unique subdomain used for your Bókun account and booking pages. You need to add this Alias into the integration settings in Chaty on the settings tab within the Bokun integration.\
   \
   Example: If your subdomain was "chatybookings" the Bókun booking page URL is:\
   \
   [`https://chatybookings.bookingarea.bokun.io/booking-area/`](https://demo.bokun.io/booking-area/)`...`\
   \
   Then your Company Alias (that's added to Chaty) would be: `chatybookings.bookingarea`

**Payments**

Chaty is unable to use Bókun system to take payments. Instead you'll need to use [Chaty Pay](/account-settings/chaty-pay.md). Chaty pay utilises Stripe to take payments and costs 0.30c per payment (excluding any Stripe Fees processing fees).

The integration currently doesn't support payments with vouchers or discount codes. This feature is coming soon.

**Pickups**

If you want Chaty to collect pickup information from a booker, you need to enable it for each product. To do this, navigate to Integrations on the left menu, then click on the Bókun integration and then on the Products tab.

For each product you want to enable pickups for, click "Edit" then tick the checkbox "Allow pickups"

**Cancellations & Booking Cut Offs**

Chaty can cancel bookings (that don't have payments associated with them) and stop creating new bookings up to a certain time before the session starts. By default, this session will be auto-filled with your settings from your Bókun cancellation policy (In Settings > Product Extensions > Refunds and Cancellations).

You can override this setting in Chaty:

1. Navigate to Integrations > Edit your Bókun Integration > then click on the Product you wish to set the cancellation policy for. 
2. To configure cancellations: Tick "Allow Cancellation", and then set the number of minutes/hours or days cancellations can be made up until. 
3. To configure Booking Cut-offs: Set the number of minutes/hours or days bookings can be made up until a session starts. For instance, if you set 60 minutes, no bookings will be taken via Chaty if it's within an hour of the session starting.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chaty.ai/integrations/bokun.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.