🏢 Configurazione Condomatica Connector

Queste credenziali sono fornite direttamente dalla tua istanza Condomatica o dall'amministratore di sistema del software. L'API Key è una chiave di autenticazione univoca per il tuo account, mentre il Codice Amministratore identifica il contesto condominiale specifico. Se non le hai ricevute, contatta il supporto Condomatica.

No. Il codice condo2025_20:1 è il valore di default che funziona per la maggior parte delle installazioni standard di Condomatica. Modificalo SOLO se hai ricevuto un codice amministratore personalizzato specifico dalla tua istanza Condomatica. Se non sei sicuro, lascia il default e testa la connessione.

Sì. Nella sezione "Condomatica Service" puoi deselezionare singolarmente i tool che non vuoi rendere accessibili all'assistente. Ad esempio, puoi abilitare solo condomatica_search_condomino e condomatica_search_unita, lasciando disabilitato condomatica_search_rate se non vuoi che l'assistente acceda ai dati finanziari.

L'assistente usa il tool condomatica_search_condomino che cerca nel database Condomatica usando il numero di telefono del chiamante. Se il numero è registrato nel sistema Condomatica, il tool restituisce i dati anagrafici del condomino. Altrimenti, l'assistente può chiedere nome e cognome per cercare manualmente.

Con condomatica_search_condomino: dati anagrafici (nome, cognome, telefono, email, codice fiscale). Con condomatica_search_unita: dettagli unità immobiliari (scala, piano, interno, millesimi). Con condomatica_search_rate: stato pagamenti, rate scadute/pagate, saldo corrente, importi dovuti. Dipende da quali tool hai abilitato.

No. I tool disponibili sono in SOLA LETTURA. L'assistente può solo consultare dati (anagrafica, unità, rate) ma non può modificare informazioni, registrare pagamenti, creare nuovi condomini o alterare il database Condomatica in alcun modo. Per operazioni di scrittura serve accesso diretto al gestionale.

Dopo aver salvato la configurazione con API Key e Codice Amministratore, fai una chiamata di prova all'assistente e chiedi "Cerca Mario Rossi nel sistema" (usando un nome presente in Condomatica). Se l'assistente invoca condomatica_search_condomino e restituisce dati, la connessione funziona. Altrimenti controlla le credenziali.

È un formato composto da: prefisso identificativo (condo2025), separatore underscore, anno/codice numerico (20), due punti, e versione (1). Questo codice identifica univocamente la tua installazione Condomatica nel sistema. Non modificarlo a meno che Condomatica non ti abbia fornito un codice diverso specifico per il tuo account.

No, non direttamente. Ogni configurazione Condomatica Connector supporta UN SOLO Codice Amministratore, che corrisponde a un contesto condominiale specifico. Se gestisci più amministratori, devi creare assistenti AI4CALL separati, ciascuno con la propria configurazione e credenziali Condomatica dedicate.

I tool condomatica_search_unita e condomatica_search_rate accettano il codice fiscale come parametro di ricerca. L'assistente tipicamente ottiene il codice fiscale dal tool condomatica_search_condomino (che restituisce i dati anagrafici completi), poi lo usa per invocare gli altri tool e recuperare unità e rate associate a quel condomino specifico.

Sì. Ogni volta che l'assistente invoca un tool Condomatica, viene effettuata una chiamata API in tempo reale al server Condomatica. I dati restituiti sono sempre aggiornati al momento della richiesta. Non c'è cache locale - ogni ricerca interroga direttamente il database Condomatica attuale.

Tutti i tool Condomatica smetteranno di funzionare immediatamente. L'assistente riceverà errori di autenticazione quando prova a invocare qualsiasi tool. Dovrai generare una nuova API Key dalle impostazioni Condomatica e aggiornarla nella configurazione AI4CALL, poi salvare nuovamente.

Dipende dall'implementazione API di Condomatica. Il tool condomatica_search_condomino accetta una query testuale che viene passata all'API Condomatica. Se l'API supporta ricerche parziali (es. cercare "Mar" per trovare "Mario"), funzionerà. Se richiede match esatto, dovrai fornire nome completo. Testa con la tua istanza.

Non a livello di configurazione AI4CALL. Il controllo accessi dipende dalle credenziali e permessi configurati in Condomatica stessa. Se l'API Key fornita ha accesso solo a determinati condomini, l'assistente vedrà solo quelli. Per restrizioni granulari, configura i permessi direttamente su Condomatica.

I dati estratti da Condomatica (anagrafica, unità, rate) sono soggetti a GDPR. Assicurati di: informare i condomini che i loro dati possono essere consultati via assistente AI, ottenere consenso se richiesto, implementare autenticazione chiamante (es. PIN) nel prompt, limitare i tool abilitati solo al necessario, registrare accessi per audit trail.

Sì. Se un condomino possiede più unità (es. appartamento + box), condomatica_search_unita restituirà TUTTE le unità associate al codice fiscale. L'assistente può poi elencarle al condomino e chiedergli per quale unità vuole verificare le rate, prima di invocare condomatica_search_rate.

Il tool restituisce: elenco rate con scadenze e importi, stato di ogni rata (pagata/scaduta/parziale), saldo corrente totale, eventuali interessi di mora, storico pagamenti effettuati. La struttura dati esatta dipende dall'API Condomatica, ma tipicamente include tutte le informazioni finanziarie relative all'unità immobiliare.

Sì, assolutamente. L'assistente può combinare tool diversi. Esempio workflow: usa condomatica_search_rate per verificare rate scadute, poi usa send_whatsapp_message o send_email per inviare automaticamente un sollecito di pagamento al condomino. I tool MCP sono componibili e l'LLM li orchestra autonomamente.

Durante la chiamata, puoi monitorare i log dell'assistente nel pannello AI4CALL che mostrano quando e con quali parametri vengono invocati i tool condomatica_search_*. Inoltre, l'assistente tipicamente comunica al condomino cosa sta facendo (es. "Sto cercando le tue unità nel sistema", "Verifico lo stato dei pagamenti").

Dipende dall'endpoint API configurato. Se la tua installazione Condomatica è on-premise con API REST esposte e raggiungibili da AI4CALL, il plugin può funzionare. Se Condomatica è solo locale senza API esposte, non è compatibile. Verifica con il tuo amministratore sistema Condomatica se le REST API sono disponibili e accessibili.