👑 bonz-sdk v1.4.0

SDK Zalo Client customized, thiết kế tối giản, hiệu năng cao và tối ưu tuyệt đối cho lập trình đa ngôn ngữ (JavaScript, TypeScript, Python, Golang).

🚀 Tính năng nổi bật

• Đăng nhập QR & Cookie thông minh: Tự động hiển thị mã QR trực tiếp trong Console/Terminal và lưu trữ cookie tự động.
• Chuẩn hóa Event & Context: Event listener dạng EventEmitter mạnh mẽ, tự động chuẩn hóa data Zalo thành các hàm helper tiếng Việt / tiếng Anh trực quan (reply / guiTin, react / thaIcon, replyImage / guiAnh...).
• Bridge đa ngôn ngữ siêu tốc: Tích hợp sẵn một local JSON-RPC server cực nhẹ để các tiến trình con bằng Python hoặc Go gọi API của Bot Zalo dễ dàng.

💻 Cài đặt

npm install bonz-sdk

🛠️ Hướng dẫn sử dụng

1. Khởi tạo Client & Lắng nghe Sự kiện (Node.js)

const { ZaloClient } = require("bonz-sdk");

const client = new ZaloClient({
  selfListen: false,       // Bỏ qua tin nhắn của chính Bot
  showTerminalQR: true,    // In mã QR ra terminal khi đăng nhập
  adminIds: ["123456789"]  // Danh sách UID Admin của Bot
});

async function start() {
  try {
    // Tự động đăng nhập bằng cookie đã lưu, nếu không có sẽ hiển thị QR để quét
    await client.login().catch(() => client.loginQR());
    
    // Lắng nghe tin nhắn
    client.listen(async (ctx) => {
      if (ctx.text === "ping") {
        await ctx.reply("pong!");
      }
      
      if (ctx.text === "info" && ctx.isAdmin()) {
        const name = await ctx.getName();
        await ctx.reply(`Xin chào Admin ${name}!`);
      }
    });
  } catch (err) {
    console.error("Lỗi khởi động:", err);
  }
}

start();

2. Viết tập lệnh Python (Python Bridge)

Khi bạn chạy một script Python từ bot, thư viện cung cấp một bridge bằng Python giúp gọi ngược lại Zalo API.

Cú pháp Python (my_script.py):

from bonz import reply, get_money, format_money

# Gửi tin nhắn phản hồi
reply("Xin chào từ Python script! 🐍")

# Lấy số tiền trong ví của người dùng hiện tại
money = get_money()
reply(f"Số tiền của bạn là: {format_money(money)}")

📁 Cấu trúc thư mục thư viện

bonz-sdk/
├── index.js              # Entrypoint chính
├── index.d.ts            # Khai báo kiểu dữ liệu TypeScript
├── src/
│   ├── ZaloClient.js     # Class xử lý kết nối, login và lưu session
│   ├── ZaloContext.js    # Class đóng gói sự kiện và helper API
│   └── ZaloBridge.js     # JSON-RPC Server phục vụ gọi API đa ngôn ngữ
└── bridge/
    ├── python/
    │   └── bonz.py       # Thư viện Python liên kết IPC
    └── go/
        └── bonz.go       # Thư viện Go liên kết IPC

📄 Bản quyền

Bản quyền thuộc về Bonz VIP © 2026. Phát hành dưới giấy phép MIT. Website: bonzvip.site