Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.voxworks.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Description

Processes raw availability data (from Calendly - Get Availabilities) and selects the best matching time slots based on the user’s stated preferences from the conversation. Returns up to 6 slots formatted in natural spoken language. This tool uses AI to intelligently select slots that match:
  • User’s requested day (e.g., “Tuesday”, “next week”)
  • User’s requested time (e.g., “afternoon”, “around 2pm”)
  • Temporal proximity (sooner slots preferred when no preference stated)

​
Manual Inputs

NameData TypeRequiredDescription
Number of availabilitiesintegerNoNumber of slots to return (1-6, default: 3)

​
Global Inputs

This tool automatically uses:
VariableDescription
[Calendar - Availability - Raw]Raw availability JSON from Calendly - Get Availabilities
The tool also uses the conversation context to understand the user’s day and time preferences.

​
Manual Outputs

NameData TypeDescription
resultbooltrue if slots were successfully selected and formatted

​
Global Outputs

VariableData TypeDescription
[Calendar - Availability - Spoken]stringSelected times in natural spoken format (e.g., “Tuesday 18th at two, or Wednesday 19th at three thirty”)

​
Conditions

​
Success (true)

The tool returns true when:
  • Raw availability data exists in [Calendar - Availability - Raw]
  • At least one time slot is available
  • Slots are successfully selected and formatted

​
Failure (false)

The tool returns false when:
  • [Calendar - Availability - Raw] is empty or missing (run Calendly - Get Availabilities first)
  • No available slots match the user’s preferences
  • An error occurs during slot selection or formatting

​
Example Usage

Step 1 (Tool): Calendly - Get Availabilities
   -> Success -> Step 2

Step 2 (Voice): "What day works best for you?"
   -> User provides day preference -> Step 3

Step 3 (Tool): Calendar - Check Availability
   Input: Number of availabilities = 3

   Condition: true (success)
   -> Next: present_options_step
   -> Script: "I have [Calendar - Availability - Spoken]. Which works best?"

   Condition: Otherwise (failure)
   -> Next: alternative_step
   -> Script: "I couldn't find availability for that time. Would another day work?"

​
Prerequisites

This tool requires raw availability data. You must run Calendly - Get Availabilities first to populate [Calendar - Availability - Raw].

​
Best Practices

  1. Get availability first — Always run Calendly - Get Availabilities before this tool
  2. Collect preferences first — Ask for day/time preferences before checking
  3. Limit options — 3 options is ideal; too many can overwhelm
  4. Handle failures — Have a fallback for when no slots match preferences

​
Next Steps