User manual — Xabia Avirato (addon for Avirato)

Quick Installation Guide

1. Install and activate Xabia Agent Core .
2. Install and activate the Xabia Avirato ZIP from Plugins → Add new → Upload plugin .
3. In Xabia Agent → Addons , activate or synchronize the Avirato addon license until the Hub recognizes it.
4. Create or edit the agent that will use reservations and open the Avirato tab.
5. Enter the establishment ID (webcode) , the engine URL , and, if necessary, inclusion/exclusion filters.
6. Save the agent and test availability with real dates in Playground .
7. Publish the chat using a shortcode or the native Core interface.
8. Verify that the booking links open the Avirato engine with correct dates and IDs.

Part 1 — What it is and what it is for

1.1 Brief definition

Xabia Avirato is an add-on (extra plugin) that is installed on top of Xabia Agent Core . It connects your Xabia chat with the Avirato online booking engine that your guests already know (the usual address is the Avirato booking page) so you can:

• Check if there are rooms or houses available or occupied on specific dates.
• Display prices when the engine returns them.
• Generate booking links with the correct identifiers.
• Recognize when a visitor requests a specific house or room by name.
• Suggest alternatives if the requested house is full and, when possible, indicate a next available date .

It does not replace the Avirato panel or the legal configuration of prices and conditions on its website; it is an automated query layer for the chat.

1.2 What problem does it solve?

Without this add-on, an AI assistant might fabricate availability or simply refer users to the website. With Xabia Avirato, availability responses are based on data from the actual booking engine , presented in an organized way and with helpful links.

1.3 Essential requirements

Part 2 — Step-by-step installation

2.1 Before starting

1. Have on hand the ZIP file of the add-on that was provided to you by Xabia or your distributor (the name may vary in each package).
2. Please confirm that Xabia Agent Core is already installed in Plugins and is active .

2.2 Install the ZIP file in WordPress

1. Log in to the WordPress dashboard as an administrator.
2. Go to Plugins >

   Add new.

3. Click Upload plugin .
4. Choose the Xabia Avirato ZIP file.
5. Click Install now , and then Activate plugin .

2.3 Correct activation order

• The usual order is: first Core , then Xabia Avirato.
• If you activate Xabia Avirato without having the Core active, WordPress will display a warning informing you that the main Xabia plugin is required first.

2.4 Check that the add-on is recognized

In Xabia Agent → Addons, you can view Xabia Avirato in the cards, enter or check the addon license key (Hub validation), and access the Polar store ( polar.sh/xabia ) and the customer portal ( polar.sh/xabia/portal ) for subscriptions. The addon typically doesn’t have its own separate menu : the establishment ID , engine URL, and filters are configured within each agent , in the Avirato tab (see below).

📢 Note on pricing: The Avirato subscription price (and the price of all other add-ons) is updated in real time at https://xabia.ai/precio . The Add-ons panel displays an estimate, not a fixed price.

Part 3 — Where to configure (desktop navigation)

3.1 General Route

1. Xabia Agent (or the name of the menu your installation uses for the Core).
2. Edit the agent/project that Avirato should use (each site can have multiple agents).
3. Look for the “Avirato” tab in the agent’s profile.

3.2 How the data is saved

The fields are saved when you click Save Agent on that same screen — you don’t have to look for any loose files: WordPress stores that information in your installation .

Part 4 — Configuration fields (detailed explanation)

4.1 Establishment ID

• What it is: the web code of the establishment in Avirato, the same one used by the booking engine in the URL.
• Format: usually a number (illustrative example: 12345678 ).
• Importance: This is the most critical field. If it is empty or incorrectly copied, there will be no correct engine reading.
• Automatic configuration (optional): If you already use the Avirato Calendar plugin on the same website and that plugin has correctly loaded the webcode , the field can be populated automatically. Without that calendar, always copy the number manually from your Avirato dashboard.

4.2 Public name of the accommodation

• What it is: the name the assistant will use to refer to “your” offer when there is no other context (for example, “El Roble rural house”).
• If you leave it empty: the inclusion filter will be used as a readable label, or a generic text such as “the configured accommodation”.

4.3 Inclusion Filter

• What it is: a fragment of text that must contain the names of space types (subtypes) that you do want to offer.
• Example: If all your houses are listed in the catalog as “demo-rural”, you can use demo-rural so that only those are included in the responses.
• Technical effect: limits which catalog lines are considered “valid”;

  If it is too strict, it may seem that “there is no availability” even though there are other rooms in Avirato.

4.4 Room/House IDs (optional)

• What it is: one or more internal space type numbers ( rooms or houses in the Avirato system), separated by hyphens when there are several.
• Automatic: If you filled in the inclusion filter and the establishment ID is correct, the plugin can fill in those numbers by bringing them from the Avirato Calendar you have in WordPress.
• Manual: You can set them yourself if you know the exact IDs.

4.5 Exclusion List

• What it is: words separated by commas (without complicating the format).
• Usage: exclude accommodations whose name contains that fragment (e.g., tests, houses closed for the season, etc.).
• Comparison: does not distinguish between uppercase and lowercase; the normalized name is used.

4.6 Promotional code (optional)

• If your campaign uses code in the engine, you can specify it here so that the generated URLs include the promotion parameter when Avirato supports it, in the same way that the add-on constructs the request.

4.7 Engine URL

• Typical value: The web address of the booking engine provided by Avirato (usually Booking.com ; it’s generally recommended to also include the trailing slash as instructed by your team). Only change this if your provider has instructed you to use a different address . If you enter it incorrectly, the chat will not be able to properly check availability.

Part 5 — Day-to-day management

5.1 Verify license and add-on

• Xabia site license and token balance are managed on the Core main screen: Core Manual — AI Connection and Wallet .
• The Avirato add-on license (subscription validated in the Hub) is entered in Xabia Agent → Addons , under Avirato. There you can purchase or renew it on Polar — xabia (prices at xabia.ai/precio ) and manage the subscription in the Polar portal . If the renewal date is 30 days or less , a notification may appear on the same screen.
• If, after purchasing or pasting the key, the Hub still doesn’t recognize the add-on, wait a few minutes, reload the Add-ons , and, if necessary, contact support with your proof of purchase. Visitors should not expect to see technical license errors in the chat; it will only provide informational contact details.

5.2 Season or catalog changes

• If you add or rename houses in Avirato, review the inclusion filter and exclusion list to ensure they still make sense.
• If you use the Avirato calendar in WordPress, sync or update data according to that plugin’s procedure to ensure that subtypes and webcodes are up to date.

5.3 Test before advertising

1. Open the playground or chat on a test page.
2. Try phrases with clear dates (see Part 6).
3. Try the name of a specific house that exists in the catalog.
4. Click the booking link and confirm that it opens the engine with consistent dates and IDs.

5.4 Privacy and data

• The add-on queries the public booking engine (HTTP request to the same type of URL a user would see in their browser). It does not replace your website’s privacy policies or legal texts; the website owner must continue to comply with GDPR and Avirato’s terms and conditions.

Part 6 — How the visitor uses it (chat experience)

6.1 Which phrases “activate” availability

The system looks for availability intent or dates in the message.

Among others, it reacts to terms such as: availability, reservation, accommodation, nights, stay, month names, “this week”, “weekend”, “Easter”, date ranges in text or DD/MM/AAAA or AAAA-MM-DD format, etc.

6.2 Dates in natural language

The add-on interprets many Spanish expressions, for example:

• Weeks of the month (“first week of July”), fortnights, middle of the month, beginning/end of the month.
• “One week” or duration in nights or days (adjust the output according to what the user says).
• Some fixed calendar expressions (e.g., certain long weekends or holidays depending on the plugin version).

If the user is vague about the dates, the system deduces a reasonable range; the more specific the visitor is, the more reliable the result.

6.3 Engine Language

• The language used to view the availability page follows the language chosen by the visitor in the chat (Spanish, English, etc.). If this information is not received from the front end, Spanish will usually be available as a fallback.
• Since Core v1.0.57, the AI response is multilingual : Xabia attempts to respond in the language of the user’s last message, even if the site or shortcode settings are in a different language. The language parameter remains useful for the interface, voice, and engine query, but it no longer blocks the assistant’s final output.

6.4 Requesting a house or room by name

• If the name matches a hosting on your list in Avirato Calendar , or when the Core project marks a consistent IDENTITY (ENTITY) , the system can focus on that unit first for the same date.
• If that unit is occupied , the message will indicate this, show other free options on the same dates if available, and may suggest the next available window by searching for nearby dates.

6.5 Force a “fresh” query (without depending on recent cache)

If the visitor types things like update , refresh , look again , check again , etc., the system may skip the recent cache and query the engine again.

6.6 Booking links

When a place becomes available, the response will typically include a booking button or a clickable link, depending on how Xabia’s template is visually set up.

Part 7 — Token Consumption and AI

• Direct availability answers using this plugin’s template can be resolved without calling the language model at that time, so many practical date queries may not consume tokens .

Part 8 — Common messages and what they mean

Part 9 — Troubleshooting (checklist)

1. Active Core and active Xabia Avirate .
2. Correct establishment ID (copied from the Avirato environment / engine web).
3. Correct URL of the engine ( https://booking.avirato.com/ unless otherwise indicated).
4. Inclusion filter not too restrictive for initial testing (can be left empty at first to validate reading and then fine-tuned).
5. Exclusions: Please confirm that you are not mistakenly excluding the entire catalog.
6. Xabia Agent → Addons: Avirato key validated in the Hub (and active subscription in Polar if applicable).
7. Try incognito mode after clearing the site cache if you use aggressive front-end caching plugins.
8. If you use Avirato Calendar , please confirm that you have refreshed properties and types there before expecting automatic room numbering here.

Part 10 — Good practices

• Validate the webcode with a manual booking in the engine before trusting the chat.
• Adjust public name and filters so that the bot’s tone matches your brand.
• Do not use PDFs or static documents as a substitute for live availability ; the value of the add-on is precisely the query to the engine.
• Periodically review the links after major updates to Avirato or the site theme.

Part 11 — Support

Xabia (installation, Core license, add-ons): same usual Xabia help email.

Issues related to the contract with Avirato only (not the Xabia plugin): your Avirato business contact.

For licensing , wallet , and global settings, open the Core Manual .