customerTimeline

Fetch a customer’s unified activity timeline — audit events, tracked behavioral events, and notes — merged and sorted newest first.

Filter by sources to include only certain entry kinds, or dateRange to bound the window. Use customerBehavioralSummary for an aggregated view instead of individual entries.

Auth · x-app-token · required permission showCustomers

QUERY

customerTimeline(customerId: String!, page: Int, perPage: Int, sources: [TimelineEntrySource!], dateRange: EventDateRangeInput): CustomerTimelineResponse!

Arguments

customerId

String!

required

Customer id to fetch the timeline for.

page

Int

1-based page index. See Pagination.

perPage

Int

Page size. See Pagination.

sources

[TimelineEntrySource!]

Restrict to these entry sources. Omit to include all.

dateRange

EventDateRangeInput

Restrict entries to this ISO date range. Omit for no bound.

Returns

CustomerTimelineResponse!

entries

[TimelineEntry!]!

TimelineEntry rows for the current page, newest first.

totalCount

Int!

Total number of matching entries.

hasMore

Boolean!

Whether additional pages are available.

Query

query CustomerTimeline($customerId: String!) {
  customerTimeline(customerId: $customerId) {
    entries {
      id
      timestamp
      source
      action
      contentType
      contentId
    }
    totalCount
    hasMore
  }
}

Variables

{
  "customerId": "string"
}

Response

{
  "data": {
    "customerTimeline": {
      "entries": [
        {
          "id": "string",
          "timestamp": "string",
          "source": "activity",
          "action": "string",
          "contentType": "string",
          "contentId": "string"
        }
      ],
      "totalCount": 1,
      "hasMore": true
    }
  }
}

آخر تعديل في ١١ أغسطس ٢٠٢٦

Query

query CustomerTimeline($customerId: String!) {
  customerTimeline(customerId: $customerId) {
    entries {
      id
      timestamp
      source
      action
      contentType
      contentId
    }
    totalCount
    hasMore
  }
}

Variables

{
  "customerId": "string"
}

Response

{
  "data": {
    "customerTimeline": {
      "entries": [
        {
          "id": "string",
          "timestamp": "string",
          "source": "activity",
          "action": "string",
          "contentType": "string",
          "contentId": "string"
        }
      ],
      "totalCount": 1,
      "hasMore": true
    }
  }
}

البداية

أدلة

جرّب

Queries

Mutations

Types

customerTimeline

Arguments

Returns