🏢 Configuración Condomatica Connector

Guía completa para integrar el sistema de gestión Condomatica con AI4CALL mediante plugin MCP para consultar registros, unidades inmobiliarias y cuotas condominales

AI4CALL - Configuración MCP Condomatica Connector

Ve a "MARKET""Marketplace Plugin" y haz clic en Comprar de "Condomatica Connector"FREE

Ve a "MARKET""Mis Plugins" y haz clic en Configurar de "Condomatica Connector"

⚠️ Servicios de terceros

Las integraciones descritas se refieren a servicios de terceros.
Los límites de tasa, métodos de autenticación, configuraciones técnicas, costes y políticas son definidos exclusivamente por los respectivos proveedores y pueden cambiar con el tiempo.

Los costes de los servicios externos son asumidos directamente por el usuario final a los proveedores de los servicios mismos y de ninguna manera son gestionados o intermediados por nuestro portal (por ejemplo, Meta u otros proveedores para WhatsApp, Zapier, Calendly, etc.).

⚠️ IMPORTANTE - Plugin de solo lectura
El Condomatica Connector permite SOLO consultar datos del sistema de gestión.

El asistente puede buscar comunidades de propietarios, visualizar unidades inmobiliarias y verificar cuotas/pagos, pero NO puede modificar datos, registrar pagos, crear nuevos registros o alterar la base de datos de Condomatica de ningún modo.

Todas las operaciones son de solo lectura mediante REST API de Condomatica.

1

Obtén las credenciales API de Condomatica

Para conectar AI4CALL a Condomatica, necesitas dos credenciales específicas proporcionadas por tu instalación del software de gestión.

🔑 credenciales necesarias:
  • API Key: clave de autenticación única para acceder a las REST API de Condomatica
    → formato: cadena alfanumérica larga (ej. "eyJhbGciOiJIUzI1NiIsInR5cCI6...")
  • Código Administrador: identificador del contexto condominal específico
    → formato por defecto: condo2025_20:1
    → modificar solo si has recibido un código personalizado
📧 Cómo obtener las credenciales
Las credenciales son proporcionadas por:
  • Administrador de sistema Condomatica: si tu empresa gestiona directamente el software
  • Soporte Condomatica: contacta al soporte técnico del software y solicita las credenciales API para integración externa
  • Panel Condomatica: algunas instalaciones tienen una sección API/Integraciones donde generar las claves autónomamente

Nota: sin credenciales válidas no es posible proceder con la integración.
🔒 Seguridad credenciales
La API Key garantiza acceso completo a los datos de tu sistema de gestión condominal:
  • Registro de comunidades (nombres, apellidos, contactos, códigos fiscales)
  • Unidades inmobiliarias (escaleras, plantas, milésimas)
  • Datos financieros (cuotas, pagos, saldos)

Trata la API Key como una contraseña: no la compartas, no la publiques, revócala inmediatamente si sospechas que ha sido comprometida.
2

Configura el plugin Condomatica en AI4CALL

Ingresa las credenciales obtenidas en el panel de configuración AI4CALL para activar la conexión.

🎯 procedimiento de configuración:
  1. Selecciona "Condomatica Connector" de la lista de plugins
  2. En la sección "Credenciales API Condomatica", ingresa:
    • API Key: pega la clave API proporcionada por Condomatica
    • Código Administrador: ingresa el código (por defecto: condo2025_20:1)
  3. Haz clic en "GUARDAR CONFIGURACIÓN"
ℹ️ Código administrador por defecto
El valor condo2025_20:1 es el código administrador estándar que funciona para la mayoría de las instalaciones Condomatica.

Cuándo usar el por defecto:
  • Si no has recibido un código personalizado de Condomatica
  • Si tu instalación es estándar/cloud
  • Si el soporte Condomatica no te ha comunicado un código diferente

Cuándo modificarlo:
  • Solo si Condomatica te ha proporcionado explícitamente un código administrador personalizado
  • Si tienes instalación on-premise con configuración personalizada

En caso de duda, deja el por defecto y prueba la conexión.
⚠️ Verifica credenciales antes de guardar
Asegúrate de tener las credenciales correctas ANTES de guardar la configuración.

Si guardas credenciales erróneas:
  • Las herramientas Condomatica no funcionarán
  • El asistente recibirá errores de autenticación
  • Tendrás que reingresar credenciales correctas y guardar nuevamente

Verifica que la API Key esté completa (sin espacios iniciales/finales) y que el Código Administrador sea exacto.
Configuración Credenciales
Panel "Configurar Condomatica": ingreso de API Key y Código Administrador
3

Selecciona las herramientas a habilitar

Elige qué operaciones puede ejecutar el asistente sobre Condomatica habilitando o deshabilitando individualmente las herramientas disponibles.

🛠️ herramientas disponibles (Condomatica Service):
  • ☑️ condomatica_search_condomino
    busca un propietario en el sistema Condomatica usando el número de teléfono
    → devuelve: nombre, apellido, email, código fiscal, datos de registro
  • ☑️ condomatica_search_unita
    busca una unidad inmobiliaria asociada a un propietario mediante código fiscal
    → devuelve: escalera, planta, interno, milésimas, tipo de unidad
  • ☑️ condomatica_search_rate
    busca las cuotas condominales asociadas a un propietario mediante código fiscal
    → devuelve: cuotas vencidas/pagadas, saldo, importes, vencimientos
💡 Configuraciones recomendadas para escenarios comunes
Escenario 1: asistente informativo completo
✅ Habilita TODAS las 3 herramientas
El asistente puede responder a cualquier pregunta: quién llama, qué apartamento, cuánto debe

Escenario 2: solo información general (no datos financieros)
✅ condomatica_search_condomino
✅ condomatica_search_unita
❌ condomatica_search_rate (deshabilitado)
El asistente identifica propietarios y unidades pero no accede a datos de pago

Escenario 3: solo identificación del llamante
✅ condomatica_search_condomino
❌ condomatica_search_unita (deshabilitado)
❌ condomatica_search_rate (deshabilitado)
El asistente reconoce quién llama pero no accede a detalles inmobiliarios o financieros
🔗 Dependencias entre herramientas
Las herramientas tienen dependencias lógicas:

condomatica_search_condomino (primer paso)
↓ proporciona código fiscal necesario para:
condomatica_search_unita (segundo paso)
↓ proporciona ID de unidad necesario para:
condomatica_search_rate (tercer paso)

Si habilitas condomatica_search_rate pero deshabilitas condomatica_search_unita, ¡el asistente no podrá obtener el ID de unidad necesario para buscar las cuotas!

Regla: si habilitas una herramienta "aguas abajo", habilita también las "aguas arriba" de las que depende.
4

Prueba la conexión

Verifica que el plugin esté correctamente configurado y que el asistente pueda acceder a los datos Condomatica.

✅ prueba rápida de la conexión:
Método 1: prueba con nombre de propietario conocido
  1. Haz una llamada de prueba a tu asistente
  2. Pregunta: "Busca Mario Rossi en el sistema" (usa un nombre realmente presente en Condomatica)
  3. El asistente debería invocar condomatica_search_condomino
  4. Si devuelve datos (nombre, apellido, email, etc.), la conexión funciona ✅

Método 2: prueba con flujo de trabajo completo
  1. Pregunta: "Busca Mario Rossi y dime qué unidades posee"
  2. El asistente debería:
    • Invocar condomatica_search_condomino(query="Mario Rossi")
    • Extraer el código fiscal de la respuesta
    • Invocar condomatica_search_unita(codice_fiscale="...")
    • Listar las unidades encontradas (escalera, planta, interno)
  3. Si el flujo de trabajo funciona de extremo a extremo, todo está configurado correctamente ✅
¡Conexión exitosa!
Si el asistente responde correctamente con datos de Condomatica, significa que:
  • La API Key es válida y aceptada
  • El Código Administrador es correcto
  • Las REST API de Condomatica son accesibles
  • Las herramientas seleccionadas están expuestas y funcionando

¡Puedes proceder con la instrucción del asistente para los flujos de trabajo operativos! 🎉
Si la prueba falla
Posibles causas de error:

1. Error de autenticación:
  • API Key inválida o caducada → verifica con Condomatica
  • Código Administrador erróneo → prueba el por defecto condo2025_20:1
  • Credenciales copiadas mal (espacios extra) → reingresa cuidadosamente

2. Propietario no encontrado:
  • Nombre buscado no existe en Condomatica → prueba con otro nombre
  • La búsqueda requiere coincidencia exacta → usa nombre completo preciso
  • Base de datos Condomatica vacía o de prueba → verifica con administrador

3. Herramienta no disponible:
  • Herramienta no habilitada en la sección "Condomatica Service" → verifica casilla
  • Configuración no guardada → revisa y guarda nuevamente

En caso de error persistente, contacta al soporte AI4CALL con el mensaje de error específico.
5

Instruye al asistente para los flujos de trabajo

Configura el prompt del asistente para usar correctamente las herramientas Condomatica en los flujos conversacionales con los propietarios.

📝 Flujos de trabajo recomendados para insertar en el prompt
1. Identificación automática del llamante:
"Al inicio de cada llamada, usa condomatica_search_condomino con el número de teléfono del llamante para identificarlo automáticamente. Si es encontrado, saluda con el nombre (ej. 'Buenos días Sr. Rossi'). Si no es encontrado, pide nombre y apellido para buscar manualmente."

2. Verificación estado de pagos:
"Si el propietario pregunta información sobre pagos o cuotas: (1) identifícalo con search_condomino, (2) recupera las unidades con search_unita, (3) si tiene más unidades pregunta cuál, (4) usa search_rate para mostrar saldo y cuotas vencidas/pagadas. Especifica siempre los importes y los vencimientos."

3. Información de unidades inmobiliarias:
"Para preguntas sobre escalera/planta/interno/milésimas: usa search_condomino para identificar, luego search_unita para recuperar detalles. Presenta la información de manera clara (ej. 'Su apartamento es escalera A, planta 2, interno 5')."

4. Privacidad y seguridad:
"Antes de proporcionar información sensible (saldo, cuotas), verifica la identidad del llamante. Pide fecha de nacimiento u otro dato personal para confirmación. No divulgues datos financieros si no estás seguro de la identidad."
🔒 GDPR y protección de datos personales
Los datos extraídos de Condomatica son datos personales sensibles sujetos a GDPR:

Obligaciones legales:
  • Informar a los propietarios que sus datos pueden ser consultados mediante asistente AI
  • Obtener consentimiento explícito si lo requiere la normativa
  • Implementar medidas de seguridad (ej. autenticación del llamante con PIN/fecha de nacimiento)
  • Limitar acceso solo a los datos necesarios (deshabilita herramientas no esenciales)
  • Mantener registros de accesos para auditoría
  • Definir tiempos de conservación de grabaciones de llamadas

Mejores prácticas: inserta en el prompt instrucciones para solicitar confirmación de identidad antes de divulgar datos financieros sensibles.

Escenario 1: verificación de saldo y cuotas vencidas

Conversación:
Propietario llama: número 333-1234567

Asistente: [invoca condomatica_search_condomino(query="3331234567")]
→ encuentra: Mario Rossi, CF: RSSMRA80A01F205X

Asistente: "Buenos días Sr. Rossi, ¿en qué puedo ayudarle?"

Propietario: "Me gustaría saber si he pagado todo y cuánto debo aún."

Asistente: "Verifico enseguida. Por seguridad, ¿me confirma su fecha de nacimiento?"

Propietario: "1 de enero de 1980"

Asistente: [verifica que coincide con CF] "Perfecto, gracias. Un momento que compruebo..."

Asistente: [invoca condomatica_search_unita(codice_fiscale="RSSMRA80A01F205X")]
→ encuentra: Escalera A, Planta 2, Interno 5 (ID: U_12345)

Asistente: [invoca condomatica_search_rate(unita_id="U_12345")]
→ encuentra: Saldo -450€, 2 cuotas vencidas (150€ dic 2024, 300€ ene 2025)

Asistente: "Para su apartamento escalera A, planta 2, interno 5, resultan 2 cuotas vencidas:
• Diciembre 2024: 150 euros (vencida el 31/12)
• Enero 2025: 300 euros (vencida el 31/01)

Saldo total a regularizar: 450 euros.

¿Quiere que le envíe por email las coordenadas para el pago?"


Propietario: "Sí gracias"

Asistente: [si habilitado send_email] "Le he enviado el email con todos los detalles a la dirección mario.rossi@email.com. ¿Algo más?"

Escenario 2: propietario con múltiples unidades

Conversación:
Propietario: "¿Cuáles son mis milésimas?"

Asistente: [ya identificado como Luigi Bianchi por llamada anterior]
[invoca condomatica_search_unita(codice_fiscale="BNCGLI75B15H501Y")]
→ encuentra 2 unidades:
  • Escalera B, Planta 3, Interno 7 - 68.5 milésimas - Apartamento
  • Escalera B, Planta -1, Interno 12 - 8.2 milésimas - Plaza de garaje


Asistente: "Usted posee 2 unidades en esta comunidad de propietarios:

1. Apartamento - escalera B, planta 3, interno 7 → 68,5 milésimas
2. Plaza de garaje - escalera B, planta sótano, interno 12 → 8,2 milésimas

Total: 76,7 milésimas en total.

¿Para qué unidad quiere verificar los pagos?"


Propietario: "El apartamento"

Asistente: [invoca condomatica_search_rate(unita_id="U_apartamento")]
[procede con detalles de pagos...]

🎯 RESUMEN RÁPIDO - Condomatica Connector
  1. Obtén credenciales → API Key y Código Administrador de Condomatica
  2. Configura plugin → ingresa credenciales en AI4CALL, guarda
  3. Selecciona herramientas → habilita search_condomino, search_unita, search_rate según necesidad
  4. Prueba conexión → busca un propietario conocido para verificar
  5. Instruye asistente → flujos de trabajo de identificación, verificación de pagos, privacidad

⚡ RECUERDA: las herramientas son de SOLO LECTURA - el asistente solo puede consultar datos, no modificar o registrar pagos. Implementa siempre verificación de identidad para datos sensibles (GDPR).

❓ Preguntas Frecuentes

Respuestas a las preguntas más comunes sobre Condomatica Connector

Estas credenciales son proporcionadas directamente por tu instancia Condomatica o el administrador de sistema del software. La API Key es una clave de autenticación única para tu cuenta, mientras que el Código Administrador identifica el contexto condominal específico. Si no las has recibido, contacta al soporte de Condomatica.

No. El código condo2025_20:1 es el valor por defecto que funciona para la mayoría de las instalaciones estándar de Condomatica. Modifícalo SOLO si has recibido un código administrador personalizado específico de tu instancia Condomatica. Si no estás seguro, deja el por defecto y prueba la conexión.

Sí. En la sección "Condomatica Service" puedes deseleccionar individualmente las herramientas que no quieres que el asistente pueda acceder. Por ejemplo, puedes habilitar solo condomatica_search_condomino y condomatica_search_unita, dejando deshabilitada condomatica_search_rate si no quieres que el asistente acceda a datos financieros.

El asistente usa la herramienta condomatica_search_condomino que busca en la base de datos Condomatica usando el número de teléfono del llamante. Si el número está registrado en el sistema Condomatica, la herramienta devuelve los datos de registro del propietario. De lo contrario, el asistente puede pedir nombre y apellido para buscar manualmente.

Con condomatica_search_condomino: datos de registro (nombre, apellido, teléfono, email, código fiscal). Con condomatica_search_unita: detalles de unidades inmobiliarias (escalera, planta, interno, milésimas). Con condomatica_search_rate: estado de pagos, cuotas vencidas/pagadas, saldo corriente, importes debidos. Depende de qué herramientas hayas habilitado.

No. Las herramientas disponibles son de SOLO LECTURA. El asistente solo puede consultar datos (registro, unidades, cuotas) pero no puede modificar información, registrar pagos, crear nuevos propietarios o alterar la base de datos de Condomatica de ningún modo. Para operaciones de escritura se necesita acceso directo al sistema de gestión.

Después de guardar la configuración con API Key y Código Administrador, haz una llamada de prueba al asistente y pregunta "Busca Mario Rossi en el sistema" (usando un nombre presente en Condomatica). Si el asistente invoca condomatica_search_condomino y devuelve datos, la conexión funciona. De lo contrario verifica las credenciales.

Es un formato compuesto por: prefijo identificativo (condo2025), separador guion bajo, año/código numérico (20), dos puntos, y versión (1). Este código identifica unívocamente tu instalación Condomatica en el sistema. No lo modifiques a menos que Condomatica te haya proporcionado un código diferente específico para tu cuenta.

No, no directamente. Cada configuración de Condomatica Connector soporta UN SOLO Código Administrador, que corresponde a un contexto condominal específico. Si gestionas múltiples administradores, debes crear asistentes AI4CALL separados, cada uno con su propia configuración y credenciales Condomatica dedicadas.

Las herramientas condomatica_search_unita y condomatica_search_rate aceptan el código fiscal como parámetro de búsqueda. El asistente típicamente obtiene el código fiscal de la herramienta condomatica_search_condomino (que devuelve los datos de registro completos), luego lo usa para invocar las otras herramientas y recuperar unidades y cuotas asociadas a ese propietario específico.

Sí. Cada vez que el asistente invoca una herramienta Condomatica, se realiza una llamada API en tiempo real al servidor Condomatica. Los datos devueltos están siempre actualizados al momento de la solicitud. No hay caché local - cada búsqueda consulta directamente la base de datos Condomatica actual.

Todas las herramientas Condomatica dejarán de funcionar inmediatamente. El asistente recibirá errores de autenticación cuando intente invocar cualquier herramienta. Deberás generar una nueva API Key desde la configuración de Condomatica y actualizarla en la configuración AI4CALL, luego guardar nuevamente.

Depende de la implementación API de Condomatica. La herramienta condomatica_search_condomino acepta una consulta textual que se pasa a la API Condomatica. Si la API soporta búsquedas parciales (ej. buscar "Mar" para encontrar "Mario"), funcionará. Si requiere coincidencia exacta, deberás proporcionar nombre completo. Prueba con tu instancia.

No a nivel de configuración AI4CALL. El control de accesos depende de las credenciales y permisos configurados en Condomatica misma. Si la API Key proporcionada tiene acceso solo a determinados propietarios, el asistente verá solo esos. Para restricciones granulares, configura los permisos directamente en Condomatica.

Los datos extraídos de Condomatica (registro, unidades, cuotas) están sujetos a GDPR. Asegúrate de: informar a los propietarios que sus datos pueden ser consultados mediante asistente AI, obtener consentimiento si es requerido, implementar autenticación del llamante (ej. PIN) en el prompt, limitar las herramientas habilitadas solo a lo necesario, registrar accesos para auditoría.

Sí. Si un propietario posee múltiples unidades (ej. apartamento + plaza de garaje), condomatica_search_unita devolverá TODAS las unidades asociadas al código fiscal. El asistente puede luego listarlas al propietario y preguntarle para qué unidad quiere verificar las cuotas, antes de invocar condomatica_search_rate.

La herramienta devuelve: listado de cuotas con vencimientos e importes, estado de cada cuota (pagada/vencida/parcial), saldo corriente total, eventuales intereses de demora, historial de pagos efectuados. La estructura de datos exacta depende de la API Condomatica, pero típicamente incluye toda la información financiera relativa a la unidad inmobiliaria.

Sí, absolutamente. El asistente puede combinar diferentes herramientas. Ejemplo de flujo: usa condomatica_search_rate para verificar cuotas vencidas, luego usa send_whatsapp_message o send_email para enviar automáticamente un recordatorio de pago al propietario. Las herramientas MCP son componibles y el LLM las orquesta autónomamente.

Durante la llamada, puedes monitorear los registros del asistente en el panel AI4CALL que muestran cuándo y con qué parámetros son invocadas las herramientas condomatica_search_*. Además, el asistente típicamente comunica al propietario qué está haciendo (ej. "Estoy buscando tus unidades en el sistema", "Verifico el estado de los pagos").

Depende del endpoint API configurado. Si tu instalación Condomatica es on-premise con API REST expuestas y accesibles desde AI4CALL, el plugin puede funcionar. Si Condomatica es solo local sin API expuestas, no es compatible. Verifica con tu administrador de sistema Condomatica si las REST API están disponibles y accesibles.


Algunos de los usuarios de ai4call