Integration with IdoBooking

The IdoBooking integration allows you to connect your ChatLab chatbot with your IdoBooking reservation system to provide real-time availability information and booking assistance to your customers.

Overview

With the IdoBooking integration enabled, your chatbot can:

  • Retrieve information about available rooms and accommodations

  • Check availability for specific dates

  • Access reservation details

  • Provide booking assistance to your guests

Note: This integration requires a Standard or Premium subscription and must be enabled for your account. If you don't see the IdoBooking option in your integrations, please contact support to enable it.

Part 1: Creating an API User in IdoBooking

Before connecting ChatLab to your IdoBooking system, you need to create a dedicated user with API access in your IdoBooking panel.

Step 1: Navigate to User Management

  1. Log in to your IdoBooking administration panel

  2. Go to 'Settings' → 'Users'

  3. Click Add new user

IdoBooking users creation

Step 2: Create User Account

  1. Enter a login name for the new user (e.g., "chatlab-api")

  2. Fill in the remaining required information

  3. Set a secure password for this account

New idobooking user

Step 3: Configure API Access

Configure the following access settings for the new user:

  1. Enable "Active API access" - This is required for the integration to work

  2. Disable "Active panel access" - The user does not need access to the admin panel

Step 4: Set User Role and Permissions

You have two options for configuring the user role:

Option A: Administrator Role (Simpler)

  • Select Administrator as the role
  • Since the user won't have panel access, this is a safe option that grants full API permissions

Option B: Custom User Role (More Granular)

If you prefer more granular control, select Custom user and configure the following module permissions:

Module Permission Level
Reservations Read-only (if chatbot should only retrieve reservation info) OR Full access (if chatbot will create reservations)
Customers Read-only
Offers Read-only

User roles for idobooking integration

For custom users, you also need to configure location permissions:

  1. Scroll to Location and accommodation permissions section

  2. We recommend selecting Select all to grant access to all properties

Set permissions to all locations

Step 5: Disable Unnecessary Notifications

To prevent the API user from receiving operational notifications, disable the following options:

  • Notifications for property staff - Disable

  • Automatic email notifications - Disable

Disable notifications

Step 6: Save and Gather Connection Details

  1. Click Save to create the user account

  2. Note down the following information - you'll need it for ChatLab configuration:

Information Description Example
Login The username you created chatlab-api
Password The password you set (your secure password)
Subdomain Your IdoBooking subdomain client3760

Finding your subdomain: Look at your IdoBooking panel URL. For example, if your URL is https://client3760.idosell.com, your subdomain is client3760.

Part 2: Setting Up the Integration in ChatLab

Prerequisites

Before you begin, make sure you have the following information from your IdoBooking account:

  1. Login - The username of the API user you created

  2. Password - The password for the API user

  3. Subdomain - Your IdoBooking subdomain (e.g., "client3760")

Step-by-Step Setup

Step 1: Navigate to Connect tab

  1. Log in to your ChatLab admin panel

  2. Select the bot you want to configure

  3. Go to Connect tab

  4. Find and click on IdoBooking in the integrations list

IdoBooking to connect

Step 2: Enter Connection Details

Fill in the connection form with the information gathered from IdoBooking:

1. Subdomain

  • Enter your IdoBooking subdomain (without the full URL)

  • Example: client3760 (not https://client3760.idosell.com)

2. Login

  • Enter the username of the API user you created in IdoBooking

3. Password

  • Enter the password for the API user

  • This field is password-protected and will be hidden after entry

Setup integration with IdoBooking

Step 3: Connect

  1. After filling in all required fields, the Connect button will become active

  2. Click Connect to establish the connection

  3. Wait for the confirmation message

  4. Once connected, you'll see a success notification

Step 4: Verify Connection

After successful connection:

  • The button will change from "Connect" to "Update Chatbot"

  • A "Disconnect" button will appear if you need to disable the integration

  • The integration status will show as active

Part 3: Configuring AI Actions

Once your IdoBooking integration is connected, you need to configure which AI actions your chatbot can perform.

Available AI Actions

(This section will be updated with specific AI actions available for IdoBooking integration)

Activating AI Actions

  1. After connecting, click Configure AI Actions in the success modal OR Navigate to Bot Settings → Actions and find the IdoBooking category

  2. Activate the actions you want to enable

  3. Customize action labels and instructions as needed

  4. Click Save to activate each action

IdoBookingActions

Best Practices

Security Recommendations

  1. Use a dedicated API user:

    • Create a separate user specifically for the ChatLab integration
    • Don't use your personal admin account

  2. Minimal permissions:

    • Only grant the permissions necessary for your use case
    • Use read-only access if the chatbot only needs to retrieve information

  3. Regular credential rotation:

    • Periodically update the API user password
    • Update the credentials in ChatLab after changes

Optimizing Chatbot Responses

  1. Train your bot with property information:

    • Add descriptions of your accommodations to the knowledge base
    • Include amenities, room features, and location details

  2. Set clear conversation flows:

    • Configure welcome messages that guide users to ask about availability
    • Use suggested questions like "Check availability" or "View rooms"

Troubleshooting

Issue Solution
Connection fails Verify that "Active API access" is enabled for the user in IdoBooking
"Access denied" errors Check that the user has the correct module permissions
No data returned Ensure the user has access to the relevant locations/properties
Incorrect subdomain Check your IdoBooking URL and extract only the subdomain part

Support

If you encounter any issues or need assistance:

  1. Verify all connection details are correctly entered

  2. Check that the API user is properly configured in IdoBooking

  3. Test API access directly in your IdoBooking panel if available

  4. Contact ChatLab support with specific error messages or behavior