SDKs

npm install @sphoro/voice

import { Sphoro } from "@sphoro/voice";

const sphoro = new Sphoro({ apiKey: process.env.SPHORO_API_KEY, baseUrl: "https://voice.sphoro.com" });

const agent = await sphoro.agents.create({
  name: "Acme Clinic reception",
  languages: [{ code: "en-IN", greeting: "Thanks for calling Acme Clinic.",
                system_prompt: "You are the receptionist for Acme Clinic…" }],
});

const call = await sphoro.calls.create({
  agentId: agent.id,
  to: "+919876543210",
  callVariables: { first_name: "Priya" },
});

console.log(call.id, call.status);   // call_…  queued

import { verifyWebhook } from "@sphoro/voice";

app.post("/hooks/sphoro", express.raw({ type: "application/json" }), (req, res) => {
  // The RAW body. Re-serialised JSON will not verify.
  const event = verifyWebhook(req.body, req.headers, process.env.SPHORO_WEBHOOK_SECRET);
  if (event.type === "call.analysed") {
    save(event.call_id, event.data.summary, event.data.extracted);
  }
  res.sendStatus(200);
});

npm install @sphoro/voice-web

import { connect } from "@sphoro/voice-web";

// The url comes from YOUR server, which mints it with your API key.
// Never ship an API key to a page.
const { url } = await fetch("/api/voice-token", { method: "POST" }).then(r => r.json());

const call = await connect({ url });
call.on("state", s => setIndicator(s));            // listening | thinking | speaking
call.on("transcript", t => appendLine(t.role, t.text));
call.on("ended", e => showSummary(e.end_reason));

document.querySelector("#hangup").onclick = () => call.end();