Skip to main content

Interface: PhoneCall

Defined in: packages/sdk/src/types/generated/communication.ts:412

Properties​

agent?​

optional agent: BaseAssistantResponse | null

Defined in: packages/sdk/src/types/generated/communication.ts:422

carrierStatus?​

optional carrierStatus: string | null

Defined in: packages/sdk/src/types/generated/communication.ts:428

Twilio CallStatus / DialCallStatus terminal value (GRA-6416): completed, busy, no-answer, failed, or canceled. Independent of product intent — a successful transfer is terminationReason=forward + carrierStatus=completed; a transfer whose destination was busy is forward + busy.

chatId?​

optional chatId: number | null

Defined in: packages/sdk/src/types/generated/communication.ts:415

createdAt​

createdAt: string

Defined in: packages/sdk/src/types/generated/communication.ts:418

credits?​

optional credits: number | null

Defined in: packages/sdk/src/types/generated/communication.ts:424

failureDetail?​

optional failureDetail: string | null

Defined in: packages/sdk/src/types/generated/communication.ts:430

Transport / infra failure detail (GRA-6416): connection_reset (Twilio ErrorCode on completed call), stream_reset (media-stream WebSocket reset, e.g. Twilio 31921), never_connected (bridge-leg provisional), timeout, bridge_call_create_failed, bridge_call_create_missing_sid, fax_t30_failed, other closed fax_* receive codes, or error.

finishedAt?​

optional finishedAt: string | null

Defined in: packages/sdk/src/types/generated/communication.ts:420

id​

id: number

Defined in: packages/sdk/src/types/generated/communication.ts:413

inbound​

inbound: boolean

Defined in: packages/sdk/src/types/generated/communication.ts:423

member?​

optional member: WorkspaceMemberResponse | null

Defined in: packages/sdk/src/types/generated/communication.ts:421

phoneNumberId​

phoneNumberId: number

Defined in: packages/sdk/src/types/generated/communication.ts:414

startedAt?​

optional startedAt: string | null

Defined in: packages/sdk/src/types/generated/communication.ts:419

status​

status: string

Defined in: packages/sdk/src/types/generated/communication.ts:417

terminationReason?​

optional terminationReason: string | null

Defined in: packages/sdk/src/types/generated/communication.ts:426

Product / app outcome for how the call ended (GRA-6416). Preferred values: hangup (assistant ended), forward (call forwarded), handoff, completed (caller hung up / normal end), policy rejects (voice_disabled, anonymous_rejected, …), blocked_outbound_safety, voicemail, amd_unknown. Legacy rows may also hold carrier strings (busy, no-answer, …) or transport failures (connection_reset, stream_reset, never_connected); prefer carrierStatus / failureDetail when present. Null for in-progress/unknown calls.

twilioCallId​

twilioCallId: string

Defined in: packages/sdk/src/types/generated/communication.ts:416

workflowId?​

optional workflowId: number | null

Defined in: packages/sdk/src/types/generated/communication.ts:432

ID of the workflow associated with this call, resolved via the chat's assignment (PhoneCall.chat_id -> Chat.assignment_id -> Assignment.workflow_revision_id -> WorkflowRevision.workflow_id). Null for direct human-to-human calls with no chat, or chats with no assignment.