> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telli.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Zeeg
> Connect Zeeg to telli so agents can check availability, book meetings, and fill Zeeg scheduling page questions during calls.
## Overview
Zeeg is configured per agent so each workflow can use the right scheduling page, duration, and booking-field mapping.
This works well when different agents book different meeting types or route to different teams.
## Before you start
* A telli agent that should book appointments
* A Zeeg account with an active scheduling page
* A Zeeg API token from [Account Settings > API](https://app.zeeg.me/account/settings/api-access)
* A Zeeg plan that allows availability lookup and programmatic booking through the API
Use a least-privilege Zeeg API token. For telli, the token needs access to:
| Scope | Why telli needs it |
| ------------- | ---------------------------------------------------------------- |
| `events:read` | Read scheduling pages and their custom invitee questions |
| `timetable` | Read available time slots for the selected scheduling page |
| `booking` | Write bookings by creating the booked Zeeg event during the call |
Zeeg's availability and booking API endpoints require an active paid subscription.
## Set up Zeeg in telli
Open the agent you want to configure in telli.
In **Calendar Integration**, select **Zeeg**.
Create a Zeeg API token with `events:read`, `timetable` for reading availability, and `booking` for writing bookings. Then add it to
telli. telli loads the scheduling pages available to that token.
Choose the Zeeg scheduling page the agent should use for availability checks and booking.
Open the settings for the selected scheduling page and map the booking questions you want telli to fill automatically.
Save the agent so telli can use the selected Zeeg setup during calls.
## Booking fields
When connecting Zeeg, you can configure booking fields to automatically fill the custom invitee questions on your Zeeg scheduling page during booking.
Each booking field maps a Zeeg question to a value source.
| Type | Description | Example |
| -------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------ |
| **Constant** | A fixed value, always the same | Brand name, company name |
| **Contact property** | Resolved from the contact's data. If not available, the agent asks the caller for it | Phone number, email, first name |
| **System variable** | Resolved from internal system data using a path expression | Contact ID, timezone |
| **LLM parameter** | Collected by the agent during the conversation | Reason for appointment, preferred language |
## How booking works
* telli lets you pick one Zeeg scheduling page per agent
* During calls, the agent checks available slots for the selected page
* When the caller chooses a slot, telli books the Zeeg event with the collected caller details
* Booking fields are filled automatically during booking
* Contact properties and constants are used without extra conversation
* LLM parameters prompt the agent to collect missing information from the caller
Every required custom question on your Zeeg scheduling page must have a corresponding booking field configured, otherwise the booking will
fail. Optional questions without a mapping are skipped.