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.

​
Overview

The O365 Bookings integration allows your assistant to:
  • Check available time slots from your Microsoft Bookings calendar
  • Book appointments directly into O365 Bookings
  • Send SMS confirmation to the invitee
  • Cancel bookings if needed during the call
This is a complete booking workflow — one tool handles the entire flow from availability checking through confirmation. Provider: Microsoft (graph.microsoft.com) Timezone: Australia/Sydney (automatically converted to UTC for API) Location Type: In-person

​
Setup

​
1. Connect Microsoft Account

  1. Navigate to Integrations in your Voxworks team dashboard
  2. Find Microsoft 365 and click Connect
  3. Sign in with your Microsoft account that has access to Bookings
  4. Grant the required permissions for calendar access

​
2. Get Your Booking IDs

You’ll need three IDs from your Microsoft Bookings setup:

​
Business ID

  1. Go to Microsoft Bookings
  2. Select your booking page
  3. The Business ID is in the URL: https://outlook.office.com/bookings/calendar?businessId=YOUR_BUSINESS_ID

​
Service ID

  1. In Microsoft Bookings, go to Services
  2. Click on the service you want to use
  3. The Service ID is in the URL or can be found in the service settings

​
Staff Member ID

  1. In Microsoft Bookings, go to Staff
  2. Click on the staff member who will handle the appointments
  3. The Staff Member ID is in the URL or staff settings

​
Manual Inputs

NameData TypeRequiredDescription
Invitee NamestringYesFull name of person booking
Invitee EmailstringYesEmail address
Invitee PhonestringNoPhone number
MS Booking Business IDstringYesMicrosoft Bookings Business ID
MS Service IDstringYesMicrosoft Bookings Service ID
MS Staff Member IDstringYesMicrosoft Bookings Staff Member ID
Number of WeeksintegerNoWeeks of availability to check (1-8, default: 4)
SMS MessagestringNoSMS confirmation message template
You can use variables in the invitee fields:
  • [Contact - First Name] for the name
  • [Contact - Email] or [Contact - Email (Verified)] for the email
  • [Contact - Phone] for the phone number

​
Global Inputs

This tool uses the Microsoft 365 credentials configured in your team integration settings.

​
Manual Outputs

NameData TypeDescription
Resultbooltrue if booking flow completed successfully

​
Global Outputs

VariableData TypeDescription
[Calendar - Event ID]stringCombined business_id|service_id|staff_id
[Calendar - Availability - Raw]stringAvailable times in JSON format organised by week/day/time period
[Calendar - Availability - Formatted]stringHuman-readable availability summary
[Calendar - Booking Time - Raw]stringBooked time in YYYY-MM-DD HH:MM format
[Calendar - Booking Time - Written]stringBooked time in human-readable format
[Calendar - Booking Time - Spoken]stringBooked time in natural spoken format
[Calendar - Booking ID]stringBooking reference (used for cancellation)
[Calendar - Booking Error - Spoken]stringError message if booking failed (for assistant to speak)

​
Conditions

​
Success (true)

The tool returns true when:
  • The booking flow completes successfully
  • An appointment is created in O365 Bookings
  • SMS confirmation is sent (if configured)

​
Failure (false)

The tool returns false when:
  • No availability exists within the requested week range
  • The invitee email is missing or invalid
  • The selected time slot is no longer available (race condition)
  • The Microsoft 365 credentials are missing or invalid
  • A network or API error occurs

​
What This Tool Handles

This composite tool manages the complete booking workflow:
  1. Availability Check — Retrieves available time slots from O365 Bookings
  2. Time Selection — Presents options and captures user preference
  3. Booking Creation — Creates the appointment in O365 Bookings
  4. SMS Confirmation — Sends confirmation message to the invitee
  5. Cancellation — Handles cancellation if the user changes their mind

​
Troubleshooting

IssueSolution
”Invalid credentials”Reconnect Microsoft 365 in team integrations
”No availability found”Check your Bookings availability settings and date range
”Service not found”Verify the Service ID is correct and the service is active
”Staff not found”Verify the Staff Member ID is correct and staff is active
”Booking failed”Ensure the time slot is still available (race condition)

​
Next Steps