Official SDKs

npm install @revdesk/sdk
# or: bun add @revdesk/sdk

import { RevDesk } from "@revdesk/sdk";

const revdesk = new RevDesk({ apiKey: process.env.REVDESK_API_KEY! });

// List phone numbers
const { data: numbers } = await revdesk.phoneNumbers.list({ limit: 25 });

// Place an outbound call
await revdesk.calls.dial({ from_number: "+15551230000", to_number: "+15554560000" });

// Send an SMS
await revdesk.sms.send({ from_number: "+15551230000", to_number: "+15554560000", body: "Hi!" });

// List the agents in your workspace (and which number each answers)
const { data: agents } = await revdesk.agents.list();

// Configure one — greeting, instructions, voice, language, on/off
await revdesk.agents.update(agents[0].id, {
  greeting: "Thanks for calling Acme — how can I help?",
  system_prompt: "You are Acme's receptionist. Book appointments and answer questions.",
  voice_id: "aoede",
  language: "en",
});

// Reassign which agent answers an inbound number
await revdesk.phoneNumbers.update(phoneId, { agent_id: agents[0].id });

// Point an outbound call at a specific agent
await revdesk.calls.create({ phoneNumber: "+15554560000", assistantId: agents[0].id });

// Talk to an agent straight from the browser — no phone number needed
const { data: call } = await revdesk.agents.webCall(agents[0].id);
// → { token, room_url, … } — hand to @revdesk/webrtc's RevDeskRoom to join

// On your server (holds the API key):
const { data } = await revdesk.clientTokens.create({
  from_numbers: ["+15551234567"], // caller IDs you own
  to_numbers: ["+15557654321"],   // optional destination allowlist
  ttl_seconds: 900,
});
// Hand data.token (an rdc_… string) to your client.

// In the client — construct the SDK with the minted token instead of the API key:
const client = new RevDesk({ apiKey: data.token });
await client.webrtc.getToken({ from_number: "+15551234567", to_number: "+15557654321" });

for await (const number of revdesk.phoneNumbers.listAll()) {
  console.log(number.phone_number);
}

import { generateIdempotencyKey } from "@revdesk/sdk";

await revdesk.sms.send(
  { from_number: "+15551230000", to_number: "+15554560000", body: "Hi!" },
  { idempotencyKey: generateIdempotencyKey() },
);

import { RevDeskError } from "@revdesk/sdk";

try {
  await revdesk.calls.dial({ from_number: "+1555…", to_number: "+1555…" });
} catch (err) {
  if (err instanceof RevDeskError) {
    console.error(err.code, err.status, err.message);
    if (err.isRetryable) {
      /* rate-limited or 5xx — safe to retry */
    }
  }
}

npm install @revdesk/webrtc
# or: bun add @revdesk/webrtc

import { RevDeskRTC } from "@revdesk/webrtc";

// token from revdesk.webrtc.getToken({ from_number, to_number })
const call = new RevDeskRTC({ token });
call.on("callUpdate", ({ state }) => console.log(state));
await call.connect();
call.dial({ to: "+15554560000", from: "+15551230000" });

import { RevDeskRoom } from "@revdesk/webrtc";

// from revdesk.webrtc.getRoomToken({ from_number, to_number })
const { token, room_url, call_id } = await revdesk.webrtc.getRoomToken({ from_number, to_number });
const call = new RevDeskRoom({ token, roomUrl: room_url, callId: call_id });
call.on("callUpdate", ({ state }) => console.log(state));
await call.join();