mail2telegram: chuyển tiếp email qua Telegram
/mail2telegram
mail2telegram làm một việc duy nhất và làm tốt: chuyển email thành thông báo Telegram mà không cần chạy mail server. Với ai đã sử dụng Cloudflare, setup rất nhanh và free tier đủ cho cá nhân. Nhược điểm là phụ thuộc Cloudflare và không hỗ trợ đính kèm.
mail2telegram là gì
mail2telegram là một Cloudflare Worker nhận email qua Cloudflare Email Routing và đẩy chúng dưới dạng tin nhắn đã định dạng đến Telegram bot. Mỗi email trở thành một tin nhắn Telegram với các nút để xem trước văn bản, xem nội dung đầy đủ trong trình duyệt, hoặc đọc tóm tắt AI. Worker lưu trữ trạng thái hộp thư và quy tắc lọc trong KV namespace mà bạn tự bind.
Tính năng chính của mail2telegram
- ✓Email routing qua Cloudflare Workers — không cần server riêng hoặc phần mềm mail
- ✓Nút inline Telegram: Preview, Summary (AI), Text, và HTML view modes
- ✓Tạo inbox dùng một lần với tiền tố người nhận tùy ý, quản lý qua bot
- ✓Whitelist/blacklist người gửi qua mini-app Telegram tích hợp, không cần chỉnh biến môi trường
- ✓Tóm tắt email bằng AI dùng Workers AI hoặc API key OpenAI tùy chỉnh
- ✓Lưu trữ KV cho trạng thái inbox, quy tắc lọc, và cache email với TTL có thể cấu hình
- ✓Guardian Mode ngăn thông báo trùng lặp từ Worker retries
- ✓Tùy chọn sao lưu email bằng chuyển tiếp đến địa chỉ cá nhân qua FORWARD_LIST
Cách sử dụng thực tế
- •Theo dõi email giao dịch — xác nhận đơn hàng, cập nhật vận chuyển, đặt lại mật khẩu — không cần mở ứng dụng mail đầy đủ
- •Tạo địa chỉ inbox dùng một lần ngay lập tức cho các dịch vụ không tin tưởng hoàn toàn, đọc trực tiếp từ Telegram
- •Tự động hóa email nhẹ: lọc theo regex người gửi và chỉ nhận thông báo bạn quan tâm, bỏ qua phần còn lại
- •Spam triage ngay từ gateway — dùng quy tắc whitelist để tự động chuyển tiếp chỉ người gửi đáng tin cậy và chặn phần còn lại server-side
Deploy mail2telegram lên Cloudflare Workers
Deploy đòi hỏi tài khoản Cloudflare đã bật Email Routing, bot token Telegram từ @BotFather, và namespace KV để bind. Clone repo, copy `wrangler.example.jsonc` thành `wrangler.jsonc` với thông tin xác thực của bạn, rồi chạy `yarn pub`. Sau khi deploy, gọi URL worker tại `/init` để bind webhook Telegram. Gói miễn phí Workers của Cloudflare xử lý được nhu cầu cá nhân vừa phải mà không phát sinh chi phí. Cả deploy qua CLI và đường dẫn copy-paste cho code đã biên dịch đều được ghi chép rõ ràng.
Dùng bot sau khi deploy
Sau khi bind Cloudflare Email Routing để chuyển tiếp tất cả email đến worker, thư đến sẽ kích hoạt tin nhắn Telegram với subject, người gửi, người nhận và bốn nút hành động. Nút Preview hiển thị văn bản thuần túy lên đến 4096 ký tự trực tiếp trong chat. Summary tạo bản tóm tắt ngắn gọn bằng AI dùng Workers AI hoặc OpenAI key của bạn. Text mở trang web cho email dài hơn, còn HTML render email rich-text kèm cảnh báo về tracking scripts. Mini-app Telegram quản lý whitelist và blacklist mà không cần chỉnh biến môi trường. Email hết hạn khỏi cache sau MAIL_TTL giây để bảo mật.
Điểm mạnh
- ✓Chạy trên Cloudflare Workers — không cần bảo trì hạ tầng, gói miễn phí rộng rãi cho sử dụng cá nhân
- ✓Codebase TypeScript dễ đọc, deploy trong vài phút qua wrangler
- ✓Mini-app tích hợp xử lý lọc người gửi mà không cần chỉnh biến môi trường
- ✓Hỗ trợ nhiều ID: một worker có thể thông báo nhiều tài khoản Telegram, hữu ích cho hộp thư chia sẻ
- ✓Giới hạn kích thước email và chính sách cắt ngắn có thể cấu hình để ngăn worker timeout với tin nhắn lớn
- ✓Tóm tắt AI mà không cần API key bắt buộc nếu bind Cloudflare Workers AI
Những hạn chế của mail2telegram
- △Không hỗ trợ đính kèm — README thừa nhận rõ ràng và gợi ý project riêng (testmail-viewer) để chuyển tiếp đính kèm
- △Toàn bộ quy trình phụ thuộc vào độ ổn định của Cloudflare Email Routing và Workers, nên một trong hai dịch vụ gặp sự cố là mất luôn khả năng nhận tin.
- △Guardian Mode tiêu tốn thêm KV writes, có cả tác động chi phí và giới hạn tốc độ khi mở rộng
- △Dùng mini-app Telegram yêu cầu đặt privacy policy công khai qua @BotFather, có thể không phù hợp với môi trường doanh nghiệp
- △Không có chức năng trả lời email gốc nếu không bind Resend và cung cấp API key
Các lựa chọn thay thế cho mail2telegram
Câu hỏi thường gặp
mail2telegram MIT-licensed và miễn phí hoàn toàn. Chi phí duy nhất là Cloudflare Workers, nằm trong gói miễn phí cho hộp thư cá nhân thông thường.
Không. README thừa nhận điều này rõ ràng. Đính kèm phải được chuyển đến dịch vụ riêng như testmail-viewer của chính tác giả qua biến FORWARD_LIST.
Truy cập endpoint /init tại URL worker của bạn — ví dụ: https://project_name.user_name.workers.dev/init. Phản hồi cho biết webhook Telegram đã bind thành công hay chưa.
Guardian Mode theo dõi trạng thái từng thông báo email trong KV storage để phát hiện và ngăn chặn retries. Nó giảm tin nhắn trùng lặp do Worker timeouts, nhưng tăng KV write usage.
Được. Đặt biến môi trường OPENAI_API_KEY và bot sẽ tạo tóm tắt AI mà không cần Cloudflare Workers AI.
Cloudflare Workers có thể retry email timeout, gửi thông báo trùng lặp. mail2telegram có hai biện pháp: email backup trong FORWARD_LIST để lưu server-side, và Guardian Mode tùy chọn theo dõi trạng thái trong KV để ngăn retries cục bộ.
Vấn đề mà nó giải quyết
Nhận thông báo email khi đang di chuyển thường đòi hỏi chạy ứng dụng mail đầy đủ, cấu hình IMAP/SMTP, hoặc trả tiền cho dịch vụ chuyển tiếp. Quy trình email tạm thời còn phức tạp hơn, thường cần dịch vụ bên thứ ba với giới hạn tốc độ hoặc tài khoản để quản lý.
Ai nên thử — và ai nên bỏ qua
Developers đã dùng Cloudflare Pages hoặc Workers và muốn nhận thông báo email qua Telegram mà không cần chạy mail server sẽ thấy setup đáng giá. Đặc biệt hữu ích để theo dõi email giao dịch và tạo địa chỉ dùng một lần ngay lập tức. Nếu cần hỗ trợ đính kèm, kiểm soát lưu trữ dữ liệu nghiêm ngặt, hoặc muốn tránh hoàn toàn vendor lock-in của Cloudflare, hãy tìm nơi khác — hoặc ít nhất dành thời gian để định tuyến đính kèm riêng.
Repo liên quan
Vẫn đang phân vân về mail2telegram?
Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về mail2telegram.