List this visitor’s conversations

Lists only active Web App conversations bound to this visitor, without administration-side status=all semantics. Increase offset by actual items returned. Stop on an empty page or at total. Pages do not guarantee a fixed snapshot.

GET https://api.moi.matrixorigin.cn/v5/public/webapp/conversations

Before you call this API

Set BASE_URL to the product API prefix https://api.moi.matrixorigin.cn/v5; use the corresponding product API URL for a dedicated deployment.

Prepare links and visitor identity in the same environment. Do not supply a product PAT or workspace request headers.

Request

curl --request GET \
  "$BASE_URL/public/webapp/conversations?webapp=$AGENT_ID&t=$WEBAPP_TOKEN&s=$WEBAPP_SESSION&limit=50&offset=0"

Parameter

Location

Type

Required

Description

webapp

Queries

string

Yes

Agent ID associated with the link.

t

Queries

string

Yes

Currently valid publication token. For short-code links, resolve first, then use the short code as t.

s

Queries

string

Yes

Visitor session credential for the same publication.

limit

Queries

integer

No

Default 50, maximum 200. Invalid/nonpositive values use the default.

offset

Queries

integer

No

Default 0; negative values use 0.

Successful response

{
  "code": 0,
  "data": {
    "items": [
      {
        "conversation_id": "conversation-example",
        "title": "问题记录",
        "updated_at": "2026-11-12T01:00:00Z"
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}

Success returns HTTP 200 and numeric code=0. Read data’s object descriptions alongside the example. The conversation creation example is only a field excerpt.

Error responses

Public errors and identity handling distinguishes unavailable/disabled links, invalid sessions, parameters, and system failures.

Next page

When the first page has one item and total is not reached, the example uses offset=1. Advance by the actual returned count.

curl --request GET \
  "$BASE_URL/public/webapp/conversations?webapp=$AGENT_ID&t=$WEBAPP_TOKEN&s=$WEBAPP_SESSION&limit=50&offset=1"
Last updated on