👋 Chào mừng đến với Nocoem — kiến thức Backend, System Design và lập trình. Khám phá ngay

Tạo API trên CloudFlare Worker và Telegram API như thế nào?

Cách xây dựng một Contact API hiệu quả và miễn phí sử dụng CloudFlare Worker và Telegram API.
Tạo Contact API trên Cloudflare Worker và Telegram API
Tạo Contact API trên Cloudflare Worker và Telegram API
TL;DR: Bạn có thể nhận thông báo từ contact form thẳng vào Telegram mà không cần dựng backend riêng, bằng cách để Cloudflare Worker làm lớp trung gian miễn phí, giữ Bot Token và gọi Telegram Bot API thay bạn. Trong bài này tôi hướng dẫn tạo Bot, lấy Chat ID, viết Worker (kèm vài lỗi hay gặp tôi đã sửa sẵn trong code mẫu), và 3 cách test nhanh sau khi deploy.

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.

Trình duyệt (contact form) Cloudflare Worker giữ Bot Token Telegram Bot API sendMessage

Đ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

  1. Liên hệ @BotFather trên Telegram.
    Liên hệ @BotFather trên Telegram
  2. Dùng lệnh /newbot để tạo bot mới.
    Sử dụng lệnh /newbot để tạo bot mới
  3. Đặt tên và username cho bot.
    Đặt tên và username cho bot
  4. 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:

  1. Tạo Telegram Group hoặc Telegram Channel.
    Tạo Telegram Group
  2. Thêm Bot vào trong Group / Channel.
    Thêm Bot vào trong Group
  3. Gửi một tin nhắn bất kỳ trong group/channel và tag (@) bot của bạn vào đó.
    Chat 1 tin nhắn và tag Bot của bạn
  4. 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. Trong chat object của kết quả trả về, bạn sẽ thấy trường "id" - đó chính là Chat ID bạn cần.
  5. Nếu result trả 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 link getUpdates.

Tạo Cloudflare Worker

  1. Truy cập Dashboard của Cloudflare và tạo Worker mới.
    Tạo Cloudflare Worker
  2. Đặt tên cho Worker và Deploy.
    Đặt tên cho worker và thực hiện Deploy
  3. Mở phần chỉnh sửa code của Worker.
    Thực hiện chỉnh sửa code
  4. 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 object TELEGRAM - 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, '&amp;')
                .replace(/</g, '&lt;')
                .replace(/>/g, '&gt;');
            }
    
            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' }
        });
      }
    }
    
    Dán đoạn code sau và thực hiện Deploy
  5. 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_ID và API_TOKEN với giá trị đã lưu ở các bước trên. Nên đánh dấu API_TOKEN là 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.
    Tạo biến môi trường dùng cho Worker

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

  1. Tải file mẫu bên dưới về máy.
    contact.html 4.3KB
  2. Mở file vừa tải bằng trình duyệt.
    Form liên hệ HTML mẫu
  3. Điền URL Worker và các thông tin còn lại, rồi bấm gửi.
Cạm bẫy và lưu ý thực tế:
  • Đừ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/contact trong 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

Thấy bài viết hữu ích?

0 lượt thích

Đăng nhận xét