[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_199":200,"_201":202},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":16,"_17":18,"_38":-7,"_123":-5,"_19":124,"_125":126,"_127":128,"_129":130,"_131":132,"_21":133,"_134":-5,"_135":-5,"_136":24,"_137":138,"_139":82,"_140":-5,"_141":-5,"_142":143},"routes/_app.x.$handle.$name.branch.$branch.history_.$",{"_11":12,"_13":14,"_15":16,"_17":18,"_19":20,"_21":22,"_23":24,"_25":26,"_27":28,"_29":24,"_30":-5},"handle","prudhvinakkina","name","vapi-knowledge-base","branchName","main","path","login.html","project",{"_32":69,"_13":14,"_36":70,"_71":-5,"_72":24,"_73":74,"_75":74,"_76":77,"_78":-5,"_30":65,"_79":80,"_81":82,"_83":-5,"_84":-5,"_85":26,"_40":41,"_86":87,"_88":89,"_90":91,"_92":-5,"_93":94,"_95":94,"_96":97,"_98":97,"_99":97,"_100":94,"_101":94,"_51":102,"_103":104,"_105":106,"_107":24},"file",{"_61":62,"_13":18,"_63":21,"_64":24,"_68":-5},"isDirectory",false,"page",0,"history",[31],"hasNext","userId",{"_32":33,"_34":35,"_36":37,"_38":39,"_40":41,"_42":43,"_44":-5,"_45":-5,"_46":-5,"_47":-5,"_48":-5,"_49":-5,"_50":-5,"_51":52,"_21":53,"_54":-5,"_55":-5,"_56":-5,"_57":-5,"_58":59},"id","85b4a532-412e-4a32-b863-bb1f706043ad","branchId","51319357-762a-49a7-b659-2d021fe3500c","createdAt",["D",1784597859612],"version",2,"orgId","019e511e-6214-7719-8b29-0af034f4b069","parentId","85dc572d-9a5a-4c96-9c37-7bf9de7126f8","incomingCommitId","aiChatMessageId","aiChatThreadId","aiChatThreadUserId","aiChatThreadTitle","source","clientLabel","user",{"_32":65,"_40":41,"_11":12,"_66":67},{"_61":62,"_13":18,"_63":21,"_64":24},"pull","merge","revert","multiple","commits",[60],{"_32":33,"_34":35,"_36":37,"_38":39,"_40":41,"_42":43,"_44":-5,"_45":-5,"_46":-5,"_47":-5,"_48":-5,"_49":-5,"_50":-5,"_51":52,"_21":53,"_54":-5,"_55":-5,"_56":-5},"fileId","c2687f98-84a4-11f1-8de2-1607ee4eb77e","fileType","deleted","28056148-fc13-432f-be05-37a4ce07f9db","avatar","https://lh3.googleusercontent.com/a/ACg8ocJhop25jm0wt-QSQjfGck498ZYGdD4MCM_ARgX-IyZCNlNiRl8=s96-c","deletedAtVersion","e9627797-35b4-470a-a957-8eeef849cbac",["D",1784597836214],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Collaborative Vapi platform reference","imageUrl","pinnedFileId","b47707a6-84a4-11f1-bf51-1607ee4eb77e","pinPreview",true,"pinMigrated","screenshotVersion","likeCount","tursoName","e962779735b4470aa9578eeef849cbac","tursoHostname","e962779735b4470aa9578eeef849cbac-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789474853273],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm",{"_11":12,"_122":67},"org",{"_11":12,"_117":118,"_66":67,"_30":65,"_119":120,"_121":24},"branch",{"_38":108,"_13":16,"_32":35,"_109":69,"_110":-5,"_111":-5,"_112":-5,"_113":-5,"_114":-5,"_115":14,"_116":12},"isOwned",11,"projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","Prudhvi Nakkina","tier","free","canRestrictVals","profileImageUrl","adoptOrgId",{"_32":69,"_13":14,"_36":194,"_71":-5,"_72":24,"_73":74,"_75":74,"_76":77,"_78":-5,"_30":65,"_79":80,"_81":82,"_83":-5,"_84":-5,"_85":26,"_40":41,"_86":87,"_88":89,"_90":195,"_92":-5,"_93":94,"_95":94,"_96":97,"_98":97,"_99":97,"_100":94,"_101":94,"_51":196,"_103":197,"_105":198,"_107":24},"tree",[163,164,165,166],"files",[163,164,165,166],"counts",{"_152":26,"_153":154,"_155":26,"_156":157,"_158":159},"contents",[],{"_32":144,"_13":18,"_61":62,"_42":-5,"_34":35,"_145":39,"_146":82,"_36":147,"_38":26,"_63":21,"_148":149,"_64":24,"_150":-5,"_17":151},"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},"bddd7e9f-740d-4c35-beed-11b70ed7c295","branchVersion","latest",["D",1784597859612],"content","\n\n\n\n\nVapi Knowledge Base\n\n\n\n

\n \n

\n\n\n\n\n","label",[18],"pulls","branches",1,"forks","envVars",{"_160":154,"_162":26},"connections",{"_160":26,"_161":26},"count","unfilledCount","emptyCount",{"_32":187,"_13":188,"_61":189,"_42":-5,"_34":35,"_145":183,"_146":82,"_36":190,"_38":26,"_63":21,"_148":191,"_64":24,"_150":-5,"_173":192,"_17":193},{"_32":179,"_13":180,"_61":181,"_42":-5,"_34":35,"_145":108,"_146":82,"_36":182,"_38":183,"_63":21,"_148":184,"_64":24,"_150":-5,"_173":185,"_17":186},{"_32":144,"_13":18,"_61":62,"_42":-5,"_34":35,"_145":39,"_146":82,"_36":176,"_38":26,"_63":21,"_148":149,"_64":24,"_150":-5,"_173":177,"_17":178},{"_32":167,"_13":168,"_61":80,"_42":-5,"_34":35,"_145":169,"_146":82,"_36":170,"_38":39,"_63":171,"_148":172,"_64":24,"_150":-5,"_173":174,"_17":175},"38c2010b-25b9-482f-bacc-37602efd3f44","main.tsx",6,["D",1784670333265],"http","import { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\nimport { readFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { createHmac, timingSafeEqual } from \"node:crypto\";\nimport { Buffer } from \"node:buffer\";\n\nconst PASSCODE = Deno.env.get(\"KB_PASSCODE\") || \"\";\nconst VALID_SECTIONS = [\"calls\", \"assistants\", \"infra\", \"guardrails\", \"compliance\"];\nconst SOURCE_URL = \"https://www.val.town/x/prudhvinakkina/vapi-knowledge-base\";\n\nconst SEED: Array<{ section: string; title: string; body: string; source?: string; tags?: string }> = [\n // ── CALLS ──\n {\n section: \"calls\",\n title: \"POST /call is the unified endpoint — use it\",\n body: \"`POST /call` is the single active endpoint. It handles outbound + websocket transport via `dto.type`.\\n\\n• `POST /call` — **ACTIVE**, private/org-jwt. Use this.\\n• `POST /call/phone` — **DEPRECATED**, calls the same service method, no functional difference. Migrate to `/call`.\\n• `POST /call/web` — **ACTIVE**, public/org-jwt. Web calls only, uses `TokenRestrictionsGuard`, CASL subject `webCall`.\\n• `POST /call/phone/demo` — **INTERNAL**, `@ApiExcludeEndpoint()`, demo use only.\",\n source: \"apps/api/src/call/call.controller.ts:91 (POST /call), :261 (POST /call/phone)\",\n tags: \"endpoints, deprecation, routing\",\n },\n {\n section: \"calls\",\n title: \"Call latency root cause: Aurora DB, not Twilio\",\n body: \"When `ENABLE_OUTBOUND_CALL_QUEUING` is on, the Twilio dial is fully async (handed to call-scheduler-v2 before the HTTP response). **Aurora is the blocker.**\\n\\n• Aurora INSERT baseline ~200ms, spikes to ~3s under load.\\n• Pre-INSERT sequential reads also spike — observed 2.7s vs 226ms on a healthy call.\",\n source: \"libs/core/src/dbFunctions/callDbFunctions.ts\",\n tags: \"latency, aurora, performance\",\n },\n {\n section: \"calls\",\n title: \"Recommended client timeout for POST /call: 15 seconds\",\n body: \"The old 5s timeout was too tight — it fires before Aurora recovers from a spike. **15s** gives headroom for Aurora peaks while still catching genuine hangs.\",\n tags: \"latency, timeout, recommendation\",\n },\n {\n section: \"calls\",\n title: \"Two call-creation paths: queuing vs direct\",\n body: \"**Path A · Queuing (most orgs), `ENABLE_OUTBOUND_CALL_QUEUING=on`:**\\n• DB INSERT → Twilio dial enqueued to call-scheduler-v2 (async) → HTTP response returns after INSERT.\\n• Response time = DB time only; Twilio latency is invisible to the caller.\\n\\n**Path B · Direct (flag off):**\\n• DB INSERT → Twilio dial synchronously → response after both complete.\\n• Response time = DB + Twilio round-trip. Higher latency, less common.\",\n tags: \"architecture, queuing\",\n },\n {\n section: \"calls\",\n title: \"Axiom: dataset is logs-production; app timestamps live in the message field\",\n body: \"Correct dataset name is `logs-production` (not `otel.traces`, not `vapi-logs-prod`). Use `listDatasets` to confirm if it changes.\\n\\nAxiom's ingestion timestamp is when the log arrived, not when the event happened. Real timestamps are emoji-prefixed inside the message field: `🕐 14:23:05:142` (HH:MM:SS:mmm). Query by `callId`.\",\n tags: \"axiom, logs, observability\",\n },\n\n // ── ASSISTANTS ──\n {\n section: \"assistants\",\n title: \"endCall: three separate systems\",\n body: \"**endCall tool** (recommended): explicit tool in `model.tools[]` with `type: \\\"endCall\\\"`. The LLM decides when to fire. On fire it speaks the request-start message (→ `endCallMessage` → i18n \\\"Goodbye\\\"), then ends.\\n\\n**endCallMessage**: text spoken when the endCall tool fires if no tool `messages[]` are set. Falls back to i18n \\\"Goodbye\\\". Set it as the fallback.\\n\\n**endCallPhrases**: real-time bot-transcript watcher, no LLM. Substring-matches the bot transcript; on match it mutes the user, waits for the bot to finish, waits 500ms, then ends with reason `assistant-said-end-call-phrase`. Good safety net.\\n\\n**endCallFunctionEnabled** (deprecated): auto-injects an implicit endCall tool. Replace with an explicit `model.tools[]` entry.\",\n source: \"libs/core/src/util/toolUtil/endCallToolUtil.ts · liveCallPipeline.ts:2577\",\n tags: \"endcall, tools\",\n },\n {\n section: \"assistants\",\n title: \"endCall message resolution order\",\n body: \"tool's own `messages[].content` → `assistant.endCallMessage` → i18n(\\\"Goodbye\\\", transcriber language). Implemented in `endCallMessagesRequired()`.\",\n source: \"libs/core/src/util/toolUtil/endCallToolUtil.ts\",\n tags: \"endcall\",\n },\n {\n section: \"assistants\",\n title: \"Voicemail Path A: provider-side detection\",\n body: \"The provider (Twilio/Telnyx) signals voicemail; `VoicemailDetectionStream` catches it; `liveCallManager.speakVoicemailAndEnd()` runs:\\n• If `voicemailMessage` is set → speaks it, ends with reason `voicemail`.\\n• If not set → ends immediately as `customer-did-not-answer`.\\n\\nNo LLM involved. Controlled by the `voicemailDetection` object. Set `provider` to `google` or `openai` for model-based detection.\",\n source: \"libs/core/src/components/liveCallManager.ts:1050\",\n tags: \"voicemail, detection\",\n },\n {\n section: \"assistants\",\n title: \"Voicemail Path B: LLM tool\",\n body: \"Explicit tool with `type: \\\"voicemail\\\"` in `model.tools[]`. The LLM decides when to invoke it. It has its own `messages[]`; falls back to `voicemailMessage` if empty. Extra field `beepDetectionEnabled` (Twilio-only). Unlike endCall, the voicemail tool is **not** auto-injected — add it explicitly.\",\n tags: \"voicemail, tools\",\n },\n {\n section: \"assistants\",\n title: \"Recommended endCall config\",\n body: \"1. Add `{ type: \\\"endCall\\\" }` to `model.tools[]`.\\n2. Set `endCallMessage` as the spoken goodbye.\\n3. Set `endCallPhrases` (e.g. `[\\\"goodbye\\\", \\\"take care\\\"]`) as a safety net.\\n\\nDo **not** use `endCallFunctionEnabled: true`.\",\n tags: \"recommendation, endcall\",\n },\n {\n section: \"assistants\",\n title: \"Recommended voicemail config\",\n body: \"1. Set `voicemailDetection` with your provider plan.\\n2. Set `voicemailMessage` (what to say on voicemail).\\n3. Optionally add `{ type: \\\"voicemail\\\" }` tool if LLM detection is needed.\\n\\nIf `voicemailMessage` is unset and voicemail is detected, the call silently hangs up as `customer-did-not-answer`.\",\n tags: \"recommendation, voicemail\",\n },\n\n // ── INFRA ──\n {\n section: \"infra\",\n title: \"Voice stream pipeline chain\",\n body: \"VadStream → DenoiserStream? → SttStream → ConversationBuffer → EndpointingBuffer → LlmStream → TtsStream → TurnTakingBuffer → VolumeControlBuffer → TransportStream.\\n\\nParallel: HookStream · Recorder · VoicemailDetectionStream (outbound only).\",\n source: \"libs/core/src/functions/liveCallFunctions/streamBundleConnectPipes.ts\",\n tags: \"pipeline, streams\",\n },\n {\n section: \"infra\",\n title: \"StreamModule cork/uncork backpressure\",\n body: \"All streams start **corked** — buffering input, not processing. Call `stream.ready()` to uncork and flush. Forgetting `ready()` causes silent buffering with no errors. Every subclass implements `process()`, `clear()`, `cleanup()`, `costGet()`.\",\n source: \"libs/core/src/components/streamModule.ts\",\n tags: \"streams, backpressure\",\n },\n {\n section: \"infra\",\n title: \"Three processing modes\",\n body: \"**Cascaded** (default): LLM → TTS. Most providers.\\n**Speech-to-speech**: OpenAI Realtime / Google Live. Direct audio stream, no separate TTS.\\n**Workflow**: WorkflowStream replaces the LLM for workflow-driven calls.\\n\\nSet in `streamBundleConnectPipes.ts` phase 2.\",\n tags: \"pipeline, modes\",\n },\n {\n section: \"infra\",\n title: \"Worker + queue architecture\",\n body: \"• **CALL queue** → callWorker (port 3030): real-time voice, creates LiveCallManager → LiveCallPipeline per call.\\n• **admin queue** → adminWorker: billing, status updates, post-call ops.\\n• **pendingOutbound queue** → callScheduler (call-scheduler-v2): outbound backpressure when `ENABLE_OUTBOUND_CALL_QUEUING` is on.\\n• **Kafka pipeline.ended** → postCallConsumer (port 3031): artifacts, cost rollup.\\n• **Kafka call lifecycle** → callLifecycleConsumer (port 3032): status change events.\\n\\nQueues are BullMQ on Redis.\",\n tags: \"workers, queues, kafka\",\n },\n {\n section: \"infra\",\n title: \"24+ databases, one PostgreSQL DB per domain\",\n body: \"`assistantDb` · `callDb` · `paymentDb` · `credentialDb` · `authorizationDb` · `campaignDb` · `chatDb` · `sessionDb` · `phoneNumberDb` · `voiceLibraryDb` · `testSuiteDb` · `customerDb` · `idempotencyDb` · `logsDb` + replicas.\\n\\nEach is an Aurora PostgreSQL cluster — independent scaling, separate HIPAA/PCI scope.\",\n tags: \"database, architecture\",\n },\n {\n section: \"infra\",\n title: \"Internal observability tooling\",\n body: \"• BullMQ queue browser (Bullish UI): `http://localhost:3005`\\n• Internal call inspector: `http://localhost:3018/calls/{callId}`\\n• Pipeline latency: `streamBundleLogLatency` tracks all stages.\",\n tags: \"observability, tooling\",\n },\n\n // ── GUARDRAILS ──\n {\n section: \"guardrails\",\n title: \"endCallPhrases: real-time phrase detection\",\n body: \"On each bot transcript update, checks whether the bot's last message (lowercased) contains any phrase from `endCallPhrases[]` (case-insensitive substring match). On match: mutes the user, waits for the bot to finish speaking, waits 500ms, then ends with reason `assistant-said-end-call-phrase`. No LLM involved — runs entirely in the pipeline. A good safety net for when the LLM fails to call the endCall tool.\",\n source: \"libs/core/src/components/liveCallPipeline/liveCallPipeline.ts:2577\",\n tags: \"endcall, safety\",\n },\n {\n section: \"guardrails\",\n title: \"rejectionPlan on tools\",\n body: \"Tools inherit `messages[]` and `rejectionPlan` from `ToolUserEditableBase`. `rejectionPlan` controls what the assistant does when a tool call is rejected or blocked. Configure it alongside the tool definition in `model.tools[]`.\",\n tags: \"tools, safety\",\n },\n\n // ── COMPLIANCE ──\n {\n section: \"compliance\",\n title: \"Data isolation: DB-per-domain, HIPAA & PCI scope\",\n body: \"Vapi runs 24+ separate PostgreSQL databases, one per domain (see INFRA). Each is an independent Aurora cluster, which means **separate HIPAA/PCI scope** per domain. Payment data lives in `paymentDb`, credentials in `credentialDb`, isolated from call/assistant data — independent scaling and blast-radius containment.\",\n tags: \"hipaa, pci, isolation\",\n },\n];\n\nlet readyPromise: Promise | null = null;\nfunction ensureInit(): Promise {\n if (!readyPromise) readyPromise = init();\n return readyPromise;\n}\nasync function init(): Promise {\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS kb_entries (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n section TEXT NOT NULL,\n title TEXT NOT NULL,\n body TEXT NOT NULL,\n source TEXT,\n tags TEXT,\n author TEXT,\n created_at TEXT NOT NULL DEFAULT (datetime('now'))\n )`);\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS kb_meta (k TEXT PRIMARY KEY, v TEXT)`);\n const seeded = await sqlite.execute(`SELECT v FROM kb_meta WHERE k = 'seeded'`);\n if (seeded.rows.length === 0) {\n for (const e of SEED) {\n await sqlite.execute({\n sql: `INSERT INTO kb_entries (section, title, body, source, tags, author) VALUES (?, ?, ?, ?, ?, 'seed')`,\n args: [e.section, e.title, e.body, e.source ?? null, e.tags ?? null],\n });\n }\n await sqlite.execute({ sql: `INSERT INTO kb_meta (k, v) VALUES ('seeded', '1')`, args: [] });\n }\n}\n\nfunction sessionToken(): string {\n return createHmac(\"sha256\", PASSCODE || \"unset\").update(\"kb-session-v1\").digest(\"hex\");\n}\nfunction safeEqual(a: string, b: string): boolean {\n const ab = Buffer.from(a);\n const bb = Buffer.from(b);\n return ab.length === bb.length && timingSafeEqual(ab, bb);\n}\nfunction isAuthed(req: Request): boolean {\n if (!PASSCODE) return false;\n const cookie = req.headers.get(\"cookie\") || \"\";\n const m = cookie.match(/(?:^|;\\s*)kb_auth=([a-f0-9]+)/);\n return !!m && safeEqual(m[1], sessionToken());\n}\nfunction json(data: unknown, status = 200, headers: Record = {}): Response {\n return new Response(JSON.stringify(data), {\n status,\n headers: { \"content-type\": \"application/json\", ...headers },\n });\n}\n\nexport default async function (req: Request): Promise {\n await ensureInit();\n const url = new URL(req.url);\n const p = url.pathname;\n\n if (p === \"/source\") {\n return new Response(null, { status: 302, headers: { Location: SOURCE_URL } });\n }\n\n // Auth: exchange passcode for a session cookie\n if (p === \"/auth\" && req.method === \"POST\") {\n let body: any = {};\n try { body = await req.json(); } catch { /* ignore */ }\n const supplied = String(body?.passcode ?? \"\");\n if (!PASSCODE || !safeEqual(supplied, PASSCODE)) {\n return json({ error: \"Invalid passcode\" }, 401);\n }\n return json({ ok: true }, 200, {\n \"set-cookie\": `kb_auth=${sessionToken()}; HttpOnly; Path=/; Max-Age=7776000; SameSite=Lax`,\n });\n }\n\n const authed = isAuthed(req);\n\n // API (all gated)\n if (p.startsWith(\"/api/\")) {\n if (!authed) return json({ error: \"unauthorized\" }, 401);\n\n if (p === \"/api/entries\" && req.method === \"GET\") {\n const r = await sqlite.execute(`SELECT * FROM kb_entries ORDER BY created_at DESC, id DESC`);\n return json({ entries: r.rows });\n }\n\n if (p === \"/api/entries\" && req.method === \"POST\") {\n let b: any = {};\n try { b = await req.json(); } catch { /* ignore */ }\n const section = String(b?.section ?? \"\").trim();\n const title = String(b?.title ?? \"\").trim();\n const bodyText = String(b?.body ?? \"\").trim();\n if (!VALID_SECTIONS.includes(section)) return json({ error: \"invalid section\" }, 400);\n if (!title || !bodyText) return json({ error: \"title and details are required\" }, 400);\n const source = b?.source ? String(b.source).trim().slice(0, 500) : null;\n const tags = b?.tags ? String(b.tags).trim().slice(0, 300) : null;\n const author = b?.author ? String(b.author).trim().slice(0, 80) : null;\n const ins = await sqlite.execute({\n sql: `INSERT INTO kb_entries (section, title, body, source, tags, author) VALUES (?, ?, ?, ?, ?, ?)`,\n args: [section, title.slice(0, 300), bodyText.slice(0, 8000), source, tags, author],\n });\n const row = await sqlite.execute({\n sql: `SELECT * FROM kb_entries WHERE id = ?`,\n args: [Number(ins.lastInsertRowid)],\n });\n return json({ entry: row.rows[0] }, 201);\n }\n\n const del = p.match(/^\\/api\\/entries\\/(\\d+)$/);\n if (del && req.method === \"DELETE\") {\n await sqlite.execute({ sql: `DELETE FROM kb_entries WHERE id = ?`, args: [Number(del[1])] });\n return json({ ok: true });\n }\n\n return json({ error: \"not found\" }, 404);\n }\n\n // Flowchart pages (gated)\n const FLOW_FILES: Record = {\n \"outbound-call\": \"/flow-outbound.html\",\n };\n const flow = p.match(/^\\/flows\\/([a-z0-9-]+)$/);\n if (flow) {\n if (!authed) {\n const login = await readFile(\"/login.html\", import.meta.url);\n return new Response(login, { headers: { \"content-type\": \"text/html; charset=utf-8\" } });\n }\n const file = FLOW_FILES[flow[1]];\n if (!file) return new Response(\"Flow not found\", { status: 404 });\n const html = await readFile(file, import.meta.url);\n return new Response(html, { headers: { \"content-type\": \"text/html; charset=utf-8\" } });\n }\n\n // Pages\n if (p === \"/\" || p === \"\") {\n const file = authed ? \"/index.html\" : \"/login.html\";\n const html = await readFile(file, import.meta.url);\n return new Response(html, { headers: { \"content-type\": \"text/html; charset=utf-8\" } });\n }\n\n return new Response(\"Not found\", { status: 404 });\n}\n","children",[],[168],["D",1784597859612],[],[18],"4820f447-5950-42db-92c2-0aa4f976aff0","index.html","006a8192-84a5-11f1-9543-1607ee4eb77e",["D",1784670391353],5,"\n\n\n\n\nVapi Platform Knowledge Base\n\n\n\n

\n \n

\n\n

\n \n

\n\n\n\n\n\n",[],[180],"84d23682-4313-4237-948e-82b7e5dbec0a","flow-outbound.html","747ecd56-854d-11f1-a638-1607ee4eb77e",["D",1784670313854],"\n\n\n\n\nPOST /call — Outbound Call E2E Flow\n\n\n\n\n\nCALLS · FLOWCHART\n

POST /call — Outbound Call E2E Flow

Full lifecycle of an outbound phone call: HTTP entry → initialization → transport routing (two paths) → carrier dial → callWorker pipeline → call end. Latency-bearing steps are flagged.

\n\n\n

01HTTP Entryapps/api

\n call.controller.ts:91 — CallController.create()\n

\n • Auth + CASL scope check (ACTION_AUTH.CREATE, SUBJECT_AUTH.CALL)\n • If dto.type === 'outboundPhoneCall' → fires async Dodgeball fraud tracking event\n • If dto.transport.provider === 'websocket' → diverges to callService.websocketCallCreate()\n • Otherwise → callService.createPhoneCall()\n

↓

\n call.service.ts:201 — createPhoneCall()\n

\n • dto.customers (batch) → callBatch() → different path (fan-out)\n • dto.schedulePlan → callSchedule() (writes scheduled row, no immediate dial)\n • Otherwise → callOutbound() ← the normal path\n

\n\n

callOutbound()↓

\n\n\n

02Call InitializationphoneCallFunctions.ts:276

\n 1\n

Pre-load org + feature flags db read

callOrgGet() / featureFlagGet(). Validates billing (concurrency limits, subscription). Returns 400 here if over limit — no DB write yet.

\n 2\n

Resolve assistant version db read

assistantVersionForCallDispatch(). Handles assistantId, inline assistant, squadId/squad, workflowId/workflow, or pinned assistantVersionId. Error → 400 before any call row is written.

\n 3\n

Write call row to DB db write

callInitialize(). Inserts call with status: 'queued'. From this point a call record exists.

\n 4\n

Fetch resources multiple db reads

callResourcesGet(): full assistant (tools, credentials), phone number, customer record, all credentials. Missing → callEndOnError() + error.

\n 5\n

Guard checks each failure marks call ended

\n • Free Vapi number → international → call.start.error-vapi-number-international\n • Dodgeball fraud check (ENABLE_OUTBOUND_CALL_FRAUD_CHECK + Vapi number)\n • Daily outbound limit (resets if outboundCallsCounterNextResetAt passed)\n

\n\n

↓

\n\n\n

03Transport Routingtwo paths

Branch

ENABLE_OUTBOUND_CALL_QUEUING feature flag?

Path A · Queuing ON

\n pendingOutboundCallEnqueue() pushes the call into a Redis/Valkey pending queue. API returns immediately with the queued call. A separate callScheduler worker dequeues and calls callOutboundTransportAndQueue() when capacity is available.

Backpressure valve — prevents thundering-herd on carrier APIs.\n

Path B · Direct (flag off)

\n callOutboundTransportAndQueue() is called inline from the API request, adding its latency directly to the HTTP response. Also taken when phoneCallProviderBypassEnabled.

This is why POST /call sometimes takes >5s — the carrier API is hit synchronously.\n

\n\n

both converge on callOutboundTransportAndQueue()↓

\n\n\n

04Transport + QueuephoneCallFunctions.ts:132

\n callTransportGet() — carrier dial latency 1–5s+\n

Contacts Twilio / Telnyx / Vonage to actually dial the phone — creates the PSTN leg. TwiML/SIP URI streams audio back to Vapi's WebSocket server. Primary latency source on Path B.
• Error → callTransportErrorHandle() + Kafka callOutboundInitiatedEventEmit(status: 'failure')

↓

\n liveCallRequired()\n

Constructs the LiveCall object, stamping all resolved resources (org, assistant, phone number, customer, credentials, feature flags) onto the call.

↓

\n callStoreAndQueue()\n

Updates the call row (transport info, phone provider ID, increments concurrency counter) and enqueues a BullMQ job to the CALL queue for the callWorker.

↓

\n Kafka + API response\n

• Kafka callOutboundInitiatedEventEmit(status: 'success')• API returns the call object (status: queued) — the call.status === 'queued' webhook fires here.

\n\n

BullMQ CALL queue↓

\n\n\n

05callWorker — Live Pipelineapps/callWorker

\n streamBundleConstruct.ts → streamBundleConnectPipes.ts\n

BullMQ picks up the job and creates the LiveCallPipeline. The stream pipeline is constructed, then wired:

Carrier WebSocket audio in ↓

VadStreamvoice activity detection

DenoiserStreamoptional

BackgroundSpeechFilteroptional

CombinedAudioBufferrecording mix

SttStreamDeepgram / AssemblyAI / …

ConversationBuffermessage history

EndpointingBufferend-of-turn detection

LlmStreamOpenAI / Anthropic / …

TtsStreamElevenLabs / Cartesia / …

SampleRateConverter

TurnTakingBuffer

VolumeControlBufferbot speaking state, audio mixing

TransportStream→ carrier WebSocket audio out

↓

\n callStart()\n

All streams start corked (buffering). callStart() uncorks them, fires the assistant-request → assistant-response webhook sequence (server-URL-based configs), then fires status-update: in-progress.

\n\n

on end condition: silence / maxDuration / endCall / hangup↓

\n\n\n

06Call Endmanager.end()

manager.end()

Waits ~2.5s for final STT transcripts to drain.

Cost collection (bottom-up)

STT (per min per channel), LLM (per token), TTS (per character). BYOK credentials (org provides key) → marked user-fault, not billed to subscription.

streamBundleArtifacts()

Uploads recording WAV + transcript JSON to S3.

callComplete()

Writes final DB state: endedAt, endedReason, costs, artifact URLs, analysis (structuredData + successEvaluation + summary from the analysis plan).

end-of-call-report webhook

Delivered to your server URL.

\n\n\n

Key latency sources on POST /call

\n \n \n \n \n \n \n \n \n \n \n

Source	When it hits
callOrgGet + featureFlagGet	always DB reads
assistantVersionForCallDispatch	always DB read
callInitialize	always DB write
callResourcesGet	always multiple DB reads (assistant + phone number + credentials)
Dodgeball fraud check	conditional Vapi numbers only, flag-gated
callTransportGet (carrier API)	path B only biggest variable, 1–5s+ (queuing flag off)

\n If queuing (ENABLE_OUTBOUND_CALL_QUEUING) is on for your org, the carrier dial is deferred and the API returns fast. On the standard path it's all synchronous — which explains the >5s responses seen in the earlier investigation.\n

\n\n\n\n\n\n",[],[188],["D",1784597836214],["D",1789474853273],{"_11":12,"_122":67},{"_11":12,"_117":118,"_66":67,"_30":65,"_119":120,"_121":24},{"_38":108,"_13":16,"_32":35,"_109":69,"_110":-5,"_111":-5,"_112":-5,"_113":-5,"_114":-5,"_115":14,"_116":12},"ctx",{"_51":-5,"_141":232,"_233":234,"_235":236,"_237":24,"_238":24,"_239":24,"_240":82,"_241":-5,"_242":-7,"_243":-7,"_244":26,"_245":24,"_246":24,"_247":-5,"_248":24,"_249":24,"_250":24,"_251":-5},"ENV",{"_203":204,"_205":206,"_207":16,"_208":209,"_210":211,"_212":213,"_214":215,"_216":217,"_218":219,"_220":221,"_222":223,"_224":225,"_226":227,"_228":229,"_230":231},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Add knowledge

POST /call — Outbound Call E2E Flow

History · login.html