Ngoài trời gió mùa đông bắc đang rít qua khe cửa sổ nghe lành lạnh. Cứ độ hai tháng cuối năm, cái rét miền Bắc lại làm mấy đầu ngón tay gõ phím cơ cứng đờ cả lại, phải thủ sẵn cốc trà gừng nóng bốc khói bên cạnh mới ngồi cày cuốc tiếp được. Đêm qua lúc gần 1 giờ sáng, mình tình cờ lội lại mấy bài chia sẻ tài nguyên viết từ hồi năm ngoái. Giật mình. Hơn chục cái link Google Drive bị quét bản quyền chết sạch từ đời nào mà chẳng thấy một ai để lại bình luận nhắc mình cả.
Nghĩ đi nghĩ lại thì cũng chẳng trách độc giả được. Tâm lý người dùng bây giờ đi tìm tài liệu hay đoạn code, bấm vào thấy link hỏng là họ tắt phụp tab rồi quay ra Google tìm trang khác ngay lập tức. Bắt họ kéo xuống tít dưới đáy bài, đăng nhập tài khoản Google rồi gõ bình luận "Admin ơi link die rồi" thì thực sự quá đánh đố. Còn cái tiện ích Contact Form mặc định của Blogspot á? Thôi bỏ đi. Thư báo về Gmail toàn lẫn vào đống thư rác quảng cáo, có khi nửa tháng mình mới mở ra xem một lần.
Mất khách. Tỷ lệ thoát trang (Bounce Rate) cứ thế tăng vọt mà chủ web vẫn ngồi rung đùi tưởng web mình ngon lành. Đấy chính là lý do tối nay, nhân lúc trời lạnh chẳng muốn ra đường, mình ngồi đóng gói lại bộ code nút Báo lỗi bài viết đẩy thông báo thẳng về Telegram qua Bot API mà mình đang dùng thực tế trên blog này để chia sẻ lại cho anh em.
Tại sao mình chọn đẩy thông báo qua Telegram thay vì Email hay Google Sheets?
Trước đây mình từng thử dùng Google Apps Script để hứng dữ liệu báo lỗi rồi ghi vào Google Sheets. Nghe thì có vẻ chuyên nghiệp đấy, nhưng thực tế vận hành mới thấy nó chậm (mỗi lần gửi mất tầm 3 - 4 giây xoay vòng vòng) và phiền nhất là nó không tạo ra phản xạ tức thời. Nhiều hôm đang ngồi quán trà đá vỉa hè, điện thoại rung một cái "Tinh!" trên Telegram, mở ra thấy báo: "Bài viết Share Template X bị lỗi mật khẩu giải nén". Thế là rút điện thoại vào sửa lại đúng dòng mật khẩu trong 30 giây. Xong việc.
Cái sướng của Telegram Bot API nằm ở chỗ:
- Tốc độ gần như tức thời: Gửi request qua phương thức
sendMessagechỉ mất khoảng 200ms - 400ms. - Không cần thuê hosting hay viết PHP: Blogspot vốn dĩ là nền tảng không có phần xử lý máy chủ (Backend). Với Telegram API, bạn chỉ cần gọi hàm
fetch()bằng Javascript thuần ngay trên trình duyệt là tin nhắn bay thẳng về máy. - Tự động bắt chính xác ngữ cảnh: Người đọc không cần copy link bài viết. Code sẽ tự động lấy tiêu đề bài (
document.title), đường dẫn hiện tại (window.location.href) và thời gian gửi để đóng gói thành một bản tin gọn gàng.
Chuẩn bị "nguyên liệu" với BotFather (Kèm lỗi 90% người mới hay dính)
Phần tạo Bot trên Telegram thì nhiều bên hướng dẫn rồi nên mình lướt nhanh thôi, nhưng sẽ chỉ ra đúng cái bẫy mà anh em hay vấp phải khiến code chạy báo lỗi đỏ lòm.
Bạn mở Telegram, tìm tài khoản có tích xanh @BotFather, gõ lệnh /newbot rồi đặt tên cho nó. Sau khi tạo xong, BotFather sẽ trả về một đoạn mã HTTP API Token có dạng kiểu như 7123456789:AAHxyz.... Hãy lưu kỹ đoạn này.
Tiếp theo là lấy Chat ID (địa chỉ nhận tin nhắn). Nhiều bạn làm theo hướng dẫn trên mạng, dán đường dẫn https://api.telegram.org/bot<TOKEN>/getUpdates lên trình duyệt rồi cứ ngồi thắc mắc sao nó chỉ trả về mỗi dòng {"ok":true,"result":[]} trống trơn. Rất đơn giản: Bạn chưa từng nhắn tin cho con Bot đó! Hãy bấm vào link con Bot vừa tạo, nhấn nút Start và gõ đại một chữ "Alo" gửi cho nó, sau đó tải lại trang getUpdates kia. Lúc này dãy số nằm sau chữ "chat":{"id": chính là Chat ID của bạn.
Kinh nghiệm xương máu: Nếu bạn muốn đẩy thông báo vào một Nhóm (Group) để cả đội quản trị cùng xem, hãy thêm con Bot vào nhóm đó rồi cấp quyền Admin cho nó. Lưu ý rằng Chat ID của nhóm luôn bắt đầu bằng dấu trừ (-), ví dụ -100192837465. Quên dấu trừ này là API trả về lỗi 400 ngay lập tức.
Tư duy thiết kế giao diện: Đừng bắt độc giả phải gõ chữ!
Hồi mới làm nút báo lỗi phiên bản đầu tiên, mình để một ô <textarea> trống không và bảo người dùng "Hãy nhập lỗi bạn gặp phải". Kết quả là suốt 1 tháng trời chỉ có lèo tèo vài người bấm gửi, mà toàn gửi mấy chữ vô nghĩa kiểu "asdf" hoặc "lỗi rồi".
Người đọc họ đang vội. Muốn họ giúp mình báo lỗi, mình phải dọn sẵn cho họ chỉ việc tích chọn. Ở phiên bản nâng cấp dưới đây, mình thiết kế sẵn 4 lựa chọn phổ biến nhất dưới dạng nút chọn nhanh (Radio), kèm theo một ô ghi chú tùy chọn. Ai lười chỉ cần tốn đúng 2 cú click chuột: Bấm nút Báo lỗi -> Bấm Gửi. Xong!
Full Code HTML + CSS + Javascript tạo Popup Báo lỗi cho Blogspot
Bạn mở trang quản trị Blogspot, vào mục Chủ đề (Theme) -> Chỉnh sửa HTML. Nếu chỉ muốn nút này hiện ở trong các bài viết (Post) thì hãy đặt đoạn HTML nút bấm vào trong khu vực <data:post.body/> của thẻ <b:includable id='post' var='post'>. Còn phần CSS và Javascript thì cứ ném thẳng lên ngay trước thẻ đóng </body>.
1. Phần giao diện HTML và CSS
<!-- Nút kích hoạt đặt ở cuối bài viết -->
<div class="tg-report-wrapper">
<button type="button" class="tg-report-btn" onclick="openTgReportModal()">
<svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z"></path><line x1="12" y1="9" x2="12" y2="13"></line><line x1="12" y1="17" x2="12.01" y2="17"></line></svg>
Báo lỗi bài viết / Link hỏng
</button>
</div>
<!-- Khung Modal Popup -->
<div id="tgReportModal" class="tg-modal-overlay">
<div class="tg-modal-box">
<div class="tg-modal-header">
<span class="tg-modal-title">Báo lỗi nhanh cho Admin</span>
<button type="button" class="tg-modal-close" onclick="closeTgReportModal()">×</button>
</div>
<div class="tg-modal-body">
<p class="tg-modal-desc">Phát hiện link tải bị chết hoặc nội dung sai sót? Hãy chọn lý do bên dưới, tin nhắn sẽ báo thẳng về điện thoại của mình:</p>
<div class="tg-options-list">
<label class="tg-option-item">
<input type="radio" name="tg_error_type" value="Link tải xuống bị hỏng (Die link)" checked>
<span>Link tải xuống bị hỏng (Die link)</span>
</label>
<label class="tg-option-item">
<input type="radio" name="tg_error_type" value="Sai mật khẩu giải nén / Không mở được file">
<span>Sai mật khẩu giải nén / Lỗi file</span>
</label>
<label class="tg-option-item">
<input type="radio" name="tg_error_type" value="Hình ảnh minh họa không hiển thị">
<span>Hình ảnh trong bài bị lỗi hiển thị</span>
</label>
<label class="tg-option-item">
<input type="radio" name="tg_error_type" value="Code mẫu bị lỗi khi chạy thử">
<span>Đoạn code trong bài chạy bị lỗi</span>
</label>
</div>
<!-- Honeypot chống bot spam tự động -->
<input type="text" id="tg_website_hp" style="display:none !important;" tabindex="-1" autocomplete="off">
<textarea id="tg_error_note" class="tg-textarea" placeholder="Ghi chú thêm (Ví dụ: Link Google Drive số 2 bị lỗi, hoặc để lại email/Telegram nếu muốn mình gửi lại link mới)..." rows="3"></textarea>
<div id="tgReportStatus" class="tg-status-msg"></div>
</div>
<div class="tg-modal-footer">
<button type="button" class="tg-btn-cancel" onclick="closeTgReportModal()">Đóng</button>
<button type="button" id="tgSubmitBtn" class="tg-btn-submit" onclick="sendTgReport()">Gửi thông báo</button>
</div>
</div>
</div>
<style>
.tg-report-wrapper { margin: 20px 0; text-align: right; }
.tg-report-btn {
display: inline-flex; align-items: center; gap: 8px;
background: #fff5f5; color: #c53030; border: 1px solid #feb2b2;
padding: 8px 16px; border-radius: 6px; font-size: 14px; font-weight: 600;
cursor: pointer; transition: all 0.2s ease;
}
.tg-report-btn:hover { background: #fed7d7; transform: translateY(-1px); }
.tg-modal-overlay {
position: fixed; top: 0; left: 0; width: 100%; height: 100%;
background: rgba(15, 23, 42, 0.65); backdrop-filter: blur(3px);
display: none; align-items: center; justify-content: center; z-index: 99999;
padding: 15px; box-sizing: border-box;
}
.tg-modal-overlay.active { display: flex; }
.tg-modal-box {
background: #ffffff; width: 100%; max-width: 460px; border-radius: 12px;
box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.15); overflow: hidden;
animation: tgSlideUp 0.25s ease-out;
}
@keyframes tgSlideUp {
from { opacity: 0; transform: translateY(15px); }
to { opacity: 1; transform: translateY(0); }
}
.tg-modal-header {
display: flex; justify-content: space-between; align-items: center;
padding: 16px 20px; border-bottom: 1px solid #e2e8f0; background: #f8fafc;
}
.tg-modal-title { font-weight: 700; font-size: 16px; color: #1e293b; }
.tg-modal-close {
background: none; border: none; font-size: 24px; line-height: 1;
color: #64748b; cursor: pointer; padding: 0;
}
.tg-modal-body { padding: 20px; text-align: left; }
.tg-modal-desc { font-size: 13.5px; color: #475569; margin: 0 0 14px 0; line-height: 1.5; }
.tg-options-list { display: flex; flex-direction: column; gap: 10px; margin-bottom: 15px; }
.tg-option-item {
display: flex; align-items: center; gap: 10px; font-size: 14px; color: #334155;
padding: 9px 12px; border: 1px solid #cbd5e1; border-radius: 8px; cursor: pointer;
transition: background 0.15s;
}
.tg-option-item:hover { background: #f1f5f9; }
.tg-option-item input[type="radio"] { accent-color: #2563eb; width: 16px; height: 16px; margin: 0; }
.tg-textarea {
width: 100%; box-sizing: border-box; border: 1px solid #cbd5e1; border-radius: 8px;
padding: 10px 12px; font-size: 14px; font-family: inherit; resize: vertical;
outline: none; transition: border-color 0.2s;
}
.tg-textarea:focus { border-color: #2563eb; }
.tg-status-msg { margin-top: 12px; font-size: 13.5px; font-weight: 500; display: none; padding: 8px 12px; border-radius: 6px; }
.tg-status-msg.error { display: block; background: #fef2f2; color: #dc2626; }
.tg-status-msg.success { display: block; background: #f0fdf4; color: #16a34a; }
.tg-modal-footer {
display: flex; justify-content: flex-end; gap: 10px;
padding: 14px 20px; border-top: 1px solid #e2e8f0; background: #f8fafc;
}
.tg-btn-cancel {
background: #e2e8f0; color: #475569; border: none; padding: 8px 16px;
border-radius: 6px; font-size: 14px; font-weight: 600; cursor: pointer;
}
.tg-btn-submit {
background: #2563eb; color: #ffffff; border: none; padding: 8px 18px;
border-radius: 6px; font-size: 14px; font-weight: 600; cursor: pointer;
}
.tg-btn-submit:disabled { opacity: 0.6; cursor: not-allowed; }
</style>
2. Phần xử lý Javascript (Đã tích hợp chống Spam & Escape ký tự lỗi)
Ở đoạn Javascript này, mình đã cố tình chọn chế độ parse_mode: 'HTML' thay vì MarkdownV2. Bạn nào từng làm việc với Telegram Bot chắc chắn biết cái sự "khó ở" của thằng MarkdownV2: chỉ cần tiêu đề bài viết hoặc đường link có dấu chấm ., dấu gạch dưới _ hay dấu ngoặc - mà không thêm dấu gạch chéo ngược \ đằng trước là Telegram từ chối nhận tin nhắn ngay. Dùng HTML rồi viết một hàm nhỏ lọc các ký tự <, >, & lành hơn gấp vạn lần.
<script>
// Cấu hình thông tin Bot của bạn tại đây
const TG_CONFIG = {
// Mẹo nhỏ: Tách chuỗi hoặc mã hóa Base64 để tránh các trình quét tự động (Scraper) trên web
botToken: atob("NzEyMzQ1Njc4OTpBQUh4eXpZb3VyQm90VG9rZW5IZXJl"), // Thay bằng chuỗi Base64 của Token
chatId: "-1001234567890", // Thay bằng Chat ID của bạn
cooldownMinutes: 5 // Thời gian chờ giữa 2 lần gửi (phút)
};
function openTgReportModal() {
document.getElementById('tgReportModal').classList.add('active');
document.getElementById('tgReportStatus').className = 'tg-status-msg';
document.getElementById('tgReportStatus').innerText = '';
}
function closeTgReportModal() {
document.getElementById('tgReportModal').classList.remove('active');
}
// Hàm làm sạch chuỗi tránh lỗi cú pháp HTML của Telegram
function escapeTgHtml(str) {
if (!str) return '';
return str.replace(/&/g, '&')
.replace(/</g, '<')
.replace(/>/g, '>');
}
async function sendTgReport() {
const statusEl = document.getElementById('tgReportStatus');
const submitBtn = document.getElementById('tgSubmitBtn');
const honeypot = document.getElementById('tg_website_hp').value;
// 1. Kiểm tra bẫy Honeypot (Nếu bot tự điền vào ô ẩn này thì chặn luôn)
if (honeypot !== "") {
statusEl.className = 'tg-status-msg error';
statusEl.innerText = 'Phát hiện hành vi bất thường!';
return;
}
// 2. Kiểm tra giới hạn thời gian gửi bằng localStorage
const lastSent = localStorage.getItem('tg_last_report_time');
const now = new Date().getTime();
if (lastSent && (now - parseInt(lastSent)) < TG_CONFIG.cooldownMinutes * 60 * 1000) {
const waitLeft = Math.ceil((TG_CONFIG.cooldownMinutes * 60 * 1000 - (now - parseInt(lastSent))) / 60000);
statusEl.className = 'tg-status-msg error';
statusEl.innerText = 'Bạn vừa gửi báo cáo rồi. Vui lòng đợi ' + waitLeft + ' phút nữa nhé!';
return;
}
const selectedRadio = document.querySelector('input[name="tg_error_type"]:checked');
const errorType = selectedRadio ? selectedRadio.value : 'Không rõ';
const note = document.getElementById('tg_error_note').value.trim();
const postTitle = document.title;
const postUrl = window.location.href;
const timeStr = new Date().toLocaleString('vi-VN');
// Cấu trúc nội dung tin nhắn gửi về Telegram
let messageText = `<b>🚨 BÁO LỖI BÀI VIẾT MỚI</b>\n\n`;
messageText += `<b>📄 Bài viết:</b> ${escapeTgHtml(postTitle)}\n`;
messageText += `<b>🔗 Link:</b> ${escapeTgHtml(postUrl)}\n`;
messageText += `<b>⚠️ Vấn đề:</b> <code>${escapeTgHtml(errorType)}</code>\n`;
if (note !== "") {
messageText += `<b>💬 Ghi chú:</b> <i>${escapeTgHtml(note)}</i>\n`;
}
messageText += `<b>⏰ Thời gian:</b> ${timeStr}`;
submitBtn.disabled = true;
submitBtn.innerText = 'Đang gửi...';
try {
const response = await fetch(`https://api.telegram.org/bot${TG_CONFIG.botToken}/sendMessage`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
chat_id: TG_CONFIG.chatId,
text: messageText,
parse_mode: 'HTML',
disable_web_page_preview: true
})
});
const result = await response.json();
if (result.ok) {
localStorage.setItem('tg_last_report_time', now.toString());
statusEl.className = 'tg-status-msg success';
statusEl.innerText = 'Đã gửi thành công! Cảm ơn bạn đã giúp mình khắc phục lỗi.';
document.getElementById('tg_error_note').value = '';
setTimeout(() => { closeTgReportModal(); }, 2200);
} else {
throw new Error(result.description || 'Lỗi từ phía Telegram');
}
} catch (err) {
statusEl.className = 'tg-status-msg error';
statusEl.innerText = 'Không thể gửi lúc này. Lỗi: ' + err.message;
} finally {
submitBtn.disabled = false;
submitBtn.innerText = 'Gửi thông báo';
}
}
</script>
Góc nói thật: Xử lý bài toán lộ Bot Token trên Blogspot thế nào cho an toàn?
Mình biết ngay khi đọc đến đoạn code Javascript bên trên, mấy anh em làm kỹ thuật cứng tay sẽ nhíu mày hỏi ngay: "Ơ thế vứt cái Token ở phía Client (trình duyệt) dù có mã hóa Base64 bằng hàm atob() thì người ta bấm F12 giải mã ngược lại vẫn thấy Token à?"
Đúng. Mình không hề giấu giếm chuyện đó. Việc dùng atob() trong đoạn code trên thực chất chỉ giúp bạn che mắt mấy con bot cào dữ liệu tự động trên mạng chứ không chống được người có kiến thức mở bảng Developer Tools lên soi.
Vậy nếu blog của bạn có lượng truy cập lớn, hoặc hay bị mấy thành phần rảnh rỗi lấy Token đi bắn tin nhắn rác (Spam API) thì giải quyết sao? Đừng lo, mình có một "vũ khí bí mật" hoàn toàn miễn phí cho anh em: Sử dụng Cloudflare Workers làm trạm trung chuyển (Proxy).
Thay vì gọi thẳng tới api.telegram.org từ trình duyệt, bạn tạo một tài khoản Cloudflare miễn phí, vào mục Workers & Pages tạo một Worker mới (nó cho phép tận 100.000 lượt gọi miễn phí mỗi ngày, xài cho blog cá nhân thì bét nhè không bao giờ hết). Sau đó bạn dán đoạn code trung gian siêu ngắn này vào Worker:
export default {
async fetch(request, env) {
// Chỉ cho phép tên miền blog của bạn được gọi vào Worker này
const allowedOrigin = "https://ten-blog-cua-ban.blogspot.com";
const origin = request.headers.get("Origin");
if (request.method === "OPTIONS") {
return new Response(null, {
headers: {
"Access-Control-Allow-Origin": allowedOrigin,
"Access-Control-Allow-Methods": "POST",
"Access-Control-Allow-Headers": "Content-Type"
}
});
}
if (request.method !== "POST" || origin !== allowedOrigin) {
return new Response("Forbidden", { status: 403 });
}
const body = await request.json();
const BOT_TOKEN = "DÁN_TOKEN_THẬT_CỦA_BẠN_Ở_ĐÂY";
const CHAT_ID = "DÁN_CHAT_ID_CỦA_BẠN_Ở_ĐÂY";
const tgRes = await fetch(`https://api.telegram.org/bot${BOT_TOKEN}/sendMessage`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
chat_id: CHAT_ID,
text: body.text,
parse_mode: "HTML",
disable_web_page_preview: true
})
});
const data = await tgRes.json();
return new Response(JSON.stringify(data), {
headers: {
"Content-Type": "application/json",
"Access-Control-Allow-Origin": allowedOrigin
}
});
}
};
Khi dùng cách này, toàn bộ BOT_TOKEN và CHAT_ID nằm chết dí ở trên máy chủ của Cloudflare, đố ai F12 trên Blogspot mà mò ra được. Ở phía code Javascript trên Blogspot, bạn chỉ việc đổi đường dẫn trong hàm fetch() thành địa chỉ Worker của bạn (ví dụ: https://report-proxy.tenban.workers.dev) là xong. Thêm cái kiểm tra allowedOrigin kia nữa thì mấy tay thích phá hoại có mang link Worker đi nơi khác gọi cũng ăn ngay quả lỗi 403 vào mặt.
Một vài trục trặc nhỏ khi mình tự test và cách sửa
Trong quá trình gắn thử lên 3 cái blog vệ tinh của mình suốt mấy tuần qua, có đôi lúc nút bấm bị đơ hoặc không gửi được. Mình liệt kê luôn ở đây để lỡ anh em có gặp đỡ phải mất công mò mẫm:
- Bị trình chặn quảng cáo (AdBlock / uBlock Origin) chặn nhầm: Một số bộ lọc chặn quảng cáo quá gắt đôi khi chặn các request gửi đi từ trình duyệt tới tên miền lạ nếu bạn đặt tên biến hay class chứa chữ
adhoặctrack. Trong code trên mình đã đặt tiền tố làtg-nên hoàn toàn sạch sẽ, vượt qua mọi trình chặn. - Lỗi xung đột sự kiện Click trên một số mẫu (Template) Blogspot cũ: Có những bộ template dùng jQuery đời cổ hay bắt sự kiện toàn trang khiến nút mở Popup bấm không ăn. Nếu gặp trường hợp đó, bạn chỉ cần thêm thuộc tính
z-index: 999999 !important;vào class.tg-modal-overlaylà nổi lên trên tất cả. - Tin nhắn quá dài bị cắt: Giới hạn một tin nhắn văn bản của Telegram là 4096 ký tự. Để đề phòng có ông độc giả nào copy cả bài văn mẫu dán vào ô ghi chú làm lỗi API, bạn có thể thêm thuộc tính
maxlength="500"vào thẻ<textarea>là vừa đẹp.
Cốc trà gừng của mình cũng nguội ngắt từ lúc nào rồi, ngoài hiên gió vẫn thổi hun hút. Hy vọng chút chia sẻ nhỏ vào cái đêm cuối năm lạnh lẽo này sẽ giúp anh em chăm sóc đứa con tinh thần Blogspot của mình tốt hơn, giữ chân được người đọc và không còn cảnh mất thứ hạng từ khóa chỉ vì những cái link tải chết oan uổng. Anh em đem code về gắn thử đi, nếu vướng ở bước lấy mã Base64 hay cấu hình Cloudflare Worker chưa chạy được thì cứ để lại bình luận ngay bên dưới, sáng mai dậy mình hỗ trợ tiếp nhé!