Web SDK

npm install @phonely-ai/web

POST https://db.phonely.ai/api/agents/{agent_id}/web-call-session
X-Authorization: YOUR_API_KEY
Content-Type: application/json

{
  "metadata": {
    "callOverrides": {}
  }
}

{
  "callId": "abc123",
  "webCallUrl": "https://...",
  "meetingToken": "short-lived-meeting-token",
  "phonelyToken": "short-lived-transcript-token",
  "expiresAt": "2026-06-12T03:00:00+00:00",
  "transcriptUrl": "https://db.phonely.ai/api/calls/abc123/transcript"
}

export async function POST(request: Request) {
  const { agentId, metadata } = await request.json();

  const response = await fetch(
    `https://db.phonely.ai/api/agents/${encodeURIComponent(agentId)}/web-call-session`,
    {
      method: "POST",
      headers: {
        "X-Authorization": process.env.PHONELY_API_KEY!,
        "Content-Type": "application/json",
      },
      body: JSON.stringify(metadata ? { metadata } : {}),
    }
  );

  if (!response.ok) {
    return Response.json(await response.json(), { status: response.status });
  }

  return Response.json(await response.json());
}

import Phonely from "@phonely-ai/web";

const phonely = new Phonely({
  createWebCallStart: async (options) => {
    const response = await fetch("/api/web-call/start", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(options),
    });

    if (!response.ok) {
      throw new Error("Failed to start web call");
    }

    return response.json();
  },
  transcript: {
    enabled: true,
    autoStart: true,
  },
});

const callId = await phonely.call({ agentId: "agent_123" });

phonely.on("transcript-message", ({ allMessages }) => {
  console.log(allMessages);
});