Voice SDKs

const res = await fetch("https://api.voice.stateset.com/api/v1/make-call", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.STATESET_VOICE_API_KEY}`,
    "Content-Type": "application/json",
    // Derived from the thing being called, not generated per attempt
    "Idempotency-Key": `reminder:${appointment.id}`,
  },
  body: JSON.stringify({
    agent_id: "agent_8Kx2mN4pQr",
    to: "+14155550123",
    from: "+14155550100",
  }),
});

 Browser mic + speaker  ◀──WS: start / media / stop──▶  Stateset Voice

// Mint a browser session server-side; never expose the API key to the page.
const session = await fetch("https://api.voice.stateset.com/api/v1/voice/web-calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.STATESET_VOICE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ agent_id: "agent_8Kx2mN4pQr" }),
}).then((r) => r.json());

// The browser connects with the signed URL only.
const ws = new WebSocket(session.websocket_url);
ws.onopen = () => ws.send(JSON.stringify(session.start_message));