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

# Booking engines

> How to integrate TinyBell with your hotel booking engine.

## Overview

TinyBell works with any booking engine. The pixel loads on your hotel website and displays notifications independently of your booking system. No API integration required.

## How it works

1. You install the TinyBell pixel on your hotel website.
2. Notifications display on your website pages.
3. When a guest clicks the CTA button, they are redirected to your booking engine URL.
4. The booking engine handles the reservation as usual.

## Setting up the button URL

When creating a notification, set the **Button URL** to your booking engine's direct link. This is typically a URL that goes straight to the booking page with optional parameters.

**Common booking engine URL patterns:**

| Engine          | URL pattern                                       |
| --------------- | ------------------------------------------------- |
| **Cloudbeds**   | `https://hotels.cloudbeds.com/reservation/XXXXXX` |
| **SiteMinder**  | `https://book-directonline.com/properties/XXXXXX` |
| **Profitroom**  | `https://HOTEL.profitroom.com/en/`                |
| **Mirai**       | `https://HOTEL.mirai.com/en/`                     |
| **Paraty Tech** | `https://HOTEL.paratytech.com/`                   |
| **Roiback**     | Custom per hotel                                  |

<Info>
  Ask your booking engine provider for the direct booking URL if you're unsure.
</Info>

## Passing promo codes

If your notification includes a discount code, you can pass it to the booking engine via URL parameters. Most engines support promo code parameters:

```
https://your-booking-engine.com/reserve?promo=DIRECT15
```

Check your booking engine's documentation for the exact parameter name.

## Tracking conversions

To track if a notification click led to a completed booking, add the TinyBell pixel to your booking engine's confirmation page as well. This requires your booking engine to support custom scripts on the thank-you page.

<Tip>
  If your booking engine doesn't support custom scripts on the confirmation page, you can still track clicks and CTR. Conversion tracking is a bonus, not a requirement.
</Tip>
