Chỉ đọcHồ sơ: Lõi (luôn có)Quyền: Khách hàng · đọc
Search contacts, conversations, groups, campaigns and numbers by name, phone or text in one call. Use it to find ids before acting.
Không thay đổi gì.
REST
GET
/api/public/v2/searchMCP
quick_searchCùng tên trên cổng đăng nhập /mcp và cổng khoá /api/public/mcp.
Tham số
| Tên | Ở đâu | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|---|
q | query | string | Bắt buộc | Tối đa 100 ký tự. |
Không gửi workspaceId: luôn lấy từ khoá hoặc kết nối AI.
curl -X GET "https://<ten-mien-cua-ban>/api/public/v2/search?q=%E2%80%A6" \
-H "Authorization: Bearer $WA_AUTO_KEY"Phản hồi (200)
{
"…": "dữ liệu của thao tác"
}Lỗi có thể gặp
| HTTP | code | Ý nghĩa |
|---|---|---|
| 401 | unauthorized | Thiếu khoá/đăng nhập, hoặc khoá không đúng. |
| 403 | permission_denied | Khoá/kết nối không có quyền này, hoặc vai trò của người tạo không đủ. |
| 422 | validation_failed | Dữ liệu gửi lên sai kiểu hoặc thiếu trường — xem `violations`. |
| 429 | rate_limited | Quá 60 yêu cầu/phút cho một khoá hoặc kết nối — đợi theo Retry-After. |
| 503 | paused | API/MCP đang tạm dừng (nút ngắt khẩn của workspace hoặc đội vận hành). |
Lỗi theo RFC 9457 (application/problem+json). Xem mọi mã lỗi.
# MCP (JSON-RPC) — tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "quick_search",
"arguments": {
"q": "…"
}
}
}