Passa al contenuto principale
SDK per chatbot Next.js

Aggiungi un chatbot AI personalizzato a Piattaforma Next.js

Utilizza @openstaticfish/chattybox all'interno di un limite client mirato mentre il resto della tua applicazione App Router rimane sottoposto a rendering del server. ChattyBox gestisce il recupero, le citazioni, le conversazioni e il ridimensionamento.

Esegue la scansione delle pagine dei documenti pubblicatiRisposte con citazioni delle fontiCrea un'interfaccia personalizzata con l'SDKNon è richiesta la migrazione dei documentiNessuna carta di credito richiestaI tuoi contenuti restano tuoi
Chiedi a ChattyBox
Da dove dovrei iniziare se mi serve una risposta affidabile da questo sito?
Inizia aggiungendo l’URL pubblico del sito a ChattyBox. Recupera contenuti indicizzati per guidare le risposte e può mostrare link alle pagine fonte da verificare. Prova risposte e fallback prima del lancio.
iFonti3^
Integrazione Next.js guida
chattybox.ai
Analisi
chattybox.ai
Pagina iniziale
chattybox.ai

Conversazione a scopo illustrativo — non è una chat dal vivo.

Offerto da ChattyBox

Lancia un chatbot con citazioni delle fonti senza ricostruire lo stack del tuo sito

ChattyBox esegue la scansione del tuo sito web esistente, della documentazione, del centro assistenza, del CMS o della knowledge base. I contenuti recuperati possono guidare le risposte del chatbot; verifica l'accuratezza delle risposte e delle citazioni.

Mantieni la superficie della chat interattiva entro un piccolo confine use client.
Esponi solo una chiave widget pubblica e limitata all'origine tramite le variabili NEXT_PUBLIC.
Visualizza le risposte citate con il sistema di progettazione Next.js esistente e la shell dell'applicazione.
Lascia che ChattyBox gestisca scansione, recupero, archiviazione vettoriale, generazione delle risposte e scalabilità.
Passaggio del workflow

Installa @openstaticfish/chattybox nell'applicazione Next.js.

Passaggio del workflow

Aggiungi la chiave API del widget pubblico e API URL come variabili di ambiente NEXT_PUBLIC.

Passaggio del workflow

Crea un componente client per lo stato della chat e l'interazione con il browser.

Passaggio del workflow

Importa il componente client da una pagina o un layout del componente server.

Lancio in tre fasi

Collega il tuo sito web pubblico o la tua documentazione, prova le risposte con citazioni e poi crea la tua interfaccia con l'SDK.

Costruisci un chatbot Next.js
App Router integrazione

Aggiungi interattività senza rinunciare al rendering del server

Mantieni SDK sul lato client dove avviene l'interazione della chat e preserva i componenti server per il resto dell'applicazione.

Percorso decisionale

Utilizza questi punti di controllo per decidere se ChattyBox deve essere affiancato alla tua piattaforma di documenti, sostituire un assistente separato o rimanere isolato per i test.

01

Confine client ridotto

Contrassegna solo il modulo di chat interattiva con use client invece di spostare un'intera pagina o layout nel browser.

02

Chiarezza della chiave pubblica

Utilizzare una chiave di progetto sicura per il browser con origini consentite; non esporre mai le credenziali di gestione tramite le variabili NEXT_PUBLIC.

03

Prodotto personalizzato UI

Visualizza messaggi e citazioni nella tua navigazione, nell'area dell'account, nella shell dei documenti o nel flusso di lavoro di supporto.

04

Nessun servizio RAG personalizzato

Evita di aggiungere route handler solo per fare da proxy a un'API gestita per il browser, a meno che il tuo prodotto non abbia un'esigenza concreta lato server.

Percorso di installazione

Crea un client di chat Next.js App Router

L'SDK usa fetch e credenziali del progetto visibili nel browser, quindi inizializzalo in un modulo client. Non inserire segreti o API di gestione nelle variabili NEXT_PUBLIC.

  1. 1Installa il pacchetto npm e configura una chiave pubblica limitata all'origine.
  2. 2Crea un componente use client che possiede lo stato del messaggio e della conversazione.
  3. 3Esegui il rendering del componente dalla pagina renderizzata dal server senza convertire l'intero percorso in un componente client.
Costruisci un chatbot Next.js
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.
Domande frequenti

Domande comuni

1

ChattyBox SDK funziona con Next.js App Router?

SÌ. Usalo in un componente client per lo stato della chat interattiva ed esegui il rendering di quel componente da una pagina o un layout App Router.

2

Ho bisogno di un gestore di percorso Next.js per ChattyBox?

Non per la normale integrazione del browser. Le chiavi widget pubbliche sono progettate per l'uso da parte dei client e possono essere limitate alle origini approvate.

3

Le chiavi NEXT_PUBLIC ChattyBox sono segrete?

La chiave pubblica del widget identifica un progetto ma non è una credenziale di gestione. Limitala alle origini di produzione e anteprima e non esporre mai segreti amministrativi.

4

Posso utilizzare il widget ChattyBox ospitato con Next.js?

Sì. La guida all'installazione del widget ospitato mostra come usare next/script se preferisci un'interfaccia gestita a una personalizzata con l'SDK.

Inizia gratis

Nessuna carta di credito richiesta

Crea un chatbot gratis

Piano Free. Nessuna carta.