list_customer_groups
Retrieve a list of customer groups, optionally filtered by name, to review segmentation strategies or obtain group IDs for member queries.
Instructions
取得客戶群組列表,支援依名稱搜尋。
【用途】 瀏覽或搜尋已建立的客戶群組(分群)。可用於確認客戶標籤分群策略、 取得群組 ID 後進一步查詢群組成員。
【呼叫的 Shopline API】
GET /v1/customer_groups(無搜尋條件時)
GET /v1/customer_groups/search(有搜尋條件時)
【回傳結構】 dict 含 total_found, returned, groups[]。 每個 group 包含 id, name, customers_count, created_at。
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_customer_groups"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max_results | No | 最多回傳筆數 | |
| search_keyword | No | 群組名稱搜尋關鍵字 |