Attention: List Chats

List Attention chats in a date range, with or without transcripts.

Tool ID: attention_list_chats

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'attention_list_chats',
  {
    "filter": {
      "external_id": "external_123",
      "type": "chat",
      "title": "VP of Engineering"
    },
    "from_date_time": "2026-01-15T12:00:00Z",
    "to_date_time": "2026-01-15T12:00:00Z"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute attention_list_chats --input '{
  "filter": {
    "external_id": "external_123",
    "type": "chat",
    "title": "VP of Engineering"
  },
  "from_date_time": "2026-01-15T12:00:00Z",
  "to_date_time": "2026-01-15T12:00:00Z"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "data": [
      {
        "id": "id_123",
        "externalId": "external_123",
        "applicationName": "Example"
      }
    ],
    "meta": {
      "pageCount": 123,
      "totalRecords": 123,
      "pageNumber": 123
    }
  }
}

Use deepline describe attention_list_chats --json for the latest machine-readable contract.

Input reference

Returns a paginated list of chats with optional filters. Org-level API keys return all chats. user-level keys return only chats accessible to the user.

Name	Type	Required	Default	Details
`payload.filter`	`object`	No	—	Filter by external ID (exact match)
`payload.from_date_time`	`string`	No	—	Start of date range filter (ISO 8601 format) Format: `date-time`.
`payload.to_date_time`	`string`	No	—	End of date range filter (ISO 8601 format) Format: `date-time`.
`payload.exclude_transcript`	`boolean`	No	`false`	If true, omit transcript data from response to reduce payload size
`payload.page`	`integer`	No	`1`	Page number for pagination (starts from 1) Minimum: 1.
`payload.size`	`integer`	No	`10`	Number of items per page (min 1, max 50) Minimum: 1. Maximum: 50.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.data`	`array`	No	—	—
`result.data.data[].id`	`string`	No	—	Unique identifier of the chat
`result.data.data[].externalId`	`string`	No	—	External identifier from the source system
`result.data.data[].applicationName`	`string`	No	—	Name of the application that created the chat
`result.data.data[].title`	`string`	No	—	Title of the chat
`result.data.data[].type`	`"chat" \| "email"`	No	—	Type of chat (chat or email) Allowed: `chat`, `email`.
`result.data.data[].userId`	`string`	No	—	UUID of the user who owns the chat
`result.data.data[].teamId`	`string`	No	—	UUID of the team the chat belongs to
`result.data.data[].participants`	`array`	No	—	List of chat participants
`result.data.data[].participants[].externalId`	`string`	No	—	External identifier of the participant
`result.data.data[].participants[].name`	`string`	No	—	Display name of the participant
`result.data.data[].participants[].email`	`string`	No	—	Email address of the participant
`result.data.data[].participants[].participantType`	`"prospect" \| "user" \| "bot"`	No	—	Type of participant Allowed: `prospect`, `user`, `bot`.
`result.data.data[].participants[].userUuid`	`string`	No	—	UUID of the associated user (if applicable)
`result.data.data[].transcript`	`array`	No	—	Chat transcript entries (omitted when exclude_transcript=true)
`result.data.data[].transcript[].sentence`	`string`	No	—	The text content of the transcript entry
`result.data.data[].transcript[].author`	`string`	No	—	Name of the author
`result.data.data[].transcript[].authorEmail`	`string`	No	—	Email address of the author
`result.data.data[].transcript[].datetime`	`string`	No	—	Timestamp of the transcript entry Format: `date-time`.
`result.data.data[].dateStart`	`string`	No	—	When the chat started Format: `date-time`.
`result.data.data[].createdAt`	`string`	No	—	When the chat record was created Format: `date-time`.
`result.data.meta`	`object`	No	—	—
`result.data.meta.pageCount`	`integer`	No	—	—
`result.data.meta.totalRecords`	`integer`	No	—	—
`result.data.meta.pageNumber`	`integer`	No	—	—
`result.data.meta.pageSize`	`integer`	No	—	—
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation