Bắt đầu
Tài liệu nhà phát triển Pabal
Mọi thứ bạn cần để dùng Pabal, xây dựng bot và ứng dụng trên Pabal, và tự vận hành máy chủ Pabal.
Bắt đầu
Giới thiệu PabalPabal là gì, được xây dựng ra sao, những gì đã chạy được và những gì chưa.Bắt đầu
Sử dụng ứng dụngĐăng ký, trò chuyện, nhóm, ảnh, bot, liên kết — hướng dẫn cho người mới dùng ứng dụng.Phát triển bot
Tạo bot — hướng dẫnTạo bot bằng @BotFather rồi lần lượt làm việc với tin nhắn, nút bấm, lệnh, ảnh và nhóm.Phát triển bot
Nhận qua webhookCách nhận tin mới ngay tại địa chỉ HTTPS của bot. Xác minh, gửi lại và trả lời ngay trong phản hồi.Phát triển bot
Tham chiếu Bot APIĐầy đủ phương thức, đối tượng và lỗi. Dùng thư viện Telegram Bot API chỉ bằng cách đổi địa chỉ.Pabal API
Pabal API — MTProtoKhi xây dựng client kết nối giống như ứng dụng: thông tin kết nối, khóa công khai, xác thực, update.Vận hành máy chủ
Cài đặt máy chủMáy chủ, PostgreSQL và HTTPS trong một lần với Docker Compose. Kèm cả sao lưu và cập nhật.Vận hành máy chủ
Quản trị và cấu hìnhTrang quản trị, gửi mã đăng ký (SMS, email) và toàn bộ danh sách giá trị cấu hình.Một con bot trong 3 phút
Trong ứng dụng Pabal, gửi /newbot cho @BotFather để tạo bot, bạn sẽ nhận được token. Bạn có thể gửi request ngay bằng token đó.
# Điền token bạn đã nhận
TOKEN='100003:AbCdEf…'
# Thông tin bot
curl -s "https://pabal.me/bot$TOKEN/getMe"
# Sau khi gửi cho bot một tin bất kỳ từ ứng dụng: lấy tin mới (chờ tối đa 30 giây)
curl -s "https://pabal.me/bot$TOKEN/getUpdates?timeout=30"Từ đây, hãy tiếp tục với hướng dẫn tạo bot. Nếu bạn đã có bot viết cho Telegram, chỉ cần đổi địa chỉ từ https://api.telegram.org sang https://pabal.me.
Nên đọc tài liệu nào
| Việc bạn muốn làm | Tài liệu |
|---|---|
| Lần đầu nghe đến Pabal | Giới thiệu Pabal |
| Muốn trò chuyện bằng ứng dụng | Sử dụng ứng dụng |
| Muốn tạo bot thông báo hoặc bot trợ lý | Tạo bot → Webhook |
| Muốn chạy bot Telegram đang dùng trên cả Pabal | Kết nối thư viện, Khác biệt so với Telegram |
| Muốn biết tham số của một phương thức | Tham chiếu Bot API |
| Muốn xây dựng chương trình (client) kết nối bằng tài khoản người dùng | Pabal API — MTProto |
| Muốn tự vận hành máy chủ Pabal cho tổ chức của mình | Cài đặt máy chủ → Quản trị và cấu hình |
Tổng quan các địa chỉ
| Cái gì | Địa chỉ | Dùng ở đâu |
|---|---|---|
| Trang web, liên kết | https://pabal.me/ | Trình duyệt, liên kết pabal.me/tên-người-dùng |
| Bot API | https://pabal.me/bot<token>/<phương-thức> | Chương trình bot (HTTPS) |
| Tệp Bot API | https://pabal.me/file/bot<token>/<file_path> | Tải xuống ảnh mà bot đã nhận |
| MTProto | 122.34.175.215:8443 | Ứng dụng Pabal, client MTProto, bot MTProto |
| Khóa công khai của máy chủ | https://pabal.me/docs/server-key.pem | Khóa mà client MTProto nhúng sẵn bên trong |
Mọi ví dụ trong tài liệu này đều đã được chạy thử thật
Các lệnh và mã đã được chạy và kiểm tra trên máy chủ Pabal ngày 2026-09-19 với python-telegram-bot 22.8, aiogram 3.31, Telethon 1.42 và curl. Những tính năng Pabal chưa hỗ trợ được ghi chú riêng trong từng tài liệu.