Docs • Nata IA

Documentação

Aprenda como criar workspaces, ativar Nats (bots), enviar documentos e chamar a API a partir das suas apps.

1. Primeiros passos

1. Faça login no seu painel, crie um workspace e depois crie seu primeiro Nat (bot).

2. Envie um ou mais documentos para que a Nata possa indexar seu conteúdo.

3. Teste seu Nat no painel antes de conectá-lo ao seu app ou site.

2. Chaves de API

Cada workspace tem dois tipos de chaves:

Chave pública — usada no navegador ou widget web para chamar o endpoint de chat com segurança.
Chave privada — usada no seu backend ou scripts para enviar documentos e gerenciar bots.

3. Endpoint de chat

Use o endpoint de chat para enviar mensagens a um Nat específico, com RAG e streaming por trás.

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": "Resuma meus documentos de onboarding"
}

4. Widget web

Insira este snippet no seu site para embutir um Nat como widget de chat flutuante.

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