🤖 Agent-Ready Discovery System

Tài Liệu API & MCP Server ZChat

ZChat cung cấp hệ sinh thái API RESTful tốc độ cao cùng giao thức Model Context Protocol (MCP) cho phép các hệ thống AI Agent (Claude, ChatGPT, LangChain, AutoGen) tự động khám phá, kết nối và điều khiển đa tài khoản Zalo an toàn.

RFC 9727

API Catalog

/.well-known/api-catalog

SEP-1649

MCP Server Card

/.well-known/mcp/server-card.json

1Model Context Protocol (MCP) Server

ZChat vận hành MCP Server qua Streamable HTTP endpoint tại https://api.zachat.vn/mcp. AI Agents có thể đọc danh sách session Zalo, gửi tin nhắn, tạo chiến dịch broadcast và gắn thẻ khách hàng CRM.

// Cấu hình MCP Client (Claude Desktop / Cursor / Antigravity)
{
  "mcpServers": {
    "zchat": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch", "https://api.zachat.vn/mcp"],
      "env": {
        "ZCHAT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

2Xác Thực & Cấp Quyền (OAuth 2.0 / API Keys)

Mọi request vào API Gateway yêu cầu xác thực bằng Bearer token hoặc Header API Key:

# Gửi qua Header Authorization

Authorization: Bearer <ACCESS_TOKEN>

# Hoặc gửi qua Header X-API-Key

X-API-Key: <YOUR_API_KEY>

3Các API Endpoints Tiêu Biểu

GET/health

Kiểm tra trạng thái uptime của cụm Gateway và Redis.

POST/api/auth/token

Lấy token truy cập theo chuẩn OAuth 2.0 client_credentials.

GET/api/zalo/sessions

Lấy danh sách các nick Zalo đang trực tuyến và trạng thái kết nối.

POST/api/broadcast

Gửi tin nhắn hàng loạt có thuật toán giãn cách thông minh chống khóa nick.

4Hỗ Trợ WebMCP (Browser Agent Tools)

Khi duyệt trang web ZChat trên trình duyệt của agent, hệ thống tự động phơi mở các công cụ tương tác qua document.modelContext.registerTool():

search_blog: Tra cứu bài viết kiến thức quản lý đa nick và mẹo gửi tin không khóa nick.
get_pricing_plans: Lấy báo giá chi tiết và tính năng các gói Pro, Business, Enterprise.
get_app_download_info: Lấy link tải bộ cài ZChat cho máy tính và di động.
request_consultation: Gửi form đăng ký trải nghiệm 7 ngày miễn phí.