getCallHistory

Description: get the list of recent calls.

Request example:

{
    "method": "getCallHistory",
    "requestId" : "1",
    "count": 3
}

Response example:

{
    "method": "getCallHistory",
    "requestId" : "1",
    "calls": 
    [
        {
            "type": 1,
            "confType": 0,
            "peerId": "user2@some.server",
            "peerDn": "user2",
            "startTime": 1540306165,
            "duration": 374,
            "viewed": false,
            "streamId": "000002d5@some.server#vcs"
        },
        {
            "type": 1,
            "confType": 1,
            "peerId": "user2@some.server",
            "peerDn": "user2",
            "startTime": 1540305383,
            "duration": 8,
            "viewed": false,
            "confId": "000002d5@some.server#vcs",
            "streamId": "000002d5@some.server#vcs"
        },
        {
            "type": 1,
            "confType": 1,
            "peerId": "user2@some.server",
            "peerDn": "user2",
            "startTime": 1540304614,
            "duration": 1,
            "viewed": false,
            "confId": "000002d5@some.server#vcs",
            "streamId": "000002d5@some.server#vcs"
        }
    ],
    "lastView": 1643982219,
    "result": true
}

Parameter description:

• count — the number of requested calls

• calls — the list of calls

• lastView — the timestamp indicating when the call history was last viewed

• type - type of call or conference invitation:

  • 0 — Incoming

  • 1 — Outgoing

  • 2 — Missed

• confType - session type:

  • 0 — Video call

  • 1 — Group conference

• confTitle — a group conference title (this field is unavailable for video calls)

• peerId - the unique identifier (TrueConf ID) of the user who was called by TrueConf Room API, or the user who called TrueConf Room API

• peerDn — the display name of a user who has the given peerId

• confId — the unique session identifier (available only for a group conference)

• startTime — the call start time

• duration — call duration

• viewed — Flag showing whether the call was “viewed”

• requestId - a unique request identifier. You can find more details about it here.

See also:

• clearCallHistory
• callHistoryCleared