Conversations

List replica's conversations

List of replica's conversations with pagination and sorting.

get/v1/replicas/{replicaUUID}/conversations

Request

Base URL: https://api.sensay.io
URL: https://api.sensay.io/v1/replicas/{replicaUUID}/conversations
Auth: one of:
- API key in header X-ORGANIZATION-SECRET and API key in header X-USER-ID and API key in header X-USER-ID-TYPE
- API key in header X-ORGANIZATION-SECRET

Path parameters

replicaUUIDstring uuid required

The replica unique identifier (UUID)

Example:03db5651-cb61-4bdf-9ef0-89561f7c9c53

Query parameters

pageSizenumber nullable

The number of items per page.

Example:24

pagenumber

The page number.

Example:2

sortBy'replicaReplies' | 'firstMessageAt' | 'lastReplicaReplyAt'

Sort criteria.

Example:lastReplicaReplyAt

sortOrder'asc' | 'desc'

The order of the sort.

Example:asc

Headers

X-API-Versionstring

Example:2025-03-25

Response

List of conversations

totalnumber required

The total number of conversations for this replica.

successtrue required

Indicates the request was successful

Example response

{
  "items": [
    {
      "uuid": "8e9309af-baa4-4a85-8c59-c3a2a0c2ad0f",
      "chatUUID": "550e8400-e29b-41d4-a716-446655440001",
      "source": "telegram",
      "messageCount": 42,
      "replicaReplyCount": 42,
      "firstMessageAt": "2025-05-27T15:02:44.499744+00:00",
      "lastMessageAt": "2025-05-27T15:02:44.499744+00:00",
      "lastReplicaReplyAt": "2025-05-27T15:02:44.499744+00:00",
      "conversationName": "John Doe",
      "conversationImageURL": "https://example.com/image.png",
      "summary": "Discussion about blockchain technology and its applications in fintech.",
      "commonQuestions": [
        "What is blockchain?",
        "How does DeFi work?",
        "What are smart contracts?"
      ],
      "commonTopics": [
        "blockchain",
        "cryptocurrency",
        "smart contracts",
        "fintech"
      ],
      "conversationType": "individual"
    }
  ],
  "total": 1001,
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.