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

# Calendly

> Schedule appointments via Calendly during voice calls

## Overview

The Calendly integration enables your voice agents to check availability and
help callers book appointments in real-time during calls. Your agent can look
up available slots, suggest times, and send a booking link via SMS.

## What You Can Do

| Feature                 | Description                                             |
| ----------------------- | ------------------------------------------------------- |
| **Check Availability**  | Verify if a specific date has openings                  |
| **Get Next Slots**      | Find the next available time slots over the coming days |
| **Create Booking Link** | Generate a single-use Calendly link to send via SMS     |

## Setup

<Steps>
  <Step title="Connect Calendly">
    Go to **Integrations** and click **Add Calendly**. You will be redirected to
    Calendly to authorize access via OAuth.
  </Step>

  <Step title="Select Event Type">
    After connecting, choose which Calendly event type your agent should use for
    scheduling. Click the **Configure** button next to your Calendly integration
    to select or change the event type at any time.
  </Step>

  <Step title="Enable in Workflow">
    In **Workflow Editor**, go to **Tools** and enable the Calendly tools.
  </Step>
</Steps>

## Available Tools

Your agent has access to three functions:

| Tool                    | Use Case                                                                |
| ----------------------- | ----------------------------------------------------------------------- |
| **Check Availability**  | When caller asks about a specific date                                  |
| **Get Next Slots**      | When caller wants to know upcoming availability without a specific date |
| **Create Booking Link** | When caller wants to book and needs a link sent via SMS                 |

## Example Conversation

<AccordionGroup>
  <Accordion title="Appointment Booking Flow">
    **Caller:** I'd like to schedule an appointment, are you available Thursday?

    **Agent:** Let me check... Yes, Thursday has several openings. I can see
    slots at 9:00, 10:30, 14:00 and 16:00. Which time works best for you?

    **Caller:** 10:30 would be perfect.

    **Agent:** Great choice. I'll send you a booking link by SMS so you can
    confirm the 10:30 slot. You'll receive it in a moment.

    **Caller:** What about next week if I need to reschedule?

    **Agent:** Let me look at next week... I have availability on Monday,
    Tuesday and Thursday. Would any of those work?
  </Accordion>
</AccordionGroup>

## Technical Details

| Setting       | Value                             |
| ------------- | --------------------------------- |
| Auth Method   | OAuth 2.0 (via Nango)             |
| API Timeout   | 3 seconds (optimized for voice)   |
| Data Source   | Calendly API v2                   |
| Lookup Window | Up to 14 days ahead               |
| Timezone      | Europe/Paris                      |
| Booking Links | Single-use (one booking per link) |

## Limitations

<Warning>
  **Current limitations:**

  * One event type per integration (selected during setup)
  * Booking links are single-use
  * The agent cannot create events directly, only generate booking links
  * Availability is read-only (no calendar modifications)
</Warning>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connection failed">
    * Ensure you completed the OAuth authorization on Calendly
    * Try disconnecting and reconnecting the integration
    * Check that your Calendly account is active
  </Accordion>

  <Accordion title="No event types available">
    * Verify you have at least one active event type in your Calendly account
    * Inactive or draft event types will not appear
  </Accordion>

  <Accordion title="No availability shown">
    * Check that your Calendly event type has availability configured
    * Verify your Calendly schedule is not fully booked
    * The agent checks up to 14 days ahead by default
  </Accordion>

  <Accordion title="Event type not selected">
    * If the configuration dialog did not open after OAuth, click **Configure** in the integrations table
  </Accordion>

  <Accordion title="Timeout during calls">
    * This can happen during high traffic periods
    * The agent will inform the caller and suggest trying again
    * Check your internet connection
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Google Calendar" icon="calendar" href="/integrations/google-calendar">
    Sync with Google Calendar
  </Card>

  <Card title="Workflow Tools" icon="wrench" href="/workflows/tools">
    See all available tools
  </Card>
</CardGroup>