# ROLLER The integration with ROLLER allows Chaty to: * Get Product Information * Check Availability for products * Make Bookings (Including Custom Fields) * Manage Existing Bookings (Requires the caller to know their booking code) * Cancel Bookings (According to [cancellation policies](#cancellations-and-booking-cut-offs)) * Modify Bookings (Prior to [cut-off periods](#cancellations-and-booking-cut-offs)) * Confirm a booking (Prior to cut-off periods) ### Setting up your ROLLER Integration To setup your ROLLER integration, you'll need to first get your ROLLER API key, which authorises Chaty to access your booking data. ROLLER have information about [accessing the API feature](https://mysupport.roller.software/hc/en-us/articles/360003171476-ROLLER-API-FAQ#h_01JNQJR1BWTBZDHM1AYM3XE0BZ) if you don't have it - in which case contact [success@ROLLERdigital.com](mailto:success@rollerdigital.com) to help you set it up. If you already have access to create API keys, follow these instructions. This process can take up to 5 days to organise. 1. Login to [ROLLER](https://my.roller.app/) 2. Navigate to **Venue Manager**, then on the left menu, **Settings > Integrations > API Keys** 3. Click on **Create client key** 4. In the popup screen, select "API Key" and name the client key name "Chaty Integration" or something similar to indicate this key is used by Chaty. 5. You'll be taken back to the API Keys Screen where you can see the Client ID and Client Secret **Add your ROLLER API key to Chaty** 1. Login to [Chaty](https://app.chaty.com.au/) 2. Click on the "Integrations" menu item on the left menu, 3. Search for ROLLER and Paste your Client ID into the Client ID field and the API key into the "API Key" field. **Add your Roller Checkout** In order to allow Chaty to send SMS links to your customers to make a booking, you need to create a Progressive Checkout. If you already have a checkout you wish to use, you can can just input the Checkout Name. The name is what is displayed at the end of your checkout url. For instance if the URL is /examplecustomer/myvenuecheckout the checkout name is "**myvenuecheckout**" (You'll find this in Apps > Progressive Checkout") When you setup your integration with Chaty, input this checkout name in the Configuration tab within the Roller integration. **Choose the products available to Chaty:** Once you have installed the ROLLER integration, you need to choose the products that Chaty will be able to book. 1. Click on the "Products" tab within the ROLLER the integration settings 2. If the products are not listed, click on the "Sync Products" button to sync the products from ROLLER to the Chaty servers. 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. ### **Payments** To take payments, you'll need to setup [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. ### **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 ROLLER Policy. You can override this setting in: 1. Navigate to Integrations > Edit your ROLLER Integration > then click on the Product you wish to set the 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/roller.md?ask= ``` 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.