Docs • Nata IA

Documentación

Aprende cómo crear workspaces, activar Nats (bots), subir documentos y llamar la API desde tus apps.

1. Primeros pasos

1. Inicia sesión en tu panel, crea un workspace y luego crea tu primer Nat (bot).

2. Sube uno o más documentos para que Nata pueda indexar tu contenido.

3. Prueba tu Nat desde el panel antes de conectarlo a tu app o sitio.

2. Claves API

Cada workspace tiene dos tipos de claves:

Clave pública — usada desde el navegador o widget web para llamar al endpoint de chat de forma segura.
Clave privada — usada desde tu backend o scripts para subir documentos y administrar bots.

3. Endpoint de chat

Usa el endpoint de chat para enviar mensajes a un Nat específico, con RAG y streaming bajo el capó.

POST /api/v1/public/chat

Headers:
  X-API-Key: <NATA_PUBLIC_KEY>
  Content-Type: application/json

Body:
{
  "workspace_id": 1,
  "bot_id": 2,
  "session_id": "demo-user",
  "message": "Resume mis documentos de onboarding"
}

4. Widget web

Inserta este snippet en tu sitio para embeber un Nat como widget de chat flotante.

<script
  src="https://cdn.nata.ai/widget.js"
  data-workspace="YOUR_WORKSPACE_PUBLIC_KEY"
  data-bot="YOUR_BOT_ID">
</script>