# Embed meeting booking

> Put the booking flow on your own page, so a visitor picks a time and books without opening the chat

Source: https://www.hey.support/docs/integrations/embed-meeting

---

Embed meeting booking shows your open times on a page of your own site. The visitor taps a button, picks a time, leaves a name and email, and the meeting is booked. It uses the same calendar, meeting types and confirmation emails as booking in the chat.

## Before you start

* Meetings must be on, with **Google Calendar** or **Cal.com** as the way meetings get booked. A scheduling link can't be embedded, because there are no open times to show. See [Meetings](/docs/capabilities/booking).
* The embed is off until you turn it on, so nothing changes on your site by itself.

## Turn it on

Open **Go live**, then **On your website**, and open **Meeting booking**. Turn on the switch at the top. The details show the snippet for your agent and a live preview of each step.

You can change the button label and icon, the replies and the thank-you wording, and up to three steps for what happens next. You can also add a link on the thank-you screen, pick the light or dark look, and choose whether the button sits in the centre or at the start of its line. Leave a field empty to use the built-in wording, which follows your agent's language. The switch saves as you flip it; press **Save** at the bottom for your wording to go live.

If you have more than one active meeting type, you can choose which one the embed books. Otherwise it uses the first active type.

## Add it to your page

Paste this where the button should appear. Use your own agent's snippet from the Meeting booking details, which carries the right ID.

```html
<div data-hey-meeting="YOUR_AGENT_ID"></div>
<script src="https://www.hey.support/api/meetings/embed.js" defer></script>
```

The script finds each `data-hey-meeting` element and puts the flow inside it. It sizes itself to the content, so there's no scrollbar and nothing to configure. You can place the element more than once.

If the embed is off, the agent is paused, Google Calendar has no active meeting type or the page isn't allowed to show it, nothing appears on your page.

### If you can't add scripts

Use a frame instead. It shows the same flow and needs no script.

```html
<iframe src="https://www.hey.support/meet/YOUR_AGENT_ID" width="100%" height="720" style="border:0;color-scheme:light" loading="lazy" title="Book a meeting"></iframe>
```

A frame has a fixed height, so the flow scrolls inside it when a step is taller. The script version resizes to fit, and it also lets your page hear about a booking.

<Callout>
  The booking page exists to be shown inside your own page. It isn't a page to link visitors to, and it asks search engines not to list it.
</Callout>

## Only on these domains

The embed follows the agent's **Only on these domains** list, in the Chat bubble and Center stage details on the Go live page. With the list empty, it can be shown on any site. Once you add a domain, it can be shown only on the domains you listed. Anywhere else, the script version shows nothing and the plain frame shows the browser's own refusal message. Add staging and preview hosts too if you test there. See [Embed on your site](/docs/launch/embed).

## Know when someone books

With the script version, your page gets a `hey:meeting-booked` event on the element each time a visitor books. Use it to fire your own conversion tag.

```html
<script>
document.addEventListener('hey:meeting-booked', function (e) {
    // e.detail has start and end. Fire your own conversion tag here.
});
</script>
```

`start` and `end` are the meeting's times. The event never includes the visitor's name or email.

## Where bookings show up

A booking made through the embed is a real booking. It lands on your calendar with the invite, and your team gets the usual alerts. On Native, the visitor also gets our confirmation email and reminders. On Cal.com, Cal.com sends those.

These visitors didn't use the chat, so there's no conversation. You'll find the booking under **Meetings** (see [Meetings](/docs/conversations/bookings)) and in your alerts, not in the Inbox.

<NextSteps>
  <IconCard icon="calendar-check" title="Booking" href="/docs/capabilities/booking" description="Set up the calendar, meeting types and times the embed offers." />

  <IconCard icon="calendar-days" title="Meetings" href="/docs/conversations/bookings" description="See and manage every booking, from the chat or the embed." />

  <IconCard icon="rocket" title="Embed the agent" href="/docs/launch/embed" description="Add the chat bubble to the same page." />
</NextSteps>
