ailan / bot

Đăng nhập

Nhập mã quản trị để quản lý bot cá nhân của bạn.

Mã quản trị là giá trị ADMIN_TOKEN: nằm trong .dev.vars khi chạy trên máy, hoặc là secret bạn đã đặt trên Cloudflare.

Hội thoại

Tin nhắn giữa bạn và bot.

Tệp

Tệp nhận qua bot và tệp đã gửi về Telegram của bạn.

Kéo thả tệp vào đây để gửi về Telegram của bạn
hoặc · tối đa 50 MB

Cài đặt

Mỗi mục được lưu riêng.

Trả lời tự động

Bot dùng Workers AI để trả lời bạn và những người được phép.

Bật / tắt

Áp dụng cho mọi cuộc trò chuyện.

Mô hình

Model nhỏ trả lời nhanh và rẻ hơn; model lớn trả lời tự nhiên hơn.

Chọn trong danh sách hoặc nhập tên model khác.

Kịch bản

Hướng dẫn hệ thống gửi kèm mọi tin nhắn: vai trò, giọng điệu, những gì bot nên làm.

Bot đọc 12 tin gần nhất của cuộc trò chuyện cùng với kịch bản này.

Quyền truy cập

Bạn luôn dùng được bot. Người khác phải gửi /connect để vào hàng chờ và được bạn chấp nhận; trước đó mọi tin nhắn của họ bị bỏ qua.

Yêu cầu mới

Lưu ngay khi bật/tắt.

Hàng chờ

Người vừa gửi /connect. Bạn cũng nhận một tin báo trên Telegram.

Được phép

Nhắn tin được với bot; bot trả lời họ bằng cùng kịch bản.

Đã chặn

Bot bỏ qua mọi tin nhắn của họ, kể cả /connect.

Kết nối Telegram

Trạng thái bot và webhook do Telegram báo về. Các khóa bí mật được đặt ngoài trang này — xem Hướng dẫn.

Trạng thái

Đọc trực tiếp từ Telegram mỗi lần mở mục này.

Phiên đăng nhập

Mã quản trị đang lưu trong trình duyệt này.

Đăng xuất

Xoá mã khỏi trình duyệt. Muốn đổi mã cho mọi thiết bị, đặt lại ADMIN_TOKEN.

Hướng dẫn cấu hình

Các bước dựng bot từ đầu. Mục kiểm tra đọc trạng thái thật của Worker này.

  1. Tạo bot Telegram

    Mở @BotFather, gửi /newbot và đặt tên. BotFather trả về một token dạng 123456:ABC… — đó là BOT_TOKEN.

  2. Lấy ID Telegram của bạn

    Nhắn bất kỳ cho @userinfobot; số Id nó trả về là OWNER_CHAT_ID. Chỉ tài khoản này dùng được bot mà không cần duyệt.

  3. Tạo hai chuỗi bí mật

    ADMIN_TOKEN là mã đăng nhập trang này và là bot_token của app. WEBHOOK_SECRET để Telegram chứng minh tin đến từ nó. Chuỗi được tạo ngay trong trình duyệt, không gửi đi đâu.

    —
  4. Chạy trên máy

    Tạo file worker/.dev.vars với bốn giá trị trên:

    Rồi chạy:

    cd worker
    pnpm install
    pnpm db:local
    pnpm dev

    Telegram không gửi tin về máy bạn, nên khi chạy local chỉ thử được trang này và việc gửi tin/tệp ra Telegram.

  5. Đưa lên Cloudflare

    Chạy lần lượt. Lệnh d1 create in ra database_id — dán vào wrangler.toml. Mỗi lệnh secret put sẽ hỏi giá trị.

    pnpm wrangler login
    pnpm wrangler d1 create ailan-bot
    pnpm wrangler r2 bucket create ailan-bot-files
    pnpm db:remote
    pnpm wrangler secret put BOT_TOKEN
    pnpm wrangler secret put OWNER_CHAT_ID
    pnpm wrangler secret put ADMIN_TOKEN
    pnpm wrangler secret put WEBHOOK_SECRET
    pnpm run deploy

    Dùng pnpm run deploy, không phải pnpm deploy (lệnh có sẵn của pnpm). Sau mỗi lần cập nhật code có đổi schema.sql, chạy lại pnpm db:remote trước khi deploy.

  6. Đăng ký webhook

    Thay hai giá trị trong ngoặc nhọn rồi chạy một lần.

  7. Nối với app ailan trên máy

    Thêm vào settings.toml của app rồi khởi động lại app. Tin bạn nhắn cho bot sẽ hiện thành thông báo trên island; kéo tệp vào island để gửi về Telegram.

  8. Cho người khác kết nối (tuỳ chọn)

    Gửi họ link t.me/<tên-bot>?start=connect hoặc bảo họ nhắn /connect cho bot. Yêu cầu hiện ở Cài đặt → Quyền truy cập để bạn chấp nhận hoặc chặn.

Có thay đổi chưa lưu