Documentatie

Alles wat u nodig heeft om uw AI-chatbot te embedden, te hosten of te integreren.

Snel starten

1
Maak een account aan
Registreer op nuovabot.com. Uw eerste chatbot en werkruimte worden automatisch ingericht. Geen creditcard vereist voor het gratis plan.
2
Upload uw documenten
Ga naar Kennisbank → Uploaden. Ondersteunde formaten: PDF, DOCX, TXT. Documenten worden automatisch gesegmenteerd, geëmbed en geïndexeerd. Verwerking duurt doorgaans minder dan 30 seconden.
3
Implementeer uw chatbot
Open het tabblad Embed & Implementeren op uw chatbot. Kies een implementatiemethode: kopieer het widget-fragment, deel de gehoste link of gebruik de API.

Widget Embedden

Voeg een chatballon toe aan elke website met een enkel scripttag. Kopieer uw fragment van het tabblad Embed & Implementeren — het bevat al de API-sleutel van uw chatbot.

<script
  src="https://nuovabot.com/widget.js"
  data-chatbot-id="your-chatbot-id"
  data-api-key="your-api-key"
  async
></script>

De widget wordt weergegeven in een Shadow DOM — het zal niet conflicteren met uw bestaande stijlen. Laadt lui na interactiviteit van de pagina.

Gehoste Chatpagina

Elke chatbot krijgt een openbare, gebrandmerkte chatpagina die u direct kunt delen — geen embedding vereist.

https://nuovabot.com/chat/your-chatbot-slug

De slug wordt weergegeven in uw tabblad Embed & Implementeren. U kunt deze URL delen in e-mails, ondersteuningspagina's of overal waar een directe link beter werkt dan een embedded widget.

REST API

Beschrijving

POST /api/v1/chat

Stuur een bericht naar uw chatbot en ontvang een streaming SSE-antwoord.

curl -X POST https://nuovabot.com/api/v1/chat \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "What is your return policy?",
    "conversationId": "optional-existing-conversation-id"
  }'

Verzoekinhoud

Veld	Type	Beschrijving
message	string (required)	Het bericht van de gebruiker
conversationId	string (optional)	Ga door met een bestaand gesprek. Laat leeg om een nieuw gesprek te starten.

SSE Antwoordformaat

Antwoorden worden gestreamd als Server-Sent Events. Elk event heeft een event: type en een JSON data: payload.

Evenementtype	Payload	Beschrijving
token	{ "token": "Hello" }	Een deel van de assistent-antwoordtekst
done	{ "conversationId": "...", "messageId": "...", "model": "claude-haiku-..." }	Stream voltooid. Bevat gespreksmetadata.
error	{ "message": "Rate limit exceeded" }	Er is een fout opgetreden. Stream eindigt na dit evenement.
tool_start	{ "toolCallId": "...", "toolName": "create_ticket" }	Chatbot voert een actie uit (bijv. een ticket aanmaken)
tool_result	{ "toolCallId": "...", "toolName": "create_ticket", "success": true, "result": "TK-0042" }	Actie voltooid. Bevat resultaatgegevens.

Snelheidslimieten

Snelheidslimieten worden per organisatie gehandhaafd met een schuifvenster. Het overschrijden van een limiet geeft HTTP 429 terug.

Plan	Berichten/min	Berichten/dag	Berichten/maand
Free	5	100	25
Starter	15	300	1,000
Pro	30	1,000	4,000
Business	60	2,500	10,000

Authenticatie

Twee authenticatiemethoden worden ondersteund afhankelijk van waar u vandaan belt.

API-sleutel (widget & server-side)

Geef uw chatbot-API-sleutel door via de X-API-Key header.

X-API-Key: your-chatbot-api-key

API-sleutels worden eenmalig getoond bij het aanmaken van de chatbot. Sla ze veilig op — ze kunnen niet opnieuw worden opgehaald (alleen geroteerd).

Bearer JWT (dashboard & intern)

Dashboard API-aanroepen gebruiken Supabase-sessietokens via de Authorization header. Dit wordt automatisch afgehandeld door het dashboard.

Authorization: Bearer <supabase-session-jwt>

Klaar om te bouwen?

Maak uw eerste chatbot gratis aan — geen creditcard vereist.

Gratis starten