S

Ronitek-Central: API Developer Docs

Guía técnica y referencia de endpoints para desarrolladores (Integraciones Elitia, Khala, Minecraftek, Socialia y Agendaw).

← Volver al Dashboard

Regla Crítica: Chatbots con IA Local (Elitia / Socialia)

Los modelos locales de lenguaje no deben acceder directamente a la base de datos sin autorización previa. Para proteger los datos de los clientes, todo acceso confidencial requiere el flujo OTP (One-Time Password) de doble factor vía correo electrónico con N8N.

1. SolicitudEl usuario le pide al chatbot información privada o restablecer contraseña.
2. Código OTPChatbot llama a POST /api/auth/otp. N8N envía un código al email registrado.
3. ValidaciónUsuario le dicta el código de 6 dígitos a la IA. Chatbot llama a PUT /api/auth/otp.
4. Token TemporalRonitek valida el código y entrega un token de lectura de sesión por 1 hora.

Catálogo de Endpoints REST

POST/api/auth/otp
Generar código OTP para Chatbot

Dispara el flujo hacia N8N para enviar un correo con el código de 6 dígitos al usuario.

// Request Body:
{
  "email": "cliente@sinverhi.com",
  "purpose": "CHATBOT_AUTH"
}
PUT/api/auth/otp
Validar código entregado por el usuario
// Request Body:
{
  "email": "cliente@sinverhi.com",
  "code": "849201"
}

// Response:
{
  "success": true,
  "verified": true,
  "sessionToken": "eyJhbGciOi...",
  "clientData": {
    "name": "Sinverhi.com",
    "services": [
      { "name": "Hosting H1 Correos", "status": "ACTIVO", "renewalDate": "2027-04-13" }
    ]
  }
}
POST/api/quotes
Crear Cotización (Chatbot o Manual)
// Request Body:
{
  "clientName": "Oscar Industrial",
  "clientEmail": "contacto@oscar.com",
  "origin": "CHATBOT_ELITIA",
  "total": 3500.00,
  "items": [
    { "name": "Servidor Nextcloud 750GB", "qty": 1, "price": 3500 }
  ],
  "notes": "Cotización acordada mediante asesoría con Elitia"
}
POST/api/quotes/:id/approve
Aprobar cotización y enviar link de pago
// Request Body:
{
  "sentVia": "EMAIL", // o "WHATSAPP", "AMBOS"
  "paymentLink": "https://pay.wiperelite.com/checkout/cot-2026-0001",
  "adminNotes": "Aprobado con descuento de fidelidad"
}
POST/api/tickets/:id/approve-ai
Aprobar borrador de respuesta IA
// Request Body:
{
  "responseText": "Se han verificado los registros MX y todo opera con normalidad.",
  "newStatus": "RESUELTO"
}

Tokens de Conexión de Aplicaciones Satélite

Usa estos tokens como header Authorization: Bearer <TOKEN> al conectar tus proyectos en Antigravity:

Elitia (IA Chatbot)elitia_live_sec_key_9938210_wiperelite
Khala (Acceso Remoto)khala_live_sec_key_4481902_wiperelite