|
|
| Tạo Contact API trên Cloudflare Worker và Telegram API |
Bạn có một trang tĩnh, không có backend, nhưng vẫn muốn có form liên hệ để khách để lại lời nhắn? Cách nhanh mà tôi hay dùng là bắn thẳng nội dung form vào một nhóm Telegram, nhờ Cloudflare Worker làm cầu nối. Trong bài này tôi sẽ hướng dẫn bạn dựng một Contact API kiểu này từ đầu tới cuối, hoàn toàn miễn phí.
Cloudflare Worker và Telegram Bot API là gì
Cloudflare Worker là một hàm serverless chạy trên mạng biên (edge) của Cloudflare: bạn viết vài chục dòng JavaScript, deploy, Cloudflare lo phần máy chủ, có gói miễn phí đủ dùng cho các dự án cá nhân. Telegram Bot API là tập REST API cho phép một chương trình gửi/nhận tin nhắn thay cho một Bot Telegram, trong đó endpoint sendMessage dùng để gửi tin nhắn tới một chat (nhóm, kênh hoặc cá nhân) cụ thể.
Vì sao cần Cloudflare Worker làm lớp trung gian
Nhìn tiêu đề, có thể bạn sẽ hỏi: sao không gọi thẳng Telegram API từ frontend cho gọn, cần gì phải qua Cloudflare Worker?
Vấn đề là để gọi được API của Telegram, bạn cần Bot Token (mã định danh bí mật của bot) và Chat ID. Bot Token giống như chìa khoá vạn năng: ai có nó cũng có thể mạo danh bot của bạn để gửi tin nhắn tuỳ ý. Nếu bạn nhúng thẳng Bot Token vào code JavaScript chạy trên trình duyệt, bất kỳ ai mở DevTools cũng đọc được nó ngay.
Cloudflare Worker giải quyết việc đó bằng cách đóng vai một lễ tân trung gian: trình duyệt chỉ gửi nội dung form tới Worker, Worker giữ Bot Token trong biến môi trường (không lộ ra ngoài) rồi mới gọi Telegram API thay bạn.
Cách hoạt động
Khi bạn bấm gửi trên form, trình duyệt gọi (POST) tới URL của Worker kèm tên, email, nội dung. Worker kiểm tra dữ liệu hợp lệ, ghép thành một tin nhắn định dạng HTML, rồi gọi endpoint sendMessage của Telegram Bot API bằng Bot Token đang giữ trong biến môi trường. Telegram gửi tin vào group/channel bạn đã cấu hình và trả kết quả về, Worker trả tiếp cho trình duyệt biết là thành công hay thất bại.
Điều kiện cần thiết
Trước khi bắt đầu, bạn cần chuẩn bị:
- Tài khoản Cloudflare
- Tài khoản Telegram
- Telegram Bot
- Chat ID của nhóm hoặc kênh Telegram
Bắt đầu thực hiện
Tạo Telegram Bot
- Liên hệ @BotFather trên Telegram.
- Dùng lệnh
/newbotđể tạo bot mới. - Đặt tên và username cho bot.
- BotFather sẽ trả về một API Token, lưu lại giá trị này (bạn sẽ dùng làm
API_TOKENở bước tạo Worker).
Tạo Telegram Group
Để bot có thể gửi tin nhắn, bạn cần:
- Tạo Telegram Group hoặc Telegram Channel.
- Thêm Bot vào trong Group / Channel.
- Gửi một tin nhắn bất kỳ trong group/channel và tag (@) bot của bạn vào đó.
- Lấy Chat ID bằng API Token: mở trình duyệt, truy cập đường link sau (thay
<YourBOTToken>bằng Token bạn vừa lưu):https://api.telegram.org/bot<YourBOTToken>/getUpdates. Trongchatobject của kết quả trả về, bạn sẽ thấy trường "id" - đó chính làChat IDbạn cần. - Nếu
resulttrả về rỗng, dạng{"ok":true,"result":[]}, nghĩa là Telegram chưa ghi nhận tin nhắn nào tag bot. Hãy xoá bot khỏi group/channel, thêm lại từ bước 2, gửi một tin nhắn mới tag bot, rồi thử lại linkgetUpdates.
Tạo Cloudflare Worker
- Truy cập Dashboard của Cloudflare và tạo Worker mới.
- Đặt tên cho Worker và Deploy.
- Mở phần chỉnh sửa code của Worker.
- Dán đoạn code sau và Deploy.
Lưu ý: So với bản gốc hay gặp trên mạng, tôi có sửa vài chỗ: dùng thẳng
env.CHAT_ID/env.API_TOKEN(không lồng qua objectTELEGRAM- Worker không tự gộp biến môi trường thành object như vậy); chuẩn hoá kết quả trả về thành{success: true/false}để khớp với form thử nghiệm bên dưới; thêm CORS header cho cả response thành công (bản gốc chỉ có ở preflight, nên gọi từ trình duyệt khác domain sẽ bị chặn); và escape ký tự đặc biệt trong nội dung người dùng gửi lên, vì Telegram từ chối cả tin nhắn nếu chuỗi HTML không hợp lệ.export default { async fetch(request, env) { const url = new URL(request.url); const path = url.pathname; const corsHeaders = { 'Access-Control-Allow-Origin': '*', 'Access-Control-Allow-Methods': 'POST,OPTIONS', 'Access-Control-Allow-Headers': 'Content-Type' }; if (request.method === 'OPTIONS') { return new Response(null, { headers: corsHeaders }); } if (request.method === 'POST' && path === '/api/contact') { try { const body = await request.json(); if (!body.email || !body.message) { return new Response(JSON.stringify({ success: false, error: 'Request body invalid' }), { status: 400, headers: { 'Content-Type': 'application/json', ...corsHeaders } }); } function escapeHtml(str) { str = str || ''; return str .replace(/&/g, '&') .replace(/</g, '<') .replace(/>/g, '>'); } const text = `<b>📬 CONTACT - Tin nhắn mới</b> <b>👤 Name:</b> ${escapeHtml(body.name) || 'Anonymous'} <b>📧 Email:</b> ${escapeHtml(body.email)} <b>📝 Subject:</b> ${escapeHtml(body.subject) || ''} <b>💬 Message:</b> ${escapeHtml(body.message)}`; const payload = { chat_id: env.CHAT_ID, parse_mode: 'HTML', text: text }; const telegramApi = `https://api.telegram.org/bot${env.API_TOKEN}/sendMessage`; const tgResponse = await fetch(telegramApi, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(payload) }); const tgResult = await tgResponse.json(); return new Response(JSON.stringify({ success: tgResult.ok, error: tgResult.ok ? null : tgResult.description }), { status: tgResult.ok ? 200 : 502, headers: { 'Content-Type': 'application/json', ...corsHeaders } }); } catch (error) { return new Response(JSON.stringify({ success: false, error: error.message }), { status: 500, headers: { 'Content-Type': 'application/json', ...corsHeaders } }); } } return new Response('Forbidden', { status: 403, headers: { 'Content-Type': 'text/plain' } }); } } - Tạo biến môi trường cho Worker: vào phần Settings, mục Variables and Secrets, thêm hai biến
CHAT_IDvàAPI_TOKENvới giá trị đã lưu ở các bước trên. Nên đánh dấuAPI_TOKENlà Secret (mã hoá) thay vì Text thường, để giá trị không hiển thị dạng plain text trên dashboard. Sau đó Deploy lại.
Thực hiện test
Bạn có thể dùng một trong ba cách sau để test API vừa deploy.
Cách 1: Dùng form thử nghiệm ngay trong bài
Điền URL Worker của bạn (dạng https://your-worker.workers.dev/api/contact) rồi gửi thử. Form này gọi thẳng tới Worker bạn vừa deploy, không đi qua máy chủ nào của Nocoem.
Cách 2: Dùng curl
Thay location bằng URL Worker của bạn.
curl --location 'https://your-worker.workers.dev/api/contact' \
--header 'Content-Type: application/json' \
--data-raw '{"name": "NOCOEM", "email": "nocoem@example.com", "message": "Have a nice day!"}'
Cách 3: Tải file HTML mẫu về chạy local
- Tải file mẫu bên dưới về máy.
contact.html 4.3KB
- Mở file vừa tải bằng trình duyệt.
- Điền URL Worker và các thông tin còn lại, rồi bấm gửi.
- Đừng lồng biến môi trường qua object như
env.TELEGRAM.CHAT_ID. Worker chỉ cấp đúng những biến bạn khai báo trên dashboard (ở đây làenv.CHAT_ID,env.API_TOKEN), không tự gộp thành object lồng nhau. Đây là lỗi khiến bản Worker gốc chạy sai mà không báo lỗi rõ ràng (env.TELEGRAM là undefined nên request luôn crash ở bước đọc CHAT_ID). - Với
parse_mode: 'HTML', Telegram yêu cầu escape các ký tự<,>,&trong nội dung do người dùng nhập. Nếu bỏ qua bước này, một tin nhắn chứa dấu<lạ có thể khiến Telegram từ chối gửi cả tin nhắn. - Endpoint
/api/contacttrong bài đang mở công khai, không có xác thực - ai có URL cũng gửi được tin nhắn qua bot của bạn. Nếu lo bị spam, cân nhắc thêm captcha (ví dụ Cloudflare Turnstile) hoặc giới hạn tần suất (rate limit) ở tầng Worker. - Telegram có giới hạn tốc độ gửi tin nhắn: theo FAQ chính thức của Telegram Bot API, một bot không nên gửi quá khoảng 1 tin/giây tới cùng một chat, và khoảng 30 tin/giây tính tổng thể trên nhiều chat khác nhau. Nếu app của bạn có lượng traffic lớn, đừng dùng cách này làm kênh nhận thông báo chính.
Tóm tắt
- Cloudflare Worker đóng vai trò trung gian, giữ Bot Token an toàn thay vì để lộ trên frontend.
- Luồng hoạt động: trình duyệt gửi form tới Worker, Worker gọi Telegram Bot API, Telegram trả kết quả ngược lại.
- Đặt tên biến môi trường đúng (
CHAT_ID,API_TOKEN), đánh dấu Secret cho Token, và escape nội dung người dùng trước khi gửi ở chế độ HTML. - Đây chỉ là một ví dụ đơn giản, bạn có thể mở rộng thêm xác thực, rate limit, hay validate dữ liệu kỹ hơn tuỳ nhu cầu thực tế.
- Kai