For the complete documentation index, see llms.txt. This page is also available as Markdown.

Schedule Appointments with Dapta Calendars

Let your Text Agent offer your real open times and book the appointment inside the conversation. Add the Schedule appointments action, pick the meeting, and the agent handles availability and booking

Schedule appointments connects your Text Agent to Dapta Calendars, Dapta's own scheduling product. During a conversation the agent reads your real availability, offers the times that are actually free, and books the appointment β€” without leaving the chat and without sending the customer a booking link.

You add it as a single action. There is no credential to paste and no ID to copy: Dapta sets up your Calendars account the first time you open the action.

You need to be an admin or owner of your workspace's Dapta Calendars account to set this action up. If you are not, the action will tell you and you can ask a teammate who is.


πŸ“˜ What you'll learn in this document:

  • Step 1: Add the Schedule appointments action to your Text Agent.

  • Step 2: Create or choose the meeting the agent will book.

  • Step 3: Optionally tell the agent when it is allowed to offer times and book.

  • Step 4: Test the whole conversation in the Playground.

  • How it works: what the agent does at runtime, and what lives in Dapta Calendars.


βž• Step 1: Add the action

  1. Open your Text Agent and go to the Settings tab.

  2. Scroll to the Agent Actions section and click + Add New Action.

  3. Choose Schedule appointments (Dapta Calendars).

The Add New Action menu with Schedule appointments (Dapta Calendars) at the bottom

An agent can have this action once. Once it is added, the option disappears from the + Add New Action menu β€” to change the meeting or the instructions, click the pencil icon on the existing action instead.


πŸ—“οΈ Step 2: Create or choose the meeting

A meeting is what the agent books: a name and a duration β€” for example Discovery call Β· 30 min. It lives in your Dapta Calendars account, so every agent and every channel books against the same availability.

If your account has no meetings yet, the action walks you through creating one before showing the form:

  1. Type a Meeting name (for example Discovery call).

  2. Pick a Duration.

  3. Click Next.

Dapta creates the meeting, plus default working hours of Monday to Friday, 9:00 to 17:00, in your time zone. You only do this once β€” from then on the action opens straight on the form.

You can create more meetings and change your working hours later in Dapta Calendars. The action creates the first one so you can finish setting up your agent in one sitting.

If your account already has meetings, the action opens directly on the form. Pick one from the Meeting dropdown β€” the list is read live from your Dapta Calendars account.

The Meeting dropdown open, showing Discovery call Β· 30 min

Under the dropdown you'll see the time zone the agent will offer times in, and a link to Dapta Calendars where you manage calendar sync, meetings and time zones.


✍️ Step 3: Add instructions (optional)

The agent already knows how to schedule: check the calendar first, never invent a time, only book a time the customer confirmed. You don't need to write any of that.

Additional instructions are for the when β€” the business rule that has to be true before this particular agent offers times or books:

Only offer times once the lead is qualified: 10+ employees and a use case they confirmed. Ask for the company name before booking.

The Schedule appointments form with a meeting selected and additional instructions filled in

Click Save. The action appears in the Agent Actions list. Click Save Agent to save the draft, then Publish to make it live.

The Agent Actions list showing Schedule appointments (Dapta Calendars)

πŸ› Step 4: Test it in the Playground

Open the Test Agent tab and ask for an appointment the way a customer would. The agent reads your calendar and answers with real open times.

The agent offering three open times for a specific date in the customer's time zone

Pick one of the offered times and give it the details it asks for. The agent books the appointment and confirms it with a booking reference.

The agent confirming the appointment with date, time, location and booking reference

The Playground books real appointments in your Dapta Calendars account. Cancel your test bookings in Dapta Calendars when you're done.


How it works at runtime

One action gives your agent two abilities, and it decides which one to use from the conversation:

The agent…
What happens

Checks availability

Reads the free slots for your chosen meeting from Dapta Calendars and offers them in your time zone. It does this before naming any time β€” it never invents or promises a slot it hasn't seen.

Books the appointment

Once the customer confirms a specific time, it books exactly that slot and answers with the confirmation details.

A normal conversation uses both, in that order: the customer asks, the agent checks and offers, the customer picks, the agent books. If the customer asks again for a different day, the agent checks again.

When the booking is created, Dapta Calendars sends a confirmation email with a calendar invite to both the customer and you, and the appointment shows up in your Dapta Calendars account.


The parts involved

Scheduling spans two products. Knowing which one owns what tells you where to go when you want to change something.

Product
Owns

Dapta Calendars (calendar.dapta.ai)

Your scheduling account: meetings, working hours, time zone, calendar sync and every booking that was made. One account per workspace, shared by all your agents.

Your Text Agent

Which meeting this agent books, and the business rule for when it may offer times or book. Nothing else about your availability lives here.

The action is the bridge: it reads your meetings when you configure it, and reads your availability and writes bookings while a conversation is running. Authorization is handled for you β€” you never paste or manage a credential.

Voice Agents schedule through Cal.com instead. The two are independent: an availability change in Dapta Calendars does not affect a Voice Agent, and vice versa.


Requirements and limitations

Requirement
Detail

Agent version

V2 Text Agents only.

Permission

Only an admin or owner of your workspace's Dapta Calendars account can set the action up.

Actions per agent

One Schedule appointments action per agent, bound to one meeting. To book different meetings, use different agents.

Working hours

Availability comes from the working hours on your Dapta Calendars account β€” Monday to Friday, 9:00 to 17:00 by default.

Time zone

Set the first time you open the action, from your browser. Change it in Dapta Calendars.

Minimum notice

A new meeting requires 2 hours notice by default, so the agent won't offer a slot sooner than that. Adjustable per meeting in Dapta Calendars.

Rescheduling and cancelling

Done from the confirmation email or in Dapta Calendars, not by the agent.


Troubleshooting

The agent says it has no times available

Check in Dapta Calendars that the meeting has working hours covering the days the customer is asking about, and remember the 2-hour minimum notice β€” on a same-day request, the next couple of hours are filtered out by design.

The agent offered times, but the customer wanted a later one it didn't mention

When a day has many open slots the agent offers a selection rather than all of them. Ask it directly for a later time and it will check again for that part of the day.

The meeting dropdown is empty, or the meeting I picked disappeared

The list is read live from Dapta Calendars. If the meeting was deleted there, the action clears the selection and asks you to pick again β€” so an agent is never left pointing at a meeting that no longer exists. Pick another meeting, or create one in Dapta Calendars, then Save Agent and Publish.

"Admin access required"

Your user is a member, not an admin or owner, of your workspace's Dapta Calendars account. Ask an admin or owner to add the action to the agent β€” once it's saved, the agent works for everyone.


Text Agent ActionsPlayground: Testing your Text AI Agents

Last updated