# Meetings

> Connect Calendly, Cal.com or GoHighLevel, let your agent offer real slots and book the meeting in the conversation, then find every booked meeting.

Source: https://docs.whatsetter.com/dashboard/bookings/

Your agent can book a meeting itself, without leaving WhatsApp. It reads your
real availability, offers a few slots and creates the meeting in your calendar
once the lead picks one. Without a connected calendar, it shares your booking
link instead.

## Where meetings are set now

Meetings are set in two places.

| What | Where |
|---|---|
| Connect a calendar tool, once for the whole workspace | **Settings** in the menu, then **Integrations**, under **Calendars** |
| Choose what one agent books, and its booking link | **Agents**, your agent, the **Settings** tab, then **Meetings** |

In the old dashboard, the second part was the "In-chat booking" section of
the campaign panel. Campaigns are now called agents, and that panel is gone:
each agent carries its own **Meetings** section.

Meetings exist for agents that answer private messages. A group agent has no
**Meetings** section.

## Calendars you can connect and what each one needs

Open **Settings** in the menu, then **Integrations**. Under **Calendars**,
three tools can be connected:

| Tool | How it connects | What the agent asks the lead |
|---|---|---|
| Calendly | You sign in to Calendly in a window that opens. | An email address, always. |
| Cal.com | You sign in to Cal.com in a window that opens. | An email address, only when your event type requires one. |
| GoHighLevel | You paste a private integration token and the Location ID of your sub-account. | Nothing more than its WhatsApp number. The lead is saved as a contact in GoHighLevel. |

One account per tool is connected for the whole workspace. Each agent then
uses one tool at a time and books one event type.

> **Calendly needs a paid plan**
Calendly lets an outside tool create meetings on its Standard plan and above.
On a free Calendly plan, your agent reads your availability and offers real
slots, but the meeting cannot be created: it then shares your link.

## Connect your calendar

1. Open **Settings** in the menu, then **Integrations**.
2. Under **Calendars**, click **Connect** on the line of Calendly, Cal.com or GoHighLevel.
3. For Calendly and Cal.com, sign in in the window that opens and allow access. If nothing opens, allow pop-ups for the site and try again.
4. For GoHighLevel, paste your **Private integration token** and your **Location ID (sub-account)**, then click **Validate & connect**.

The line then reads **Connected**. If it reads **Expired** or **Error**,
click **Reconnect**. **Disconnect** removes the connection: the agents that
used it share their fallback link until you connect a calendar again.

For GoHighLevel, create the token in Settings, Private Integrations, with the
scopes `calendars.readonly`, `calendars/events.write` and `contacts.write`.
The Location ID is in the address of your sub-account. The pair is checked
before it is saved.

## Let your agent book in the conversation

1. Open **Agents**, click your agent, open the **Settings** tab, then **Meetings**.
2. If several calendar tools are connected, click the card of the one this agent should use.
3. Under **Event type to book**, choose the event type. With GoHighLevel, the list shows the calendars of your sub-account.
4. Turn on **Book in the conversation**.

Everything saves on its own. A line at the top of the section says what the
agent does right now:

| What the line says | What to do |
|---|---|
| It offers the slots of your event type and books in the conversation. | Nothing: booking is on. |
| It does not book by itself and sends your booking link. | Turn on **Book in the conversation**. |
| An event is still to be picked. | Choose one under **Event type to book**. |
| The calendar tool needs reconnecting. | Reconnect it in **Settings**, **Integrations**. |

The switch refuses to turn on without an event type. If you created the
event type a moment ago, click **Refresh**: the list is reloaded every hour
otherwise. With no calendar connected, the section shows
**Connect your calendar first** and the button **Go to Integrations**.

## What the agent asks the lead before booking

Open **Agents**, click your agent, open the **Settings** tab, then
**Meetings**. Once an event type is chosen, the panel
**What the agent will do with this event** reads it from your calendar tool
and shows:

- **Duration**: the length of the meeting.
- **Place**: where it happens, for example a video call or an address.
- **Email**, and **Phone** with Cal.com: **Required**, **Optional** or **Not asked**.

Under these lines, the panel says in one sentence whether your agent asks the
lead for an email before booking, and whether it asks where the lead wants to
meet.

These rules belong to your event type. To change them, change the event type
in Calendly, Cal.com or GoHighLevel, then come back: the panel reads them
again.

Under these lines, the **Booking form** block says what the agent puts in the
other questions of your form: see the next section.

## Let the agent fill in your booking form

Your booking form can ask more than the name and email, for example the
company name or a budget. The agent can answer them with what the lead said
in the conversation.

1. Open **Agents**, click your agent, open the **Settings** tab, then **Meetings**, and choose your event type.
2. In the **What the agent will do with this event** panel, scroll down to **Booking form**. Each question of your form is listed with its type and **Required** or **Optional**.
3. Turn on the switch of each question the agent should fill.
4. Optional: under a question that is on, write an **Instruction for the agent**, for example "monthly budget in euros", 300 characters at most.

Each line says what the agent puts there:

| Switch | What the agent puts |
|---|---|
| On | The answer the lead gave in the conversation. If they did not give one, nothing changes. |
| Off, required question | The value shown on the line, so the booking goes through, for example the lead's name. |
| Off, optional question | Nothing: the question stays empty. |

A notes question, marked **Notes**, gets a few neutral sentences about the
lead's need, situation and goal. Name, email, phone and place are always
filled by the agent. The lead sees these answers in their Calendly or Cal.com
confirmation email. For the agent to have an answer, the question must come
up in the conversation: add it to your agent's prompt.

With GoHighLevel, the form's questions cannot be read. The block has one
line, **Notes in the appointment description**: when it is on, the agent
writes a few neutral sentences about the lead in the appointment's
description, which stays in your GoHighLevel.

## Send every meeting to HubSpot

When HubSpot is connected in **Settings**, **Integrations**, each agent can
send it the leads who book. Open **Agents**, click your agent, open the
**Settings** tab, then **Meetings**. Under your event type, turn on
**Send every meeting to HubSpot**, then choose what goes: the meeting, a note
with the conversation summary, the whole conversation.

Without HubSpot connected, the card offers **Connect**, which opens
**Integrations**. What is sent is detailed in
[Settings](/dashboard/settings/).

## Offer a second meeting type

For example a phone call for leads who do not want a video call. Both types
are on the same calendar.

1. Create the second event type in Calendly or Cal.com.
2. Open **Agents**, click your agent, open the **Settings** tab, then
   **Meetings**.
3. Under your event type, turn on **Offer a second meeting type** and pick it
   in **Second type**.
4. In **When to offer it**, write in one sentence how the lead wants to meet
   when this type is the right one, for example: "The lead prefers a phone
   call." Left empty, this example is saved.
5. Optional: in **Name for the agent**, the word your agent uses for this
   meeting.

By default your agent books the first type. It books the second one when what
the lead says about how to meet matches your sentence, whatever language the
lead writes in. Only the lead's own words count: not what the agent suggested,
not the lead's profile, not the time the lead picks. Write a sentence about
how to meet ("The lead prefers a phone call"), not about who the lead is ("The
lead is a large company"): that one would never be met. Moving or
cancelling a meeting keeps its own type. With GoHighLevel, your agent books on
one calendar only: this option is not available.

## Advanced options: slots, days ahead, time zone, fallback link

Open **Agents**, click your agent, open the **Settings** tab, then
**Meetings**, and click **Advanced options**.

| Setting | Default | Range | What it does |
|---|---|---|---|
| **Slots per offer** | 3 | 1 to 5 | How many slots your agent offers at once. |
| **Slot valid for (min)** | 5 | 1 to 30 | How long the offered slots stay current in the conversation. After that the agent reads your calendar again. Nothing is blocked in your calendar. |
| **Up to (days)** | 14 | 1 to 30 | How many days ahead your agent offers slots. |
| **Timezone** | Europe/Paris | any | The time zone of the times offered to leads. |
| **Fallback link** | The public page of your event type | any link | The link shared when booking in the conversation is not possible. |

A value outside the range is brought back to the nearest allowed value. Each
change saves on its own.

## How your agent offers slots and books

Once **Book in the conversation** is on, the meeting is handled like this:

- When a lead is qualified but has not asked for a meeting, the agent first proposes a call. It offers slots once the lead agrees.
- Slots come from your real availability, between 9:00 and 19:00 in the **Timezone** of the section, and never less than 2 hours ahead.
- The agent follows what the lead asks: a day, a morning, an hour. If nothing is free there, it offers the closest free slots.
- If the lead prefers another moment, the agent looks again and offers new slots.
- When the event type requires an email, the agent asks for it before booking.
- Right before booking, it checks the slot is still free. If it was taken, it says so and offers others.
- A lead marked **Not interested** or **Stopped** who asks for a meeting themselves gets slots. Your agent never offers them a meeting on its own.

The meeting counts as booked only when your calendar tool has confirmed it.
From then on, the agent no longer offers slots and answers the lead normally.
The wording, the tone and the language stay those of your prompt.

## When the agent shares a link instead

Open **Agents**, click your agent, open the **Settings** tab, then
**Meetings**. Two links are set there.

- **Booking link**: what your agent shares when it does not book by itself. In the prompt, it is the **Booking link** chip. Type it and click **Save**.
- **Fallback link**, under **Advanced options**: what your agent shares when **Book in the conversation** is on but booking is not possible on that message. Left empty, it is the public page of your event type.

While **Book in the conversation** is on, your agent does not send a booking
link by itself, and Calendly, Cal.com or Google Calendar links written in its
instructions are left out of its replies. It shares the fallback link only
when your calendar tool must be reconnected, returns no free slot, or refuses
to create the meeting.

If your agent is meant to send a link and has none, its **Summary** tab shows
the line **Its link** with the button **Add**.

## Reschedule or cancel a meeting

From the conversation, the lead can do both with your agent:

- to cancel, the agent first asks for a clear confirmation. Nothing is cancelled until the lead confirms. The meeting is then cancelled in your calendar tool;
- to reschedule, the agent offers new slots. The first meeting stays in your calendar until the new one is confirmed.

When the lead writes several messages in a row, the agent reads them together: a « thanks » sent right after « please cancel » does not make it forget the request. If the lead answers the confirmation twice without a clear yes, the meeting stays and the agent says so.

From the dashboard, open the lead in **Leads** or in **Conversations**. On the
**Meeting** line, click the date of the meeting. Under **This meeting**,
choose **Held**, **No-show** or **Cancelled**. This needs the **Edit leads**
permission.

> **Marking a meeting does not change your calendar**
**Held**, **No-show** and **Cancelled** update the lead in WhatSetter only.
To cancel or move the event itself, do it in your calendar tool.

## Where booked meetings appear

- **Leads**: the view **Meetings booked** lists the leads whose meeting is coming. Open a lead to read the date on its **Meeting** line.
- The agent's **Summary** tab: **Meetings** counts its leads with a meeting and opens them.
- **Overview**, **Analytics** and the agent's **Results** tab: **First meetings**. Each lead counts once, on the day its first meeting was booked, even if it was cancelled later.
- **Conversations**: the filter **Meeting**.
- The API: [GET /bookings](/api-reference/operations/listbookings/) lists the meetings booked by your agents. See [API: bookings](/developers/guides/bookings/).

Only meetings booked in the conversation are recorded. A meeting the lead
books alone from your link, on the page of your calendar tool, does not show
in WhatSetter.

WhatSetter sends no notification when a meeting is booked: your calendar tool
sends its own. See [Notifications & alerts](/dashboard/notifications/).

## What the meeting statuses mean

Open **Leads**, click **Display**, then **Columns**, and add **Meeting**. The
same statuses are in the **Meeting** filter of **Leads** and
**Conversations**. They are separate from the stage of the lead: a lead can
be qualified without a meeting.

| Status | Meaning |
|---|---|
| **Offered** | Your agent offered slots, or the booking is in progress. No meeting exists yet. |
| **Booked** | The meeting exists in your calendar. The lead's stage reads **Meeting booked**. |
| **Held** | You marked the meeting as held. |
| **No-show** | You marked the lead as absent. |
| **Cancelled** | The lead cancelled it in the conversation, or you marked it cancelled. |

A lead with no meeting shows a dash in the column, and **No meeting** on its
**Meeting** line. Only a booked meeting can be marked **Held**, **No-show**
or **Cancelled**.

## Why your agent does not offer slots

Open **Agents**, click your agent, open the **Settings** tab, then
**Meetings**, and read the line at the top of the section.

- **Book in the conversation** is off, or no event type is chosen: the agent only has your booking link.
- The calendar tool reads **Expired** or **Error**, or was disconnected: reconnect it in **Settings**, **Integrations**. Meanwhile the agent shares your fallback link.
- No free slot was found: your calendar has nothing between 9:00 and 19:00 in the **Timezone** of the section, within the days set in **Up to (days)**, or everything is less than 2 hours away.
- The lead belongs to a conversation variant whose booking is switched off, in the block **By behavior variant** of the same section.

To try without creating anything, open the **Test** tab and turn on
**Simulate booking**: the agent offers real slots from your calendar and
nothing gets booked. See [Test your agent](/dashboard/playground/).

## Why a slot was offered but no meeting was booked

Open the lead in **Conversations** and read the end of the exchange. The
usual reasons are:

- The lead did not give an email. With Calendly, and with a Cal.com event type that requires one, nothing is booked until the lead writes a valid address.
- The lead answered without choosing, for example with a simple "ok": the agent asks which slot it wants.
- The slot was taken in the meantime: the agent says so and offers others.
- Your calendar tool refused to create the meeting, which is what happens on a free Calendly plan: the agent shares your fallback link.
- A person took over the conversation: the agent no longer answers. See [Take over a conversation](/dashboard/human-takeover/).

Until the calendar confirms, the lead's **Meeting** line reads **Offered**,
never **Booked**.

## Book or not for each conversation variant

Open **Agents**, click your agent, open the **Settings** tab, then
**Meetings**. When the agent runs several variants of its conversation, the
block **By behavior variant** shows one line per variant, with a switch.

- On, the line reads **Books meetings**: the leads of this variant get slots and are booked in the conversation.
- Off, the line reads **Only shares the link**: no slot is offered and nothing is booked for the leads of this variant.

The switch only matters when **Book in the conversation** is on for the
agent. It lets you compare a variant that books with one that does not. See
[A/B variants](/dashboard/ab-variants/).

## Who can connect a calendar and change meeting settings

| Action | Permission needed |
|---|---|
| Connect or disconnect a calendar tool in **Settings**, **Integrations** | **Connect tools (calendar, links, Instagram)** |
| Choose the event type, turn **Book in the conversation** on or off, set the **Booking form** and the sending to HubSpot, change the **Advanced options** | **Connect tools (calendar, links, Instagram)** |
| Change the **Booking link**, or the switches of **By behavior variant** | **Edit agents and their prompts** |

By default, the **Owner** and **Admin** profiles have the first permission.
The **Editor** profile has the second one only: an editor can change the
booking link, not the calendar. Without the first permission,
**Integrations** does not show in your settings. See
[Team](/dashboard/team/).

## Related

- [A/B variants](/dashboard/ab-variants/)
- [Notifications & alerts](/dashboard/notifications/)
- [Leads & CRM](/dashboard/leads/)
- [API: bookings](/developers/guides/bookings/)
