Procedure

  1. Creating a new tool

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

      image.png

    2. Create a tool

      image.png

  2. Configure tool:

    1. Obtain the following information from your Booker.com account:

      1. booker_client_id
      2. booker_client_secret
      3. booker_subscription_key
      4. locationIds : Booker > System settings > General Settings > Location info
      5. serviceIds : Booker > System settings > Services (in the ID column)

      Note: This would be found in an email from Booker.com when you set up your account with them. Email [email protected] if you need a copy.

    2. Confirm the Tool Description and Arguments match.

    3. Title / Tool Name: get_booker_availability (add a random number after this name so that it doesn’t cause duplication issues - e.g., ‘get_booker_availabilty_29481)

    4. Example Tool Description:

      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. Before checking, always confirm the time against the system before making this call.

      Optional: Based on how complex your setup is and how descriptive your calendar names are, you may wish to use one of the following. Consider using the method described in the Multi-calendar Flow to define which calendars to use.

    5. Confirm Request URL set to POST: https://api.app-x.co/booker/bookingWindows

      Note: Do not hit save NOR “Initialize” until all of the correct values are set. This may cause an issue with your voice provider and may timeout before you can update the values.

      1. Set the parameters:
        • Text / JSON
        • Image / Form

  3. Save the tool

  4. Make sure the tool is active or added to the agent.

    image.png

  5. Save or Publish the agent

    1. Test: Use a method (call/text/chat) and ask to get availability for that calendar
    2. Done ✅ - Make sure to add any other endpoints you need for this flow (e.g., “Booking Appointment Tool”.

Response Codes

N/a