WITHMIA v1.1.0 — Enterprise Features: API Pública, Fine-Tuning, SLA, CSM y Canales Custom

La v1.0.9 diferenció Business de Pro en el frontend. La v1.1.0 resuelve el gap final: las 5 funcionalidades Enterprise que faltaban por implementar. Desde API keys hasta fine-tuning de modelos, todo está ahora disponible para clientes Enterprise.

El problema: Enterprise vendido pero no construido

Hasta v1.0.9, el plan Enterprise ($149.990/mes) incluía en la landing:

• ❌ Fine-tuning de modelos
• ❌ Canales personalizados
• ❌ CSM dedicado
• ❌ Gestión de API keys
• ❌ Monitoreo SLA + Status Page

Ninguna de estas funcionalidades existía. El plan más caro no tenía diferenciación real respecto a Business.

Solución: 5 features Enterprise completas

1. API REST Pública (/api/v1/external/)

El sistema más importante. Permite que cualquier sistema externo (CRM, ERP, chatbots de terceros, apps custom) se conecte con WITHMIA mediante API keys.

Autenticación: Bearer token con prefijo wm_.

# Enviar mensaje a una conversación
curl -X POST https://app.withmia.com/api/v1/external/messages \
  -H "Authorization: Bearer wm_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id": 123, "content": "Hola desde mi CRM"}'

Endpoints disponibles:

Método	Endpoint	Scope requerido
POST	/messages	messages:send
GET	/conversations	conversations:read
GET	/conversations/{id}	conversations:read
GET	/conversations/{id}/messages	messages:read
GET	/contacts	contacts:read
POST	/contacts	contacts:write
GET	/products	products:read
GET	/usage	*
POST	/webhook/inbound	messages:send

Webhook inbound — el endpoint más poderoso. Permite crear un canal custom completo: envías un POST con from, name y message, y WITHMIA crea la conversación, procesa con IA, y responde automáticamente.

2. Fine-Tuning de Modelos OpenAI

Los clientes Enterprise pueden entrenar modelos personalizados con sus propios datos de conversación:

1. Sube un archivo .jsonl con ejemplos de conversación
2. Selecciona el modelo base (GPT-4o Mini o GPT-4o)
3. WITHMIA envía el job a OpenAI y monitorea el progreso
4. Cuando termina, el modelo personalizado está disponible

Backend:

• FineTuningService — sube archivos a OpenAI Files API, crea fine-tuning jobs, sincroniza status
• FineTuningJob model — tracking completo: provider, status, trained_tokens, result_model

3. Canales Personalizados

Enterprise puede crear inboxes tipo API en Chatwoot para integrar cualquier plataforma:

• Telegram Bot custom → Canal en WITHMIA
• Slack workspace → Canal en WITHMIA
• App móvil propia → Canal en WITHMIA
• Formulario web → Canal en WITHMIA

Se crea el canal, y los mensajes llegan vía webhook inbound. WITHMIA procesa y responde.

4. SLA Monitoring + Status Page

Monitoreo en tiempo real de 7 servicios:

Servicio	Método	Indicador
Database	SELECT 1	Latencia SQL
Redis	PING	Latencia cache
Chatwoot	HTTP health	Disponibilidad
Evolution API	HTTP health	Disponibilidad
n8n	HTTP /healthz	Disponibilidad
Qdrant	HTTP /healthz	Disponibilidad
Reverb	TCP socket	WebSocket activo

Status page pública disponible en /api/status — comparible con clientes para transparencia operacional.

Cálculo de uptime: basado en incidentes registrados en service_incidents. Los Enterprise ven el % de uptime real de 30 días, configuración SLA (tiempo de primera respuesta, resolución, uptime target), e incidentes recientes.

5. CSM Dedicado

Asignación de Customer Success Manager por empresa. Los SuperAdmin asignan un CSM desde el panel. El Enterprise ve:

• Nombre y email de su CSM
• Notas de la relación
• Fecha de próxima revisión
• Beneficios incluidos (onboarding personalizado, revisiones mensuales, soporte 24/7)

Arquitectura técnica

Backend (Laravel)

database/migrations/
  2026_03_06_000001_create_enterprise_features_tables.php  → 5 tablas

app/Models/
  ApiKey.php          → SHA-256 hash, scopes JSON, isValid(), hasScope()
  FineTuningJob.php   → provider, status, result_model, trained_tokens
  SlaConfig.php       → first_response_minutes, resolution_hours, uptime_target
  CsmAssignment.php   → company_id, csm_user_id, notes, next_review_at
  ServiceIncident.php → service, status, started_at, resolved_at, resolve()

app/Services/
  ApiKeyService.php        → create(), resolve(), revoke(), rotate()
  FineTuningService.php    → createJob(), syncJobStatus(), cancelJob()
  SlaMonitoringService.php → getSystemStatus(), calculateUptime(), 7 checks

app/Http/Middleware/
  AuthenticateApiKey.php → Bearer token auth, scope checking

app/Http/Controllers/Api/
  EnterpriseController.php  → UI management (API keys, fine-tuning, SLA, CSM, channels)
  ExternalApiController.php → Public REST API (messages, conversations, contacts, products)

Frontend (React + TypeScript)

resources/js/components/dashboard/
  EnterpriseSection.tsx → 5 tabs: API Keys, Fine-Tuning, Channels, SLA, CSM

Accesible desde el sidebar del dashboard para usuarios Business+ (API keys) y Enterprise (todas las features).

Seguridad

• API keys nunca se almacenan en texto plano — solo el hash SHA-256
• Prefijo wm_ para identificación rápida
• Scopes granulares — 12 permisos individuales o wildcard *
• Rate limiting — 120 req/min por API key
• Expiración — las keys pueden tener fecha de expiración
• Rotación segura — revoca la anterior y genera nueva con misma config

Resumen v1.1.0

Feature	Plan	Estado
API Keys Management	Business+	✅
External REST API	Business+	✅
Webhook Inbound	Business+	✅
Fine-Tuning OpenAI	Enterprise	✅
Custom Channels	Enterprise	✅
SLA Monitoring	Enterprise	✅
Public Status Page	Enterprise	✅
CSM Assignment	Enterprise	✅

5 tablas nuevas, 5 modelos, 3 servicios, 1 middleware, 2 controllers, 1 componente frontend.

v1.1.0 convierte el plan Enterprise en un producto real con diferenciación tangible.