NorthTec AI API

{
  "conversationId": "conv_abc123",
  "level": 2
}

{
  "conversationId": "conv_xyz789",  // IMPORTANTE: pasar si existe en localStorage
  "visitorId": "visitor_123",      // opcional
  "metadata": {                       // opcional
    "page": "/productos",
    "referrer": "google.com"
  }
}

{
  "sessionToken": "sess_abc123xyz789",
  "expiresIn": 3600,
  "conversationId": "conv_xyz789abc",
  "config": {
    "environment": "production",
    "type": "chat_embed",
    "scope": ["chat", "read"]
  },
  "assistant": {
    "name": "Sofia",
    "greeting": "¡Hola! ¿En qué puedo ayudarte?"
  }
}

// 429 - Demasiados requests por minuto/día
{
  "error": "rate_limit_exceeded",
  "retryAfter": 300  // segundos para reintentar
}

// 429 - Demasiadas conversaciones nuevas
{
  "error": "too_many_conversations",
  "message": "Demasiadas conversaciones nuevas. Intenta de nuevo en 5 minutos.",
  "retryAfter": 300
}

// 403 - Embed key pausada por abuso
{
  "error": "embed_key_paused",
  "message": "Esta clave ha sido pausada por actividad sospechosa."
}

{
  "message": "Quiero información sobre sus productos",
  "conversationId": "conv_xyz789abc"
}

{
  "ok": true,
  "conversationId": "conv_xyz789",
  "manualMode": false,
  "status": "active",  // "active" | "closed" | "resolved"
  "messages": [
    {
      "role": "user",
      "text": "Hola",
      "createdAt": "2026-01-26T10:30:00.000Z"
    },
    {
      "role": "assistant",
      "text": "¡Hola! ¿En qué puedo ayudarte?",
      "createdAt": "2026-01-26T10:30:02.000Z"
    }
  ]
}

{
  "conversationId": "conv_xyz789",
  "reason": "resolved",           // opcional
  "rating": 5,                       // opcional (1-5)
  "feedback": "Excelente atención"  // opcional
}

{
  "ok": true,
  "conversationId": "conv_xyz789",
  "durationMs": 125000,
  "messagesCount": 8
}

curl -X POST https://prod.northtec.io/indexGeneral \
  -H "Authorization: Bearer {firebaseToken}" \
  -H "ntx-api-key: {apiKey}" \
  -F "file=@documento.pdf" \
  -F "type=manual-usuario"

{
  "productId": "prod_123",
  "type": "manual-usuario"
}

{
  "name": "Production Key",
  "allowedDomains": ["example.com", "*.example.com"],
  "persona": {
    "role": "advisor",      // assistant | advisor | support | sales
    "tone": "friendly",     // professional | friendly | casual
    "assistantName": "Sofia"
  }
}

{
  "ok": true,
  "apiKey": "ntx_live_abc123...",  // ¡Solo se muestra una vez!
  "keyId": "key_xyz789"
}

{
  "ok": true,
  "keys": [
    {
      "id": "key_abc123",
      "name": "Production Key",
      "prefix": "ntx_live_abc1...",
      "status": "active",
      "createdAt": "2026-01-15T10:00:00.000Z"
    }
  ]
}

{ "keyId": "key_abc123" }

{
  "name": "Chat Widget - Sitio Principal",
  "allowedDomains": ["example.com", "*.example.com"],
  "rateLimit": {
    "requestsPerMinute": 20,   // default: 20
    "requestsPerDay": 1000      // default: 1000
  },
  "persona": {
    "role": "assistant",
    "tone": "professional",
    "assistantName": "Sofia",
    "greeting": "¡Hola! ¿En qué puedo ayudarte?"
  }
}

{
  "embedKey": "ntx_emb_abc123...",  // ¡Solo se muestra una vez!
  "keyId": "emb_xyz789",
  "last7": "...c123"
}

{
  "keys": [
    {
      "keyId": "emb_abc123",
      "name": "Chat Widget",
      "status": "active",           // "active" | "paused" | "revoked"
      "last7": "...abc123",
      "allowedDomains": ["example.com"],
      "rateLimit": {
        "requestsPerMinute": 20,
        "requestsPerDay": 1000
      },
      "usageCount": 1250,           // total de inits
      "conversationCount": 340,    // conversaciones únicas
      "lastUsedAt": "2026-01-26T10:30:00Z",
      "pauseReason": null,         // si está pausada, muestra razón
      "createdAt": "2026-01-15T..."
    }
  ]
}

{
  "name": "WhatsApp Principal",
  "phoneNumberId": "123456789012345",
  "businessAccountId": "987654321098765",
  "accessToken": "EAAxxxxxxxxxxxxxxx",
  "appSecret": "abc123def456ghi789",
  "rateLimit": {
    "messagesPerMinute": 30,     // default: 30
    "messagesPerDay": 5000,        // default: 5000
    "messagesPerUserPerMinute": 5, // default: 5
    "messagesPerUserPerHour": 50   // default: 50
  },
  "persona": {
    "role": "assistant",
    "tone": "friendly",
    "assistantName": "Sofia"
  }
}

{
  "whatsappKey": "ntx_wa_abc123...",  // ¡Solo se muestra una vez!
  "keyId": "wa_xyz789",
  "last7": "...c123",
  "webhookVerifyToken": "abc123def456",  // Para configurar en Meta
  "webhookUrl": "https://prod.northtec.io/webhook/whatsapp"
}

{
  "keys": [
    {
      "keyId": "wa_abc123",
      "name": "WhatsApp Principal",
      "status": "active",
      "phoneNumberId": "123456789",
      "webhookVerifyToken": "abc123...",
      "webhookUrl": "https://prod.northtec.io/webhook/whatsapp",
      "rateLimit": { ... },
      "messageCount": 1250,
      "conversationCount": 89,
      "lastUsedAt": "2026-01-26T10:30:00Z",
      "pauseReason": null
    }
  ]
}

{
  "keyId": "wa_abc123",
  "testNumber": "50688887777"  // Sin el +
}

{ "cedula": "113030227" }

{
  "ok": true,
  "cedula": "113030227",
  "nombre": "JUAN CARLOS",
  "apellido1": "PEREZ",
  "apellido2": "GONZALEZ"
}