Description

What does this tool do?

Prerequisites

• None

Get Started:

1. Creating a new tool

   Open your agent and open up the tool menu. E.g., “Tools & Abilities”, “Custom Tools”

   

2. Create a tool

   

Build the Tool:

Procedure

1. Creating a new tool

   1. Open your agent and open up the tool menu. E.g., “Tools & Abilities”, “Custom Tools”

      

   2. Create a tool

      

2. Configure tool:

   1. Obtain the calendar ID from your calendar system.

   2. Tool Name: multical_get_available_slots

   3. Confirm the Tool Description matches.

      Get available appointment slots for a specified calendar and date range. Call this tool when a user needs to see available booking times. The tool will return all available time slots grouped by date in the specified time zone. Always align your internal clock before using this tool to be sure of dates dynamically and accurately. Confirm internally that the timestamps are for future dates. Before calling, confirm the booking purpose: Use appropriate calendar ID for the appointment.

      Options: Based on how complex your setup is and how descriptive your calendar names are, you may wish to use one of the following.

      Option 1: Use the description above and make sure the calendar names are descriptive. E.g.: “Demo Calendar”, “Discovery Calendar”

      Option 2: Replace the last sentence of Tool Description with an instruction when to use each calendar. E.g.:

      Before calling tool, confirm the booking purpose: 
      - Demos: <CALENDAR_NAME>
      - Discovery: <CALENDAR_NAME>
      

      Option 3: Modify prompt to include a description of when to use each calendar. E.g.:

      EXAMPLE 1:
      7. RUN tool `get_available_slots_bridge_v1` using the correct calendar based on their Zip Code
      - 78536, 85821, 58204: <CALENDAR_NAME/ID>
      - 78534, 91202: <CALENDAR_NAME/ID>
      EXAMPLE 2:
      7. RUN tool `get_available_slots_bridge_v1` using the calendar for their request:
      - 90 minute Deep Tissue Massage: <CALENDAR_NAME/ID>
      - 60 minute Ashiatsu Massage: <CALENDAR_NAME/ID>
      

   4. Confirm URL set to: https://api.app-x.co/get-ghl-multical-free-slots

      

   5. Authorization Required should be set to NO.

      

   6. Set the parameters

      • Text / JSON
      • Image / Form

   7. Click “Save“

   8. Click “Add to Assistant“

      

   9. Click “Save” on your Assistant

   10. Test: Use a method (call/text/chat) and ask to get availability for that calendar

   11. Done ✅ - Make sure to add any other endpoints you need for this flow (i.e., “Booking Appointment Bridge”).

Response Codes

N/a