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 |
|---|---|---|---|---|
|
Queries |
string |
Yes |
Agent ID associated with the link. |
|
Queries |
string |
Yes |
Currently valid publication token. For short-code links, resolve first, then use the short code as t. |
|
Queries |
string |
Yes |
Visitor session credential for the same publication. |
|
Queries |
integer |
No |
Default 50, maximum 200. Invalid/nonpositive values use the default. |
|
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"