Call Logs

CometChat Calls SDK v5 — Call Logs

Overview

Retrieve call history using CallLogRequest with pagination, filtering by type, status, direction, recordings, and specific users/groups.

Key Imports

import com.cometchat.calls.core.CometChatCalls
import com.cometchat.calls.model.CallLog
import com.cometchat.calls.core.CallLogRequest
import com.cometchat.calls.model.Recording
import com.cometchat.calls.exceptions.CometChatException

Implementation

Basic Fetch

val callLogRequest = CallLogRequest.CallLogRequestBuilder()
    .setLimit(30)
    .build()

callLogRequest.fetchNext(object : CometChatCalls.CallbackListener<List<CallLog>>() {
    override fun onSuccess(callLogs: List<CallLog>) {
        for (log in callLogs) {
            Log.d(TAG, "Session: ${log.sessionID}, Duration: ${log.totalDuration}, Status: ${log.status}")
        }
    }
    override fun onError(e: CometChatException) {
        Log.e(TAG, "Error: ${e.message}")
    }
})

Filtered Queries

// Video calls only
CallLogRequest.CallLogRequestBuilder().setSessionType("video").setLimit(20).build()

// Calls with recordings
CallLogRequest.CallLogRequestBuilder().setHasRecording(true).build()

// Missed incoming calls
CallLogRequest.CallLogRequestBuilder().setCallStatus("missed").setCallDirection("incoming").build()

// Calls with a specific user
CallLogRequest.CallLogRequestBuilder().setUid("user_id").build()

// Meeting calls only
CallLogRequest.CallLogRequestBuilder().setCallCategory("meet").build()

Pagination

// Forward pagination
callLogRequest.fetchNext(listener)

// Backward pagination
callLogRequest.fetchPrevious(listener)

Access Recordings

for (callLog in callLogs) {
    if (callLog.isHasRecording) {
        callLog.recordings?.forEach { recording ->
            Log.d(TAG, "URL: ${recording.recordingURL}")
            Log.d(TAG, "Duration: ${recording.duration} seconds")
        }
    }
}

CallLog Properties

Gotchas

• CallLogRequest is from the Calls SDK, not the Chat SDK
• setSessionType() takes lowercase strings: "video" or "audio"
• setCallDirection() takes "incoming" or "outgoing"
• setCallCategory() takes "call" or "meet"
• Create a new CallLogRequest to reset pagination
• The sample app uses Chat SDK's MessagesRequest for call logs — the Calls SDK's CallLogRequest provides richer data

Sample App Reference

• Repository.kt — fetchCallLogs() (uses Chat SDK approach)
• For Calls SDK approach, use CallLogRequest as shown above