Skip to main content

Telephony (lamp.telephony)

Records call metadata (not content). Call traces are hashed identifiers — the same contact produces a consistent trace, enabling degree analysis without exposing the actual phone number.

Configuration

  • SensorSpec: lamp.telephony
  • Sampling: Continuous (one event per call)
  • Platform: iOS, Android

Usage

Call events are recorded automatically. No participant action is required. Only metadata is captured — call audio content is never recorded by this sensor.

Data

Fields

FieldTypeDescription
typestring"incoming", "outgoing", or "missed"
durationnumberCall duration in seconds
tracestringHashed contact identifier

Example

{
"timestamp": 1649864919743,
"sensor": "lamp.telephony",
"data": {
"type": "incoming",
"duration": 24,
"trace": "22F222FF-F2F2-4000-92F3-293049DC4FEC"
}
}

Cortex Features

telephony (raw) → call_number, call_duration, call_degree (secondary)

Call features accept a call_direction parameter: "all", "incoming", or "outgoing".

note

Text message features (text_number, text_degree) depend on the messages_usage raw feature from iOS SensorKit — not on lamp.telephony. See Communication features for details.

View in Portal | Python SDK | API Reference