Tham chiếu

Thống kê tìm khách & chiến dịch

Chỉ số tìm khách (không lọc theo thành viên).

Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.

Chỉ số tìm khách (không lọc theo thành viên).

Thông tin

Tên	Giá trị
Mã	`stats.gtm`
Scope cần	`stats.read`
Mức	Chỉ đọc
Có thể cần xác nhận	Không
Kiểu chạy	Trả kết quả ngay
Cần `Idempotency-Key`	Không
Vai trò thành viên được phép	`owner`, `manager`, `agent`, `viewer`
Trong app	Thống kê → Tìm khách

Trường vào

Trường	Kiểu	Bắt buộc
`preset`	`"today" \| "7d" \| "30d" \| "90d" \| "custom"`	Có
`from`	`chữ`	Không
`to`	`chữ`	Không
`account`	`uuid`	Không
`member`	`uuid`	Không

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/stats.gtm \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"preset":"today"}'

Trường ra (`data`)

Trường	Kiểu	Bắt buộc
`range`	`đối tượng`	Có
`m`	`đối tượng`	Có

Ví dụ trả về

{
  "data": {
    "range": {
      "from": "text",
      "to": "text",
      "days": [
        "text"
      ],
      "tz": "text"
    },
    "m": {
      "tz": "text",
      "found": 1,
      "new_listed": 1,
      "found_by_source": [
        {
          "source": "text",
          "n": 1,
          "listed": 1
        }
      ],
      "found_by_group": [
        {
          "group_id": "00000000-0000-4000-8000-000000000000",
          "title": "text",
          "n": 1,
          "saved": 1
        }
      ],
      "messaged": 1,
      "messaged_unverified": 1,
      "replied": 1,
      "by_campaign": [
        {
          "campaign_id": "00000000-0000-4000-8000-000000000000",
          "name": "text",
          "sent": 1,
          "replied": 1
        }
      ],
      "by_account": [
        {
          "account_id": "00000000-0000-4000-8000-000000000000",
          "sent": 1,
          "replied": 1
        }
      ],
      "by_variant": [
        {
          "campaign_id": "00000000-0000-4000-8000-000000000000",
          "name": "text",
          "block_id": "00000000-0000-4000-8000-000000000000",
          "variant": 1,
          "sent": 1,
          "replied": 1
        }
      ],
      "funnel": [
        {
          "stage_id": "00000000-0000-4000-8000-000000000000",
          "name": "text",
          "color": "text",
          "kind": "open",
          "system_key": "text",
          "n": 1
        }
      ],
      "stage_moves": [
        {
          "stage_id": "00000000-0000-4000-8000-000000000000",
          "n": 1
        }
      ],
      "signals": {
        "new": 1,
        "saved": 1
      },
      "daily": [
        {
          "day": "text",
          "sent": 1,
          "replied": 1
        }
      ]
    }
  }
}

Dùng qua MCP

Tool stats_gtm có tên sẵn trong profile: Báo cáo (reports). Ở profile khác, tìm bằng tools_search rồi chạy bằng tools_run.

Thống kê tìm khách & chiến dịch

#Thông tin

#Trường vào

#Ví dụ gọi

#Trường ra (data)