Glossary: C4D

FieldTypeFormatDescription
call_ref
string The unique reference generated by Teleforge for the call
call_time
numbersecondsThe total duration of the call, including ringing and holding 
call_trail_number
numberpositive integerThe "leg" of the call, most calls go through various phases and transfers, this will identify in what order these happened 
call_trail_ref
string The identifier for the entire call trail, through all its transfers (call_ref will MOSTLY be unique for each leg)
call_type
stringenum

The type of the call:

  • inbound
  • outbound
  • internal
  • external
  • transfer - essentially when the underlying telephony system can't distinguish
  • transfer-attended
  • transfer-blind
clid
stringregexThe Number used by the telephony system in this call, on outbound it will be the number shown to the callee, on inbound it will be the number the caller dialled.
contact_ref
stringregexThe integrator supplied reference for this callee, usually an account number, matter number or some kind of identification number
dialed_at
numberUnix Timestamp (seconds)A Unix timestamp in seconds of when the call started.
end_reason
stringenum

How the call ended: see Dispositions

extension
stringregex

The "Agent", essentially this is the source party of the call. Normally in a call centre environment, this is the agents' extension.

But in the case of external calls, this can be the full number of the party to initiate first, which should be an employee.

hold_time_number
numberseconds"Hold time experienced by the number party", the total amount of time the client spent on hold.
isdn_code
numberpositive integerThe ISDN Cause Code to indicate the reason the call terminated, see ISDN Cause Codes
number
stringregexThe number to connect the extension to. Usually this is a clients number but it can also be another extension in the case of an internal call.
ring_time_extension
numberseconds"Ring time experienced by the extension party", the amount of time the call rang for before the client (number) answered.
ring_time_number
numberseconds"Ring time experienced by the number party", the amount of time the call rang for before the extension or PBX answered.