会話ユーザーを取得 | ElevenLabs Documentation

{
  "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

ヘッダー

クエリパラメータ

レスポンス

エラー