Documentation
Build agentic applications
that are ready for production.
Xpectrum gives developers one API for chat, voice, workflows, knowledge, and the tools that make an AI application useful after the demo.
Start here
Quickstarts
Choose the thing you are trying to ship. Each path starts small and gives you the pieces you need to take the next step.
Build your first chat ↗
Send a message, stream the answer, and keep a stable user context.
02Run your first workflow ↗
Trigger an agentic workflow and follow each step as it runs.
03Add a voice experience ↗
Connect real-time voice to the same agent and business context.
04Add a drop-in widget ↗
Put chat or voice on your product without building the interface from scratch.
Chat
Your first response
Use the Xpectrum SDK from your server, pass a stable user identifier, and send a message to your agent.
import { XpectrumChat } from "xpectrum";
const chat = new XpectrumChat({
baseUrl: "https://cloud.xpectrum.dev/v1",
apiKey: process.env.XPECTRUM_API_KEY!,
user: "user-123",
});
const response = await chat.send("Hello from my app");
console.log(response.content);Read the complete SDK Quickstart or explore chat completions, models, and threads.
Workflow
From trigger to outcome
Workflows coordinate tools, applications, approvals, and agents in one run. Start a run synchronously, or stream progress when the work takes longer.
curl https://cloud.xpectrum.dev/v1/runs \
-H "Authorization: Bearer $XPECTRUM_API_KEY" \
-H "Content-Type: application/json" \
-d '{"workflow_id":"your-workflow-id","input":{"customer_id":"cus_123"}}'Voice
Give the same application a voice
Build real-time voice calls with live transcription, microphone controls, and call lifecycle events. Your voice experience can use the same agent, tools, and knowledge as chat.
Explore the Voice Module and see how to handle the browser connection safely.
Interface
Add the interface when you need it
Use a drop-in chat window, voice orb, or combined widget when the product experience matters more than writing UI plumbing.
Add a widget or follow the JavaScript guide.
Reference