Configuracion de Integraciones
Proposito de la Seccion
La seccion de Integraciones del Backoffice permite a los Administradores conectar GDI con servicios externos que potencian y amplian las capacidades del sistema. Funciona como un hub centralizado donde se activan, configuran y monitorean todas las conexiones con sistemas terceros.
Las integraciones se comunican a traves de los microservicios de GDI: GDI-AgenteLANG (:8004) para funcionalidades de IA, GDI-MCP (integrado en el API Gateway) para comunicacion con herramientas externas, eMailService (:8003) para notificaciones, y GDI-Notary (:8001) para firma digital.
Objetivos principales:
- Potenciar funcionalidades: Ampliar capacidades de GDI con servicios especializados
- Centralizar conexiones: Gestionar todas las integraciones desde un solo lugar
- Facilitar configuración: Proveer interfaces simples para configurar servicios complejos
- Monitorear salud: Supervisar el estado y rendimiento de las conexiones
- Garantizar seguridad: Gestionar credenciales y permisos de forma segura
Características principales:
- Catálogo preconfigurado de integraciones más comunes
- Configuración guiada paso a paso para cada servicio
- Test de conectividad automático
- Monitoreo en tiempo real del estado de servicios
- Gestión de credenciales segura y centralizada
Catálogo de Integraciones Disponibles
Inteligencia Artificial y Automatización
| Servicio |
Descripción |
Funcionalidad en GDI |
| OpenAI GPT |
Modelos de lenguaje avanzados |
Potencia el Asistente AI de expedientes |
| Anthropic Claude |
IA conversacional y análisis |
Análisis inteligente de documentos |
| Azure AI Services |
Suite completa de IA de Microsoft |
OCR, traducción, análisis de sentimientos |
| Google AI Platform |
Servicios de ML y procesamiento |
Clasificación automática de documentos |
Servicios de Identidad y Validación
| Servicio |
Descripción |
Funcionalidad en GDI |
| RENAPER |
Registro Nacional de Personas |
Validación automática de DNI |
| AFIP |
Administración Federal de Ingresos |
Verificación de CUIT/CUIL |
| Mi Argentina |
Plataforma digital del ciudadano |
Autenticación ciudadana |
| ANSES |
Administración Nacional de Seguridad Social |
Validación de datos previsionales |
Comunicaciones y Notificaciones
| Servicio |
Descripción |
Funcionalidad en GDI |
| SendGrid |
Servicio de email transaccional |
Envío de notificaciones por email |
| Twilio |
Plataforma de comunicaciones |
SMS y notificaciones telefónicas |
| WhatsApp Business API |
Mensajería empresarial |
Notificaciones por WhatsApp |
| Mailgun |
Servicio de email delivery |
Email masivo y transaccional |
Almacenamiento y Documentos
| Servicio |
Descripción |
Funcionalidad en GDI |
| Google Drive |
Almacenamiento en la nube |
Backup automático de documentos |
| AWS S3 |
Object storage escalable |
Almacenamiento de archivos grandes |
| Microsoft OneDrive |
Almacenamiento empresarial |
Sincronización con Office 365 |
| Dropbox Business |
Colaboración y almacenamiento |
Compartir documentos externos |
Firma Digital y Certificación
| Servicio |
Descripción |
Funcionalidad en GDI |
| Firma.ar |
Firma digital argentina |
Firma legal de documentos |
| DocuSign |
Plataforma de firma electrónica |
Firma remota de documentos |
| Adobe Sign |
Solución de firma digital |
Workflows de aprobación |
| ONTI |
Organismo Nacional de Tecnologías |
Certificados digitales oficiales |
Servicios Financieros y Pagos
| Servicio |
Descripción |
Funcionalidad en GDI |
| MercadoPago |
Plataforma de pagos |
Cobro de tasas municipales |
| Decidir |
Gateway de pagos |
Procesamiento de tarjetas |
| Banco Nación |
Servicios bancarios oficiales |
Débito automático |
| Link Pagos |
Solución de cobros |
Múltiples medios de pago |
Análisis y Reportes
| Servicio |
Descripción |
Funcionalidad en GDI |
| Google Analytics |
Análisis web |
Métricas de uso del sistema |
| Power BI |
Business Intelligence |
Dashboards ejecutivos |
| Tableau |
Visualización de datos |
Reportes avanzados |
| Grafana |
Monitoreo y alertas |
Métricas técnicas del sistema |
Servicios Geográficos
| Servicio |
Descripción |
Funcionalidad en GDI |
| Google Maps API |
Mapas y geocodificación |
Ubicación de expedientes |
| Catastro Provincial |
Información catastral |
Validación de propiedades |
| IGN (Instituto Geográfico) |
Cartografía oficial |
Mapas oficiales argentinos |
Gestión de Integraciones
Estados de Integración
| Estado |
Descripción |
Indicador Visual |
| DISPONIBLE |
Integración no configurada |
⚪ Gris |
| CONFIGURANDO |
En proceso de configuración |
🟡 Amarillo |
| ACTIVA |
Funcionando correctamente |
🟢 Verde |
| ERROR |
Problemas de conectividad |
🔴 Rojo |
| PAUSADA |
Temporalmente deshabilitada |
⏸️ Naranja |
| MANTENIMIENTO |
Servicio en mantenimiento |
🔧 Azul |
Flujo de Configuración
Paso 1: Selección de Integración
Catálogo → [Seleccionar Servicio] → [Activar Integración]
Paso 2: Configuración Guiada
Configuración → [Credenciales] → [Parámetros] → [Permisos]
Paso 3: Validación
Test de Conectividad → [Verificar] → [Confirmar] → [Activar]
Operaciones Disponibles
| Acción |
Descripción |
Disponible Para |
| Activar |
Habilitar integración |
Estados: DISPONIBLE |
| Configurar |
Modificar parámetros |
Estados: TODOS |
| Pausar |
Deshabilitar temporalmente |
Estados: ACTIVA |
| Reanudar |
Reactivar servicio pausado |
Estados: PAUSADA |
| Test |
Verificar conectividad |
Estados: ACTIVA, ERROR |
| Logs |
Ver historial de uso |
Estados: TODOS (con datos) |
| Desactivar |
Eliminar integración |
Estados: TODOS |
Estados y Monitoreo
Dashboard
Vista General
Imagen de estados integraciones
Servicios Críticos
- Alertas inmediatas para servicios esenciales (RENAPER, Firma Digital)
- Notificaciones por email a Super-Admins cuando hay errores
- Reintentos automáticos para conexiones fallidas
Métricas por Servicio
| Métrica |
Descripción |
Frecuencia |
| Uptime |
Tiempo de disponibilidad |
Tiempo real |
| Latencia |
Tiempo de respuesta promedio |
Cada llamada |
| Requests/día |
Número de llamadas diarias |
Diario |
| Error Rate |
Porcentaje de errores |
Horario |
| Último uso |
Última vez que se usó |
Por evento |
Configuración por Categoría
Integraciones de IA
Configuración Típica:
- API Key: Credencial del servicio
- Modelo: Versión específica (GPT-4, Claude-3, etc.)
- Límites: Requests por minuto/día
- Contexto: Instrucciones específicas para GDI
- Fallback: Servicio alternativo si falla
Ejemplo - OpenAI:
Configuración OpenAI:
├── API Key: sk-...
├── Organización: org-...
├── Modelo por defecto: gpt-4-turbo
├── Límite diario: 10,000 tokens
├── Contexto del sistema: "Eres un asistente..."
└── Servicio de respaldo: Claude
Integraciones Gubernamentales
Configuración Típica:
- Certificados: X.509 para autenticación
- Endpoints: URLs de servicios oficiales
- Timeout: Tiempo máximo de espera
- Reintentos: Número de intentos fallidos
- Ambiente: Producción vs. Testing
Ejemplo - RENAPER:
Configuración RENAPER:
├── Certificado: certificado.p12
├── Contraseña: ********
├── URL Base: https://api.renaper.gob.ar
├── Timeout: 30 segundos
├── Reintentos: 3 intentos
└── Ambiente: Producción
Integraciones de Comunicación
Configuración Típica:
- API Key/Token: Credencial de acceso
- Remitente: Email o número por defecto
- Templates: Plantillas de mensajes
- Rate Limits: Límites de envío
- Webhook: URL para recibir estado de entrega
Ejemplo - SendGrid:
Configuración SendGrid:
├── API Key: SG.xxxxx
├── Email remitente: noreply@municipio.gov.ar
├── Nombre remitente: Municipio de Terranova
├── Rate limit: 100 emails/hora
├── Webhook: https://gdi.municipio.gov.ar/webhook/sendgrid
└── Templates: 5 configuradas
Interfaz de Usuario
Vista Principal - Catálogo
Imagen pantalla catálogo integraciones
Flujo de Configuración
│ Paso 1: Seleccionar integración del catálogo
│ Paso 2: Ingresar credenciales y parámetros
│ Paso 3: Test de conectividad
│ Paso 4: Confirmar y activar
Panel de Monitoreo
Imagen panel monitoreo
Consideraciones de Seguridad
Gestión de Credenciales
- Cifrado en reposo: Todas las API Keys y certificados cifrados
- Acceso restringido: Solo Super-Admins pueden ver/modificar credenciales
- Rotación automática: Alertas para renovar credenciales próximas a vencer
- Logs de acceso: Auditoría completa de quién accede a qué credenciales
Validación de Servicios
- Verificación de SSL: Certificados válidos para todas las conexiones
- Timeout configurables: Evitar conexiones colgadas
- Rate limiting: Respetar límites de servicios externos
- Reintentos inteligentes: Backoff exponencial para errores temporales
Monitoreo de Seguridad
- Detección de anomalías: Patrones inusuales de uso
- Alertas de seguridad: Notificaciones por accesos sospechosos
- Logs centralizados: Trazabilidad completa de todas las integraciones
- Failover automático: Cambio a servicios alternativos en caso de problemas
Casos de Uso Comunes
Expediente con IA
- Usuario consulta Asistente AI en expediente
- GDI llama a OpenAI/Claude vía integración configurada
- Respuesta se procesa y muestra al usuario
- Actividad se registra en logs de monitoreo
Validación de Ciudadano
- Ciudadano inicia trámite externo
- GDI valida DNI contra RENAPER
- Datos se autocompletan en formulario
- Expediente se crea con información verificada
Notificación de Estado
- Expediente cambia de estado
- GDI envía email vía SendGrid
- SMS vía Twilio si es urgente
- Estado de entrega se trackea
Documentos Relacionados
- Backoffice - Configuración de API Keys
- Backoffice - Accesos y Control
- Manual de Integraciones Técnico
- Políticas de Seguridad para Integraciones