查询 Meta Business Agent 对话轮次

get

https://api.ycloud.com/v2/metaBusinessAgents/{entityId}/conversationTurns

查询指定 WhatsApp 用户的对话轮次。entityId 是 WhatsApp Business Phone Number ID。
时间边界均包含在查询范围内，单位为 Unix epoch milliseconds。before 和 after
最多提供一个，cursor 必须原样传递。只要响应存在 paging.next 就继续分页，即使当前
data 数组为空。

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

entityId

string

required

length ≥ 1

当前接口定义的 Meta Business Agent 实体 ID。Budget 和 Conversation Turns 接口均使用
当前租户拥有的 WhatsApp Business Phone Number ID。

Query Params

user_phone_number

string

required

^[1-9][0-9]{1,14}$

包含国家码的 WhatsApp 用户手机号，只能包含数字，不得带前导 +、空格或分隔符。

start_timestamp_ms

int64

≥ 0

查询开始时间，包含该边界，单位为 Unix epoch milliseconds。

end_timestamp_ms

int64

≥ 0

查询结束时间，包含该边界，单位为 Unix epoch milliseconds；同时提供开始时间时不得小于 start_timestamp_ms。

before

string

length ≥ 1

不透明的向前分页 cursor；不得与 after 同时提供。

after

string

length ≥ 1

不透明的向后分页 cursor；不得与 before 同时提供。

limit

int32

≥ 1

本次最多返回的对话轮次数量。

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200成功查询对话轮次。

400请求参数无效。

401需要有效的 API key。

403当前租户不拥有该资源，或缺少所需 Meta 权限。

404未找到请求的 Meta Business Agent 资源。

422请求格式正确，但当前无法处理。

429向 YCloud 或 Meta 发送的请求过多。

500发生内部服务器错误。

502Meta Business Agent 返回无效响应或上游暂时不可用。