zalo-bot-jsCổng tài liệu tiếng Việt

Bắt đầu nhanh với bot Zalo trên Node.js, tra cứu từng hàm của SDK, triển khai webhook, chạy polling và nối workflow thực tế.

Bắt đầu nhanh

API Reference

Xem tiếng Anh

Tạo bot

Quét mã QR, mở trang quản lý bot, tạo bot mới và lấy token trước khi cấu hình `.env`.

Thiết lập bot

Cài đặt, tạo `.env`, kiểm tra token và chạy bot đầu tiên bằng polling.

Tra cứu API

Mỗi hàm chính của `Bot`, helper trên `Message`, webhook APIs và polling runtime đều có trang riêng.

Gửi dữ liệu

Dùng `sendMessage`, `sendPhoto`, `sendSticker` và `sendChatAction` cho các flow phản hồi thực tế.

Event và update

Hiểu cách `on`, `onText`, `processUpdate` và `startPolling` vận hành trong SDK.

Handler-based API

Tổ chức bot bằng `ApplicationBuilder`, `Application`, `CommandHandler`, `MessageHandler` và `filters`.

Tích hợp thực tế

Kết nối bot với webhook production, n8n và các workflow automation nhiều bước.

Giới thiệu

Tài liệu này dành cho nhà phát triển muốn xây dựng bot trên nền tảng Zalo bằng zalo-bot-js, một SDK TypeScript cho Node.js với các thành phần thực dụng như polling, webhook helpers, event listeners và các phương thức gửi tin nhắn cơ bản.

Thông qua bộ tài liệu này, bạn có thể nhanh chóng thiết lập bot, xác thực token, chạy thử các flow nhận và phản hồi tin nhắn, đồng thời nắm được kiến trúc hiện tại của SDK để mở rộng theo nhu cầu riêng.

Bắt đầu từ đâu

Nếu bạn mới vào tài liệu lần đầu, hãy đi theo thứ tự sau:

Bắt đầu nhanh để cấu hình môi trường và chạy bot đầu tiên.
API Reference để tra cứu toàn bộ hàm chính của SDK.
Ví dụ và test để chọn giữa polling, webhook và các script kiểm tra.
Tích hợp với n8n nếu bạn muốn nối bot vào workflow tự động hóa.

Các nhóm nội dung nổi bật

Bắt đầu và xác thực bot: cài đặt, .env, kiểm tra token, chạy polling
API vận hành: getMe, getUpdates, processUpdate, startPolling
API gửi dữ liệu: sendMessage, sendPhoto, sendSticker, sendChatAction
Tích hợp thực tế: webhook, n8n, luồng automation và API nội bộ

Kế tiếp

Bắt đầu với Bắt đầu nhanh.

Cập nhật lần cuối: 05/04/2026