🏢 Condomatica Connector Configuration

These credentials are provided directly by your Condomatica instance or the software system administrator. The API Key is a unique authentication key for your account, while the Administrator Code identifies the specific condominium context. If you haven't received them, contact Condomatica support.

No. The code condo2025_20:1 is the default value that works for most standard Condomatica installations. Modify it ONLY if you received a personalized administrator code specific to your Condomatica instance. If unsure, leave default and test connection.

Yes. In the "Condomatica Service" section you can individually deselect tools you don't want accessible to the assistant. For example, you can enable only condomatica_search_condomino and condomatica_search_unita, leaving condomatica_search_rate disabled if you don't want the assistant to access financial data.

The assistant uses the condomatica_search_condomino tool that searches the Condomatica database using the caller's phone number. If the number is registered in the Condomatica system, the tool returns the condominium demographic data. Otherwise, the assistant can ask name and surname to search manually.

With condomatica_search_condomino: demographic data (name, surname, phone, email, tax code). With condomatica_search_unita: property unit details (building, floor, unit, shares). With condomatica_search_rate: payment status, expired/paid fees, current balance, due amounts. Depends on which tools you enabled.

No. Available tools are READ-ONLY. The assistant can only consult data (records, units, fees) but cannot modify information, register payments, create new condominiums or alter the Condomatica database in any way. For write operations, direct access to the management system is needed.

After saving configuration with API Key and Administrator Code, make a test call to the assistant and ask "Search Mario Rossi in the system" (using a name present in Condomatica). If the assistant invokes condomatica_search_condomino and returns data, connection works. Otherwise check credentials.

It's a composite format: identification prefix (condo2025), underscore separator, year/numeric code (20), colon, and version (1). This code uniquely identifies your Condomatica installation in the system. Do not modify unless Condomatica provided you a different specific code for your account.

No, not directly. Each Condomatica Connector configuration supports ONE SINGLE Administrator Code, corresponding to a specific condominium context. If you manage multiple administrators, you need to create separate AI4CALL assistants, each with its own Condomatica configuration and dedicated credentials.

Tools condomatica_search_unita and condomatica_search_rate accept tax code as search parameter. The assistant typically obtains the tax code from condomatica_search_condomino tool (which returns complete demographic data), then uses it to invoke other tools and retrieve units and fees associated with that specific condominium.

Yes. Each time the assistant invokes a Condomatica tool, a real-time API call is made to the Condomatica server. Returned data is always updated at request time. There's no local cache - each search directly queries the current Condomatica database.

All Condomatica tools will stop working immediately. The assistant will receive authentication errors when trying to invoke any tool. You will need to generate a new API Key from Condomatica settings and update it in AI4CALL configuration, then save again.

Depends on Condomatica API implementation. The condomatica_search_condomino tool accepts a textual query that is passed to Condomatica API. If API supports partial searches (e.g. search "Mar" to find "Mario"), it will work. If requires exact match, you need to provide complete name. Test with your instance.

Not at AI4CALL configuration level. Access control depends on credentials and permissions configured in Condomatica itself. If the provided API Key has access only to certain condominiums, the assistant will see only those. For granular restrictions, configure permissions directly on Condomatica.

Data extracted from Condomatica (records, units, fees) are subject to GDPR. Ensure to: inform condominiums that their data can be consulted via AI assistant, obtain consent if required, implement caller authentication (e.g. PIN) in prompt, limit enabled tools only to necessary ones, record accesses for audit trail.

Yes. If a condominium owns multiple units (e.g. apartment + garage), condomatica_search_unita will return ALL units associated with the tax code. The assistant can then list them to the condominium and ask for which unit they want to verify fees, before invoking condomatica_search_rate.

The tool returns: fee list with due dates and amounts, status of each fee (paid/expired/partial), current total balance, any delay interests, payment history made. Exact data structure depends on Condomatica API, but typically includes all financial information related to the property unit.

Yes, absolutely. The assistant can combine different tools. Example workflow: use condomatica_search_rate to verify expired fees, then use send_whatsapp_message or send_email to automatically send a payment reminder to the condominium. MCP tools are composable and LLM orchestrates them autonomously.

During the call, you can monitor assistant logs in AI4CALL panel that show when and with which parameters condomatica_search_* tools are invoked. Also, the assistant typically communicates to condominium what it's doing (e.g. "I'm searching your units in the system", "I'm verifying payment status").

Depends on configured API endpoint. If your Condomatica installation is on-premise with REST APIs exposed and reachable from AI4CALL, the plugin can work. If Condomatica is only local without exposed APIs, it's not compatible. Verify with your Condomatica system administrator if REST APIs are available and accessible.