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
Tác tử AIBot trả lời tin nhắn và nhận cả cuộc gọi — cùng một bot trên máy tính, điện thoại và Apple Watch. Kể cả dữ liệu đi về đâu (đang chuẩn bị).Bắt đầu
Sử dụng ứng dụngĐăng ký, trò chuyện, thông báo, 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
Bot thoại — bot nhận cuộc gọiGọi cho bot thì mô hình giọng nói AI trả lời. Chỉ dẫn, giọng nói, công cụ, MCP, chế độ âm thanh gốc (đang chuẩn bị).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ả thông báo đẩy Android, 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.Tạo 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 yêu cầu 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 |
| Điện thoại không nhận được thông báo | Sử dụng ứng dụng — Thông báo |
| Có thể làm gì với tác tử AI | Tác tử AI |
| 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 tạo bot nhận cuộc gọi | Bot thoại |
| Âm thanh cuộc gọi với bot đi về đâu | Tác tử AI — Dữ liệu đi về đâu |
| 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 |
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. Các ví dụ bot thoại được kiểm tra theo cùng cách ngày 2026-09-27 trên máy chủ thử nghiệm với gateway thử nghiệm. Những tính năng Pabal chưa hỗ trợ được ghi chú riêng trong từng tài liệu.