# Calendly

Connect your Calendly account and offer scheduling from a conversation.

## Overview

Calendly actions let your agent offer a meeting when a customer is ready to book. QwryAI connects to Calendly through OAuth and can open its hosted scheduling experience inside the website widget.

## Connect Calendly

1. Open Build → Actions and select Calendly from Create action.
2. Choose Connect Calendly to open connection settings.
3. Authorize the Calendly account that owns the events you want to offer.
4. Select the event type in the integration settings and return to Calendly actions.
5. Confirm the connection and available actions load successfully.

## Configure an action

1. Open Customize for the Calendly action you want to use.
2. Review its action name and When to use instructions. Describe the requests that should lead to scheduling.
3. Review the action's inputs and any widget settings available for that action.
4. Choose the connected channels where it should be available.
5. Save the draft, then enable or publish the action using its editor controls.

## Test scheduling

- Ask for a meeting using the wording a customer would use.
- Check that the correct Calendly event opens.
- Review the displayed timezone and available slots.
- Complete a test booking and check Calendly for the confirmation.
- Try cancelling the scheduler and continuing the conversation.

> **Calendar availability**: Manage event duration, availability, and scheduling rules in Calendly. A successful connection alone does not confirm that the selected event has bookable times.

## Troubleshooting

| What you see | What to check |
| --- | --- |
| Connect Calendly | Complete the account connection for this chatbot. |
| Actions unavailable | Resolve the displayed connection or loading error before assuming there are no actions. |
| The wrong event opens | Review the selected event in connection settings. |
| The agent does not offer scheduling | Check the action's enabled state, channel, and When to use instructions. |

## Related guides

- [Testing and publishing](/docs/user-guides/actions/testing-and-publishing)
- [Cal.com scheduling](/docs/user-guides/actions/cal)