Example: voice in your web app

browser  ──POST /api/voice/start──▶  your server  ──POST /calls/create──▶  Omnia
   ◀──────── websocketUrl ─────────                ◀──── websocketUrl ────
   └────────────────── audio over WebSocket ──────────────────▶

// POST /api/voice/start
export async function POST(req) {
  const session = await getSession(req);          // your own auth
  if (!session) return new Response("Unauthorized", { status: 401 });

  const res = await fetch("https://api.omnia-voice.com/api/v1/calls/create", {
    method: "POST",
    headers: {
      "X-API-Key": process.env.OMNIA_API_KEY,     // stays on the server
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      agentId: process.env.AGENT_ID,
      connectionType: "webrtc",
      metadata: { userId: session.userId },       // shows up on the call record
    }),
  });

  const { websocketUrl } = await res.json();
  return Response.json({ websocketUrl });         // only this reaches the browser
}

import { OmniaSession } from "@omnia-voice/sdk";

const session = new OmniaSession({ apiKey: PUBLIC_PLACEHOLDER });

session.addEventListener("status", () => {
  setStatus(session.status);            // connecting | listening | speaking | disconnected
});

session.addEventListener("transcripts", () => {
  setTranscripts([...session.transcripts]);
});

const { websocketUrl } = await (await fetch("/api/voice/start", { method: "POST" })).json();
await session.joinCall({ websocketUrl });

curl -X POST "https://api.omnia-voice.com/api/v1/agent-tools" \
  -H "X-API-Key: $OMNIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "client",
    "name": "Show product",
    "modelToolName": "showProduct",
    "description": "Scroll to and highlight a product on the page. Use when the caller asks to see a specific item, or asks what something looks like.",
    "dynamicParameters": {
      "productId": {
        "required": true,
        "schema": { "type": "string", "description": "The product SKU the caller referred to" }
      }
    }
  }'

session.registerTool("showProduct", async ({ productId }) => {
  const el = document.querySelector(`[data-product="${productId}"]`);
  if (!el) return { result: "not_found" };

  el.scrollIntoView({ behavior: "smooth" });
  el.classList.add("highlight");

  return { result: "shown", responseType: "tool-response" };
});

// user navigated while talking
session.sendText(`The user is now viewing the ${page} page.`, true);

session.muteMic();       session.unmuteMic();       session.toggleMicMute();
session.muteSpeaker();   session.unmuteSpeaker();   session.toggleSpeakerMute();
await session.leaveCall();

import { OmniaVoiceProvider, useOmniaVoice, useTranscripts,
         useStatus, useMicrophone } from "@omnia-voice/sdk/react";

function App() {
  return (
    <OmniaVoiceProvider config={{ apiKey: KEY, baseUrl: "/api/omnia-proxy" }}>
      <Assistant />
    </OmniaVoiceProvider>
  );
}

function Assistant() {
  const { joinCall, leaveCall } = useOmniaVoice();
  const transcripts = useTranscripts();
  const status = useStatus();
  const { isMuted, toggle } = useMicrophone();

  return (
    <>
      <button onClick={() => joinCall({ agentId: AGENT_ID })}>Talk</button>
      <button onClick={toggle}>{isMuted ? "Unmute" : "Mute"}</button>
      <p>{status}</p>
      {transcripts.map((t, i) => <p key={i}>{t.speaker}: {t.text}</p>)}
    </>
  );
}