Supafone Labs ยท Documentation

Call Recordings and Artifacts#

Call recording is an explicit agent policy. Do not silently enable it without a user/admin choice and an appropriate consent path.

Agent Creation Policy#

ts
await supafone.labs.agents.createInbound({
  agentKey: "northline-intake",
  name: "Northline intake",
  recording: {
    enabled: true,
    recordAudio: true,
    consentRequired: true,
    announcement: "This call may be recorded for quality and training.",
    retentionDays: 30,
    redactPii: true
  },
  transcription: {
    enabled: true,
    provider: "supafone_managed",
    language: "multi",
    diarization: true,
    timestamps: true,
    redactPii: true
  },
  artifacts: {
    recordings: true,
    transcripts: true,
    summaries: true,
    qaReports: true,
    logs: true,
    retentionDays: 30
  }
});

Python uses the same payload shape and serializes it to snake_case for the API.

Artifact APIs#

The SDK exposes call artifacts under the hosted-agent namespace:

ts
const calls = await supafone.labs.calls.list({ agentKey: "northline-intake" });
const call = await supafone.labs.calls.get("call_123");
const recordings = await supafone.labs.recordings.list({ callId: "call_123" });
const transcripts = await supafone.labs.transcripts.list({ agentKey: "northline-intake" });

// Signed, short-lived URLs for browser playback and downloads.
console.log(call.call.recording_url, call.call.recording_download_url);

// Removes the account-owned call, transcript, Watcher history, and archived audio.
await supafone.labs.calls.delete("call_123");
await supafone.labs.recordings.delete("rec_123", { reason: "retention request" });

Every agent creation, call lifecycle, transcript, recording archive, Watcher observation, and generated Studio plan is also queryable from the durable activity ledger:

ts
const watcher = await supafone.labs.activity.list({
  eventType: "watcher.whispered",
  resourceId: "call_123",
});
const plans = await supafone.labs.plans.list();

Builder UI should expose:

Compliance Notes#

View raw Markdown