获取会话用户

GET

/v1/convai/users

GET

/v1/convai/users

curl -G https://api.elevenlabs.io/v1/convai/users \
     -d agent_id=agent_3701k3ttaq12ewp8b7qv5rfyszkz

{
  "users": [
    {
      "user_id": "string",
      "last_contact_unix_secs": 1,
      "first_contact_unix_secs": 1,
      "conversation_count": 1,
      "last_contact_conversation_id": "string",
      "sentiment": {
        "scored_conversation_count": 1,
        "positive_count": 1,
        "neutral_count": 1,
        "negative_count": 1,
        "average_sentiment_score": 1.1,
        "average_frustration_score": 1.1,
        "recent_scored_conversation_count": 1,
        "recent_positive_count": 1,
        "recent_neutral_count": 1,
        "recent_negative_count": 1,
        "recent_average_sentiment_score": 1.1,
        "recent_average_frustration_score": 1.1
      },
      "last_contact_agent_id": "string",
      "last_contact_agent_name": "string",
      "most_frustrated_conversations": [
        {
          "conversation_id": "string",
          "agent_id": "string",
          "start_time_unix_secs": 1,
          "overall_label": "positive",
          "overall_sentiment_score": 1.1,
          "overall_frustration_score": 1.1
        }
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

分页获取对话中的不同用户。

查询参数

agent_idstring or null可选

智能体 id（agent_…）或语音引擎外部 id（seng_），均会解析为同一底层资源。

branch_idstring or null可选

按分支 ID 筛选对话。

call_start_before_unixinteger or null可选

用于筛选截至此开始日期对话的 Unix 时间戳（秒）。

call_start_after_unixinteger or null可选

用于筛选此开始日期之后对话的 Unix 时间戳（秒）。

searchstring or null可选

按用户 ID 搜索／筛选（精确匹配）。

page_sizeinteger可选1-100默认为 30

最多返回的用户数量。默认为 30。

sort_byenum可选

用于排序结果的字段。默认值为 last_contact_unix_secs。

允许的值:

sort_directionenum可选

结果排序方向

允许的值:

cursorstring or null可选

用于获取下一页。响应中会返回游标。

响应

成功响应

userslist of objects

has_moreboolean

next_cursorstring or null可选

错误

422

Unprocessable Entity Error

请求头

查询参数

响应

错误