Chat Conversations

Get a paginated list of chat conversations, optionally filtered by platform.

GET /v1/conversations/chats

Parameters

Parameter	Type	Default	Description
from	ISO 8601	30 days ago	Start of the date range
to	ISO 8601	Now	End of the date range
platform	string	—	Filter by platform: webchat, whatsapp, messenger, instagram
cursor	string	—	Pagination cursor
limit	integer	25	Items per page (max: 100)

Response

{
  "data": [
    {
      "id": "770e8400-e29b-41d4-a716-446655440000",
      "title": "Booking inquiry",
      "platform": "webchat",
      "language": "en",
      "created_at": "2026-03-10T09:15:00.000Z"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "2026-03-10T09:15:00.000Z"
  }
}

Response Fields

Field	Type	Description
id	string	Conversation ID
title	string|null	Conversation title
platform	string	Source platform
language	string|null	Detected language
created_at	string	Conversation start time

Example

cURL

curl "https://api.opally.com/v1/conversations/chats?platform=webchat&limit=20" \
  -H "Authorization: Bearer op_live_your_api_key_here"

JavaScript