Skip to main content

Interface: CallRecord

Defined in: packages/agentos/src/channels/telephony/types.ts:193

Full record of a voice call -- used for tracking, persistence, and status queries.

Properties​

callId​

callId: string

Defined in: packages/agentos/src/channels/telephony/types.ts:195

Unique call identifier (UUID).

createdAt​

createdAt: number

Defined in: packages/agentos/src/channels/telephony/types.ts:219

Unix timestamp (ms) when the call was created.

direction​

direction: CallDirection

Defined in: packages/agentos/src/channels/telephony/types.ts:203

Call direction.

endedAt?​

optional endedAt: number

Defined in: packages/agentos/src/channels/telephony/types.ts:221

Unix timestamp (ms) when the call reached a terminal state.

errorMessage?​

optional errorMessage: string

Defined in: packages/agentos/src/channels/telephony/types.ts:223

Error message if state is 'error' or 'failed'.

fromNumber​

fromNumber: string

Defined in: packages/agentos/src/channels/telephony/types.ts:207

E.164 phone number of the caller.

metadata?​

optional metadata: Record<string, unknown>

Defined in: packages/agentos/src/channels/telephony/types.ts:225

Provider-specific metadata.

mode​

mode: CallMode

Defined in: packages/agentos/src/channels/telephony/types.ts:205

Call interaction mode.

processedEventIds​

processedEventIds: string[]

Defined in: packages/agentos/src/channels/telephony/types.ts:215

IDs of webhook events already processed (idempotency).

provider​

provider: VoiceProviderName

Defined in: packages/agentos/src/channels/telephony/types.ts:199

Which provider is handling this call.

providerCallId?​

optional providerCallId: string

Defined in: packages/agentos/src/channels/telephony/types.ts:197

Provider-assigned call ID (e.g., Twilio CallSid).

seedId?​

optional seedId: string

Defined in: packages/agentos/src/channels/telephony/types.ts:211

Agent seed ID (if bound to a specific agent).

state​

state: CallState

Defined in: packages/agentos/src/channels/telephony/types.ts:201

Current state in the call lifecycle.

streamSid?​

optional streamSid: string

Defined in: packages/agentos/src/channels/telephony/types.ts:217

Stream SID for media streams (Twilio-specific).

toNumber​

toNumber: string

Defined in: packages/agentos/src/channels/telephony/types.ts:209

E.164 phone number being called.

transcript​

transcript: TranscriptEntry[]

Defined in: packages/agentos/src/channels/telephony/types.ts:213

Conversation transcript.