ExamplesTypeScriptQuickstart

Quickstart

Last updated 2026-02-13
typescript
import { RooaakClient } from "rooaak";

const client = new RooaakClient({ apiKey: process.env.ROOAAK_API_KEY! });

const agent = await client.agents.create({
  name: "Support Assistant",
  avatarUrl: "https://api.dicebear.com/9.x/bottts/svg?seed=support",
  personality: "Helpful, concise, accurate.",
});

await client.agents.start(agent.id); // optional warm start

const sent = await client.messages.send(
  { agentId: agent.id, sessionId: "chat-1", message: "Reply with exactly: pong" },
  `idem-${Date.now()}`
);

if (sent.status === "responded") {
  console.log(sent.response);
} else {
  const final = await client.messages.waitForResponse(sent.messageId, { timeoutMs: 180_000, pollIntervalMs: 2_000 });
  console.log(final.response);
}