Zalo Auto
Danh mục thao tác

Tìm sticker

inbox.sticker.searchMCP:inbox_sticker_searchBộ công cụ: Hội thoại

Search Zalo stickers by keyword through the conversation's account (max 30). Use the result in inbox_message_send kind=sticker.

Chỉ đọc
Xếp hàng theo hạn mức của tài khoản
Quyền: Đọc
Quyền: Nhắn tin

Gọi bằng REST v2

curl -X POST https://zl.builera.app/api/public/v2/ops/inbox.sticker.search \
  -H "Authorization: Bearer za_live_…" \
  -H "Content-Type: application/json" \
  -d '{"conversationId":"3f2b8c1e-5d4a-4e6b-9c7d-1a2b3c4d5e6f","keyword":"bảng giá"}'

Mỗi khoá/kết nối tối đa 300 lệnh đọc và 60 lệnh ghi mỗi phút. Gọi lại cùng Idempotency-Key trả đúng kết quả cũ, không làm lại.

Gọi qua MCP

{
  "method": "tools/call",
  "params": {
    "name": "inbox_sticker_search",
    "arguments": {
      "conversationId": "3f2b8c1e-5d4a-4e6b-9c7d-1a2b3c4d5e6f",
      "keyword": "bảng giá"
    }
  }
}

Thêm https://zl.builera.app/mcp vào ứng dụng AI rồi cho phép kết nối; AI chỉ thấy công cụ trong bộ bạn chọn.

Kết quả

HTTP 202
{ "status": "accepted", "operationId": "…", "jobId": "…", "data": { … } }

→ operations.wait (tối đa 20 giây) hoặc webhook để biết kết quả trên Zalo

Ví dụ đầu vào

{
  "conversationId": "3f2b8c1e-5d4a-4e6b-9c7d-1a2b3c4d5e6f",
  "keyword": "bảng giá"
}

Thay mã (id) mẫu bằng mã thật lấy từ các thao tác liệt kê/tìm kiếm.

Lược đồ đầu vào (JSON Schema)

{
  "type": "object",
  "properties": {
    "conversationId": {
      "type": "string",
      "format": "uuid"
    },
    "keyword": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    }
  },
  "required": [
    "conversationId",
    "keyword"
  ],
  "additionalProperties": false
}

Cùng bộ công cụ

Mở hội thoại với kháchTin nhắn mới theo số điện thoạiGửi tin nhắnTải tệp để gửiXác nhận đã tải tệpGửi lại tin lỗiBỏ qua tin lỗi để gửi tiếpTin hẹn giờ