Límite de cliente pequeño
Marca solo el módulo de chat interactivo con use client, en lugar de trasladar una página o un layout completos al navegador.
Utilice @openstaticfish/chattybox dentro de un límite de cliente enfocado mientras el resto de su aplicación App Router permanece procesada en el servidor. ChattyBox maneja la recuperación, las citas, las conversaciones y el escalado.
ChattyBox rastrea su documentación existente, indexa el contenido para su recuperación e incorpora un chatbot que responde utilizando sus documentos en lugar de la memoria del modelo genérico.
Instale @openstaticfish/chattybox en la aplicación Next.js.
Agregue la clave API del widget público y la URL de la API como variables de entorno NEXT_PUBLIC.
Cree un componente de cliente para el estado del chat y la interacción del navegador.
Importe ese componente de cliente desde una página o diseño de componente de servidor.
Lanzamiento en tres pasos
Mantenga el SDK en el borde del cliente donde ocurre la interacción de chat y conserve los componentes del servidor para el resto de la aplicación.
Marca solo el módulo de chat interactivo con use client, en lugar de trasladar una página o un layout completos al navegador.
Utilice una clave de proyecto segura para el navegador con orígenes permitidos; nunca exponga las credenciales de administración a través de variables NEXT_PUBLIC.
Representa mensajes y citas en tu propia navegación, área de cuenta, shell de documentos o flujo de trabajo de soporte.
Evite agregar controladores de ruta únicamente para representar una API de navegador administrada a menos que su producto tenga un requisito concreto del lado del servidor.
El SDK utiliza credenciales de proyecto visibles y de recuperación del navegador, así que inicialícelo en un módulo de cliente. Mantenga los secretos y las API de administración fuera de las variables NEXT_PUBLIC.
'use client';
import { useState } from 'react';
import { Chattybox } 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 [answer, setAnswer] = useState('');
async function ask(message: string) {
const response = await chattybox.sendMessage({ message });
setAnswer(response.message);
}
return <div aria-live="polite">{answer}</div>;
}Revise el paquete subyacente y los límites de la infraestructura administrada.
Vea los patrones de estado y componentes compartidos por las aplicaciones React.
Revise los campos de respuesta, las conversaciones de seguimiento y los errores.
Utilice next/script y la interfaz de usuario del widget mantenida para una experiencia de chat sin compilación.
Sí. Úselo en un componente del cliente para el estado del chat interactivo y represente ese componente desde una página o diseño de App Router.
No para la integración normal del navegador. Las claves de widget públicas están diseñadas para uso del cliente y pueden restringirse a orígenes aprobados.
La clave del widget público identifica un proyecto pero no es una credencial de administración. Restrinjalo a sus orígenes de producción y vista previa, y nunca exponga secretos administrativos.
Sí. La guía de instalación del widget alojado muestra cómo usar next/script si prefieres una interfaz mantenida en lugar de crear una propia con el SDK.
No se requiere tarjeta de crédito. Tu contenido no se usa para entrenar modelos.
Plan Free. Sin tarjeta.