Ga naar de hoofdinhoud
SDK voor Next.js-chatbots

Voeg een aangepaste AI-chatbot toe aan Next.js

Gebruik @openstaticfish/chattybox binnen een gerichte clientgrens, terwijl de rest van uw App Router-applicatie door de server wordt weergegeven. ChattyBox zorgt voor het ophalen, citaten, gesprekken en schalen.

Crawlt gepubliceerde documentatiepagina'sAntwoorden met bronvermeldingenBouw een aangepaste gebruikersinterface met de SDKGeen documentatiemigratie vereistGeen creditcard vereistJe content blijft van jou
Vraag ChattyBox
Waar moet ik beginnen als ik een betrouwbaar antwoord van deze site nodig heb?
Voeg eerst uw openbare website-URL toe aan ChattyBox. Het haalt geïndexeerde inhoud op om antwoorden te sturen en kan bronlinks tonen ter controle. Test antwoorden en terugvalantwoorden vóór de lancering.
iBronnen3^
Next.js gids
chattybox.ai
Analyse
chattybox.ai
Startpagina
chattybox.ai

Illustratief gesprek — geen livechat.

Aangedreven door ChattyBox

Start een chatbot met bronvermeldingen zonder uw website-stack opnieuw op te bouwen

ChattyBox crawlt uw bestaande website, documentatie, helpcentrum, CMS of kennisbank. Opgehaalde inhoud kan de antwoorden van de chatbot sturen; controleer antwoorden en bronvermeldingen op juistheid.

Houd het interactieve chatoppervlak binnen een kleine use client-grens.
Maak alleen een openbare widgetsleutel met originbeperkingen zichtbaar via NEXT_PUBLIC-variabelen.
Geef de geciteerde antwoorden weer met uw bestaande Next.js ontwerpsysteem en applicatieshell.
Laat ChattyBox het crawlen, ophalen, de vectoropslag, het genereren van antwoorden en het schalen beheren.
Workflowstap

Installeer @openstaticfish/chattybox in de Next.js-applicatie.

Workflowstap

Voeg de openbare widget API sleutel en API URL toe als NEXT_PUBLIC omgevingsvariabelen.

Workflowstap

Maak een clientcomponent voor chatstatus en browserinteractie.

Workflowstap

Importeer die clientcomponent van een servercomponentpagina of lay-out.

Lancering in drie stappen

Koppel je openbare website of documentatie, test antwoorden met bronvermeldingen en bouw vervolgens je interface met de SDK.

Bouw een Next.js chatbot
App Router-integratie

Voeg interactiviteit toe zonder de serverweergave op te geven

Bewaar de SDK aan de rand van de client waar chatinteractie plaatsvindt en bewaar servercomponenten voor de rest van de applicatie.

Beslissingspad

Gebruik deze controlepunten om te beslissen of ChattyBox naast uw documentplatform moet worden geplaatst, een afzonderlijke assistent moet vervangen of geïsoleerd moet blijven om te testen.

01

Kleine cliëntgrens

Markeer alleen de interactieve chatmodule met use client in plaats van een hele pagina of lay-out naar de browser te verplaatsen.

02

Duidelijkheid van de openbare sleutel

Gebruik een browserveilige projectsleutel met toegestane oorsprong; Stel nooit beheerreferenties bloot via NEXT_PUBLIC-variabelen.

03

Aangepast product UI

Geef berichten en bronvermeldingen weer in uw eigen navigatie, accountgedeelte, documentatieshell of ondersteuningsworkflow.

04

Geen aangepaste RAG-service

Vermijd het toevoegen van route-handlers uitsluitend om een ​​beheerde browser API te proxyen, tenzij uw product een concrete server-side vereiste heeft.

Installatiepad

Maak een Next.js App Router chatclient

De SDK gebruikt fetch en in de browser zichtbare projectreferenties, dus initialiseer deze in een clientmodule. Houd geheimen en beheer APIs uit NEXT_PUBLIC variabelen.

  1. 1Installeer het npm-pakket en configureer een op oorsprong beperkte openbare sleutel.
  2. 2Maak een use client-component die eigenaar is van de bericht- en gespreksstatus.
  3. 3Geef de component weer vanaf uw door de server weergegeven pagina zonder de hele route naar een clientcomponent te converteren.
Bouw een Next.js chatbot
app/components/chat.tsx
tsx
'use client';

import { useState, type FormEvent } from 'react';
import { Chattybox, ChattyboxError, type ChatResponse } from '@openstaticfish/chattybox';

const chattybox = new Chattybox({
  apiKey: process.env.NEXT_PUBLIC_CHATTYBOX_API_KEY!,
  baseUrl: process.env.NEXT_PUBLIC_CHATTYBOX_API_URL!,
});

export function Chat() {
  const [question, setQuestion] = useState('');
  const [answer, setAnswer] = useState<ChatResponse | null>(null);
  const [pending, setPending] = useState(false);
  const [error, setError] = useState('');

  async function ask(event: FormEvent<HTMLFormElement>) {
    event.preventDefault();
    const message = question.trim();
    if (pending || !message || message.length > 2000) return;
    setPending(true);
    setError('');
    try {
      const result = await chattybox.sendMessage({
        message,
        // Same ID includes up to 12 recent saved messages, not the full transcript.
        conversationId: answer?.conversationId,
      });
      // The backend may return a provider failure in an otherwise successful response.
      if ('providerError' in result && typeof result.providerError === 'string' && result.providerError) {
        setError('Chat could not be completed.');
        return;
      }
      setAnswer(result);
      setQuestion('');
    } catch (failure) {
      setError(failure instanceof ChattyboxError
        ? failure.status + ': ' + failure.message
        : 'Chat could not be completed.');
    } finally {
      setPending(false);
    }
  }

  const sources = answer?.sources.filter((source) => {
    try { return ['https:', 'http:'].includes(new URL(source).protocol); }
    catch { return false; }
  }) ?? [];

  return (
    <section aria-label="Chat">
      <form onSubmit={ask}>
        <label>Question
          <input value={question} maxLength={2000} disabled={pending}
            onChange={(event) => setQuestion(event.target.value)} />
        </label>
        <button type="submit" disabled={pending || !question.trim()}>
          {pending ? 'Sending...' : 'Send'}
        </button>
      </form>
      {error && <p role="alert">{error}</p>}
      <div aria-live="polite" aria-busy={pending}>
        <p style={{ whiteSpace: 'pre-wrap' }}>{answer?.message}</p>
        {sources.length > 0 && <ul aria-label="Sources">
          {sources.map((source, index) => <li key={index}>
            <a href={source} target="_blank" rel="noopener noreferrer">{source}</a>
          </li>)}
        </ul>}
      </div>
    </section>
  );
}

// Import and render <Chat /> from your page or layout. This shows the latest answer, not a saved transcript.
// No automatic retries: see the SDK retry-safety guide before adding retries.
Veelgestelde vragen

Veelgestelde vragen

1

Werkt de ChattyBox SDK met de Next.js App Router?

Ja. Gebruik het in een clientcomponent voor een interactieve chatstatus en geef die component weer vanaf een App Router pagina of lay-out.

2

Heb ik een Next.js route-handler nodig voor ChattyBox?

Niet voor de gebruikelijke browserintegratie. Openbare widgetsleutels zijn bedoeld voor gebruik aan de clientzijde en kunnen worden beperkt tot goedgekeurde origins.

3

Zijn NEXT_PUBLIC ChattyBox sleutels geheim?

De openbare widgetsleutel identificeert een project, maar is geen beheercredential. Beperk de sleutel tot uw productie- en preview-origins en geef nooit beheergeheimen prijs.

4

Kan ik de gehoste ChattyBox-widget gebruiken met Next.js?

Ja. De gehoste installatiehandleiding toont het next/script-pad als u de voorkeur geeft aan een onderhouden UI in plaats van een aangepaste SDK-interface.

Gratis starten

Geen creditcard vereist

Maak een gratis chatbot

Gratis niveau. Geen kaart nodig.