Docs • Nata IA

Documentation

Learn how to create workspaces, spin up Nats (bots), upload documents, and call the API from your apps.

1. Getting started

1. Sign in to your dashboard, create a workspace, and then create your first Nat (bot).

2. Upload one or more documents so Nata can index your content.

3. Test your Nat from the dashboard before connecting it to your app or site.

2. API keys

Each workspace has two types of keys:

Public key — used from the browser or web widget to call the chat endpoint safely.
Private key — used from your backend or scripts to upload documents and manage bots.

3. Chat endpoint

Use the chat endpoint to send messages to a specific Nat, with RAG and streaming under the hood.

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": "Summarize my onboarding docs"
}

4. Web widget

Drop this snippet into your site to embed a Nat as a floating chat widget.

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