Skip to main content

@dialstack/sdk-dev / js/src / CallLog

Interface: CallLog

Defined in: sdk/js/src/types/components.ts:560

Properties​

answered_at​

TypeScript
answered_at: string | null;

Defined in: sdk/js/src/types/components.ts:625


connected_at​

TypeScript
connected_at: string | null;

Defined in: sdk/js/src/types/components.ts:631


did​

TypeScript
did: string | CallLogDID | null;

Defined in: sdk/js/src/types/components.ts:575

The phone number (DID) associated with the call. The DID's id by default, or a compact DID object (id + phone_number) when expand[]=did is requested; null when none.


did_id​

TypeScript
did_id: string | null;

Defined in: sdk/js/src/types/components.ts:569

Deprecated​

Use did (its id form). Retained for backwards compatibility.


direction​

TypeScript
direction: "inbound" | "outbound" | "internal";

Defined in: sdk/js/src/types/components.ts:601


duration_seconds​

TypeScript
duration_seconds: number | null;

Defined in: sdk/js/src/types/components.ts:633


ended_at​

TypeScript
ended_at: string | null;

Defined in: sdk/js/src/types/components.ts:632


endpoint?​

TypeScript
endpoint?: string | null;

Defined in: sdk/js/src/types/components.ts:565


endpoint_id​

TypeScript
endpoint_id: string | null;

Defined in: sdk/js/src/types/components.ts:567

Deprecated​

Use endpoint. Retained for backwards compatibility.


from_label​

TypeScript
from_label: string | null;

Defined in: sdk/js/src/types/components.ts:614

The caller's display name. For internal callers this is the calling user's display name (the caller is always a user's device); for external callers it is the caller ID name (CNAM). While a call is live it is the name captured at call start. Null when no name is available.

For external callers the CNAM is not interpreted, only trimmed and limited to 80 characters, so it may be a locality rather than a person ("LA MESA CA"), a placeholder ("WIRELESS CALLER"), or a restatement of from_number — check for the latter before rendering the name beside the number.


from_number​

TypeScript
from_number: string;

Defined in: sdk/js/src/types/components.ts:602


hangup_cause​

TypeScript
hangup_cause: number | null;

Defined in: sdk/js/src/types/components.ts:642


id​

TypeScript
id: string;

Defined in: sdk/js/src/types/components.ts:561


quality_metrics​

TypeScript
quality_metrics: QualityMetricLeg[];

Defined in: sdk/js/src/types/components.ts:653


recording_url​

TypeScript
recording_url: string | null;

Defined in: sdk/js/src/types/components.ts:650


TypeScript
related_call: string | null;

Defined in: sdk/js/src/types/components.ts:600

Another call belonging to the same conversation, as a call id; null when this call stands alone, which is the common case.

One conversation does not always fit in one call log. Today that happens when a parked caller is picked back up: the retrieval is a new call from the retriever's endpoint and so gets its own entry, and the two name each other. Treat the field as "there is more of this conversation over there" rather than as a park-specific marker — other flows may populate it later.

It does not say which way it points, and it does not need to. started_at orders a linked group, and the earliest entry is the one the conversation started on; follow the links to walk a longer chain.

The relation can be many-to-one — several entries may name the same call while it names only one of them back — so do not assume the link round-trips to the entry you came from.


remote_number​

TypeScript
remote_number: string | RemoteNumber | null;

Defined in: sdk/js/src/types/components.ts:581

The external party in E.164 (the caller on an inbound call, the number dialed on an outbound one); the RemoteNumber with expand: ['remote_number']. Null on internal and emergency calls.


sentiment​

TypeScript
sentiment: Sentiment | null;

Defined in: sdk/js/src/types/components.ts:649

AI-derived sentiment of the call transcript. Null if the call was not recorded, the transcript is not yet processed, or the analysis did not produce a usable result.


started_at​

TypeScript
started_at: string;

Defined in: sdk/js/src/types/components.ts:624


status​

TypeScript
status: "voicemail" | "failed" | "completed" | "no-answer" | "busy" | null;

Defined in: sdk/js/src/types/components.ts:638

Final call status. Null while the call is still live (in progress) — the status values are terminal only.


summary​

TypeScript
summary: string | null;

Defined in: sdk/js/src/types/components.ts:643


to_label​

TypeScript
to_label: string | null;

Defined in: sdk/js/src/types/components.ts:623


to_number​

TypeScript
to_number: string | null;

Defined in: sdk/js/src/types/components.ts:622

Destination number/extension. While a call is live it is present when the destination is known at call start (outbound and internal extension-to- extension calls); for an inbound call the routed destination is resolved later, so this is null for the whole time the call is in flight and is populated once the call completes.


user?​

TypeScript
user?: string | null;

Defined in: sdk/js/src/types/components.ts:562


user_id​

TypeScript
user_id: string | null;

Defined in: sdk/js/src/types/components.ts:564

Deprecated​

Use user. Retained for backwards compatibility.