Bot Telegram của app
Khoảng 15 phút. Làm xong, quản lý nhận tin báo đơn mới qua Telegram và bấm nút Duyệt ngay trong tin nhắn.
Tin đi ra mang tên bot của chủ app, không mang tên manh.run. App nhận tin nhắn và lượt bấm nút trong một file *.telegram.ts, gửi tin kèm nút bằng manh/telegram.
Chủ app kết nối bot
Tạo bot bằng @BotFather trong Telegram, rồi dán token vào Cài đặt › Telegram của project. Token nằm ở manh.run, code của app và agent không thấy nó. Không bao giờ viết token vào code: check báo code.telegram-token-literal.
Người dùng liên kết tài khoản
Bot chỉ nhắn được cho người đã bấm Start. Thêm cột telegramChatId: text("telegram_chat_id") (cho phép null) vào bảng users, rồi cấp cho mỗi người một link riêng bằng linkUrl(userId):
import { linkUrl } from "manh/telegram";
export default async (c, { user }) => ({ url: await linkUrl(user.id) }); // https://t.me/<bot>?start=…Trang hiện một nút mở link đó, ví dụ Nhận thông báo qua Telegram. Link có chữ ký, nên không ai nhận được tài khoản của người khác.
Nhận tin và lượt bấm nút
Mỗi app có đúng một file *.telegram.ts. Hàm mặc định nhận sự kiện { kind, chatId, from, text, data, userId }; chuỗi trả về được gửi lại vào chat.
import { send } from "manh/telegram";
import { saveTelegramChat } from "../users/repository";
import { approveOrder } from "../orders/repository";
export default async function (e) {
if (e.kind === "link") { // người dùng bấm Start trên linkUrl(userId)
await saveTelegramChat(e.userId, String(e.chatId));
return "Đã bật thông báo Telegram cho tài khoản của bạn.";
}
if (e.kind === "button") { // e.data = data của nút vừa bấm
const [action, id] = e.data.split(":");
if (action === "approve") {
await approveOrder(Number(id), String(e.chatId));
await send(e.chatId, `Đã duyệt đơn #${id}`);
}
return;
}
if (e.text === "/don") return "Gõ số đơn để xem trạng thái."; // kind = "message"
}Gửi tin kèm nút
Gửi sau khi đã ghi database, trong try/catch: tin báo không được làm hỏng việc chính.
import { send } from "manh/telegram";
import { env } from "manh/env";
export async function notifyManager(o: Order, chatId: string) {
try {
await send(chatId, `Đơn #${o.id}: ${o.total.toLocaleString("vi-VN")} đ chờ duyệt`, {
buttons: [
[{ text: "Duyệt", data: `approve:${o.id}` }, { text: "Từ chối", data: `reject:${o.id}` }],
[{ text: "Xem đơn", url: `${env.MANH_APP_URL}/orders/${o.id}` }],
],
});
} catch (err: any) {
if (err.blocked) await clearTelegramChat(chatId); // người dùng đã chặn bot
}
}Cần biết
- Lượt bấm nút không có người dùng trong request và không đi qua
access. Tra người bấm theochatIdđã lưu và kiểm vai trong repository trước khi duyệt. - Telegram có thể gửi lại một sự kiện. Handler chạy một lần cho mỗi sự kiện, nhưng lệnh ghi vẫn nên viết sao cho chạy hai lần cũng không duyệt hai lần.
- Handler phải xong nhanh (dưới khoảng 30 giây). Việc chậm đẩy sang job nền
manh/jobs. datacủa nút tối đa 64 ký tự. Telegram giới hạn khoảng 30 tin mỗi giây cho một bot và 1 tin mỗi giây cho một chat;sendtự chờ rồi gửi lại.edit(chatId, messageId, text)sửa tin đã gửi, ví dụ đổi thành “Đơn #12 đã duyệt” sau khi bấm.
Bước tiếp theo
- Việc chạy định kỳ — gửi tin nhắc việc mỗi sáng mà không ai phải bấm.
- std/telegram —
send,edit,answerButton,linkUrlvà mọi tuỳ chọn. - *.telegram.ts — kiểu đầy đủ của sự kiện.