Send Telegram Notifications in Next.js

​

Mục tiêu bài học

• Hiểu được cơ chế hoạt động của Telegram Bot API.
• Tạo và cấu hình một Telegram Bot hoàn chỉnh.
• Lấy được chat_id của cá nhân, nhóm, hoặc kênh.
• Xây dựng API Route trong Next.js để gửi thông báo an toàn.
• Tích hợp gửi thông báo từ form liên hệ, đơn hàng, hoặc sự kiện hệ thống.
• Xử lý lỗi, định dạng tin nhắn (Markdown/HTML), và gửi kèm hình ảnh, file.

​

Video tại:

https://youtu.be/ete4eUzs6-U

https://youtu.be/k1Q5x6It1Zg

​

1. Tổng quan về Telegram Bot

​

1.1. Tại sao chọn Telegram để gửi thông báo?

• Miễn phí hoàn toàn: Không giới hạn số tin nhắn gửi đi (trong giới hạn rate limit hợp lý).
• Tốc độ nhanh: Tin nhắn đến gần như ngay lập tức trên cả mobile và desktop.
• API đơn giản: Chỉ cần một HTTP request là có thể gửi tin nhắn.
• Đa nền tảng: Người nhận có thể xem trên điện thoại, máy tính, web.
• Hỗ trợ định dạng phong phú: Markdown, HTML, hình ảnh, file, video, location.

​

1.2. Các trường hợp sử dụng phổ biến

• Thông báo khi có khách hàng mới gửi form liên hệ trên website.
• Cảnh báo khi có đơn hàng mới trên hệ thống e-commerce.
• Thông báo lỗi (error monitoring) cho dev team.
• Gửi báo cáo doanh thu hằng ngày, hằng tuần.
• Cảnh báo bảo mật (đăng nhập bất thường, password reset).
• Thông báo deployment thành công/thất bại.

​

2. Tạo Telegram Bot

​

2.1. Sử dụng BotFather để tạo Bot

1. Mở Telegram, tìm kiếm @BotFather (có dấu tick xanh).
2. Bắt đầu cuộc trò chuyện và gõ lệnh /newbot.
3. Nhập tên hiển thị của bot (ví dụ: Softech Notification Bot).
4. Nhập username cho bot, bắt buộc kết thúc bằng bot (ví dụ: softech_notify_bot).
5. BotFather sẽ trả về một Token có dạng:

7891234567:AAEhBP9k_xxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ Cảnh báo bảo mật: Token này giống như mật khẩu. Bất kỳ ai có token đều có thể điều khiển bot của bạn. Tuyệt đối không commit token vào Git, không paste lên forum, không hardcode vào code frontend.

​

2.2. Các lệnh hữu ích của BotFather

• /mybots — Liệt kê tất cả bot bạn đã tạo.
• /setname — Đổi tên hiển thị.
• /setdescription — Đặt mô tả cho bot.
• /setuserpic — Đổi avatar cho bot.
• /token — Lấy lại token (nếu quên).
• /revoke — Thu hồi token cũ và tạo token mới (dùng khi token bị lộ).

​

3. Lấy Chat ID

• Chat cá nhân: ID là số dương (ví dụ: 123456789).
• Nhóm (group): ID là số âm (ví dụ: -987654321).
• Kênh (channel): ID là số âm với tiền tố -100 (ví dụ: -1001234567890).

​

3.1. Lấy chat_id cá nhân

1. Tìm @userinfobot trên Telegram.
2. Bấm Start, bot sẽ trả về thông tin của bạn bao gồm Id.

1. Mở Telegram, gửi tin nhắn bất kỳ cho bot vừa tạo (ví dụ gõ /start).
2. Mở trình duyệt, truy cập URL sau (thay <TOKEN> bằng token thật):

https://api.telegram.org/bot<TOKEN>/getUpdates

3. Tìm trường "chat":{"id": ...} trong JSON trả về. Đó là chat_id.

​

3.2. Lấy chat_id của nhóm

1. Thêm bot vào nhóm Telegram.
2. Gửi một tin nhắn bất kỳ vào nhóm (có nhắc đến bot, ví dụ /start@your_bot).
3. Truy cập https://api.telegram.org/bot<TOKEN>/getUpdates.
4. Tìm chat_id âm trong response.

💡 Mẹo: Nếu nhóm là supergroup, ID sẽ bắt đầu bằng -100.

​

3.3. Lấy chat_id của kênh

1. Tạo một kênh Telegram (channel).
2. Thêm bot làm admin của kênh (nếu chỉ là member, bot không gửi được tin).
3. Đăng một tin nhắn trong kênh.
4. Truy cập getUpdates để lấy ID, hoặc dùng bot @username_to_id_bot.

​

4. Telegram Bot API cơ bản

​

4.1. Cấu trúc URL

https://api.telegram.org/bot<TOKEN>/<METHOD_NAME>

​

4.2. Phương thức sendMessage

• chat_id (bắt buộc): ID của người/nhóm/kênh nhận tin.
• text (bắt buộc): Nội dung tin nhắn (tối đa 4096 ký tự).
• parse_mode (tùy chọn): Định dạng tin nhắn — Markdown, MarkdownV2, hoặc HTML.
• disable_web_page_preview (tùy chọn): Tắt preview link.
• disable_notification (tùy chọn): Gửi tin nhắn im lặng (không có thông báo âm thanh).

curl -X POST "https://api.telegram.org/bot<TOKEN>/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "123456789",
    "text": "Xin chào từ Softech Aptech!"
  }'

​

5. Tích hợp vào Next.js

​

5.1. Tạo dự án Next.js mới

npx create-next-app@latest my-telegram-bot

• Would you like to use TypeScript? → gõ Yes rồi Enter
• Would you like to use ESLint? → gõ Yes rồi Enter
• Would you like to use Tailwind CSS? → gõ Yes rồi Enter
• Would you like to use src/ directory? → gõ No rồi Enter
• Would you like to use App Router? → gõ Yes rồi Enter
• Would you like to customize the default import alias? → gõ No rồi Enter

cd my-telegram-bot

code .

​

5.2. Lưu trữ Token và Chat ID an toàn

​

Ý tưởng đằng sau

​

Cách làm từng bước

Lưu ý: Tên file bắt đầu bằng dấu chấm (.). Đây là file ẩn trên máy, nên bạn sẽ không thấy nó trong Finder/Explorer thông thường.

TELEGRAM_BOT_TOKEN=Thay_Token_Cua_Ban_Vao_Day
TELEGRAM_CHAT_ID=Thay_Chat_ID_Cua_Ban_Vao_Day

.env*.local

​

5.3. Tạo “cỗ máy” gửi tin nhắn tự động

​

Ý tưởng đằng sau

​

Cách làm từng bước

Prompt để tạo file lib/telegram.ts:

Viết file TypeScript `lib/telegram.ts` trong dự án Next.js với các yêu cầu sau:

1. Định nghĩa interface `SendMessageOptions` gồm: `chatId?` (string), `text` (string bắt buộc), `parseMode?` ('Markdown' | 'MarkdownV2' | 'HTML'), `disableNotification?`, `disableWebPagePreview?`.
2. Định nghĩa interface `TelegramResponse` gồm: `ok` (boolean), `result?` (any), `description?` (string), `error_code?` (number).
3. Viết hàm async `sendTelegramMessage(options: SendMessageOptions): Promise<TelegramResponse>` thực hiện:
   - Đọc `process.env.TELEGRAM_BOT_TOKEN` và `process.env.TELEGRAM_CHAT_ID`
   - Nếu thiếu token thì throw Error 'TELEGRAM_BOT_TOKEN chưa được cấu hình'
   - Nếu thiếu chatId thì throw Error 'Chat ID chưa được cung cấp'
   - Gọi fetch POST đến `https://api.telegram.org/bot${token}/sendMessage`
   - Body gửi: `{ chat_id, text, parse_mode: options.parseMode || 'HTML', disable_notification: false, disable_web_page_preview: false }`
   - Headers: Content-Type: application/json
   - fetch options: method POST, cache: 'no-store'
   - Parse response.json(), nếu data.ok === false thì throw Error(data.description)
   - Catch errors, log console.error, re-throw

​

5.4. Tạo “cổng” để website gửi thông báo

​

Ý tưởng đằng sau

​

Cách làm từng bước

Prompt để tạo file app/api/notify/route.ts:

Viết file TypeScript `app/api/notify/route.ts` trong Next.js App Router với các yêu cầu:

1. Import `NextRequest, NextResponse` từ 'next/server'
2. Import `sendTelegramMessage` từ '@/lib/telegram'
3. Export hàm async `POST(request: NextRequest)` thực hiện:
   - Đọc `request.json()` để lấy body chứa `{ name, email, phone, message }`
   - Validate: nếu thiếu `name` hoặc `email` hoặc `message` → trả `NextResponse.json({ error: 'Vui lòng nhập đầy đủ thông tin' }, { status: 400 })`
   - Tạo biến `text` là chuỗi HTML định dạng tin nhắn Telegram với các trường: icon 🔔 tiêu đề "Liên hệ mới từ Website", 👤 Họ tên, 📧 Email, 📱 Số điện thoại (hiển thị "Không có" nếu không có), 💬 Nội dung, ⏰ Thời gian (dùng toLocaleString 'vi-VN' với timeZone 'Asia/Ho_Chi_Minh')
   - Tất cả giá trị động phải escape HTML bằng hàm escapeHtml: thay & → &amp;, < → &lt;, > → &gt;
   - Gọi `await sendTelegramMessage({ text })`
   - Trả `NextResponse.json({ success: true })`
   - Catch errors: log console.error → trả `NextResponse.json({ error: 'Có lỗi xảy ra, vui lòng thử lại' }, { status: 500 })`
   - Viết hàm `escapeHtml` ở cuối file

​

5.5. Tạo trang form liên hệ trên website

​

Ý tưởng đằng sau

​

Cách làm từng bước

Prompt để tạo file app/contact/page.tsx:

Viết file TSX page component cho trang liên hệ trong Next.js App Router với:

1. `'use client'` directive ở đầu file
2. Import `useState, FormEvent` từ 'react'
3. State `formData` gồm: `{ name, email, phone, message }` — tất cả khởi tạo là chuỗi rỗng
4. State `loading` (boolean, mặc định false) và `status` ({ type: 'success'|'error'|null, message: string }, mặc định null)
5. Hàm async `handleSubmit(e: FormEvent)`:
   - `e.preventDefault()`
   - setLoading(true)
   - setStatus(null
   - fetch POST '/api/notify' với headers Content-Type: application/json và body JSON.stringify(formData)
   - Parse response.json()
   - Nếu !res.ok throw Error(data.error)
   - Nếu thành công: setStatus success message 'Gửi thành công! Chúng tôi sẽ liên hệ sớm.', reset formData về rỗng
   - Catch: setStatus error message
   - Finally: setLoading(false)
6. UI form có: input name (text), input email (email), input phone (tel), textarea message (rows=5), button submit. Tất cả dùng className Tailwind: w-full px-4 py-2 border rounded-lg
7. Button hiển thị loading ? 'Đang gửi...' : 'Gửi liên hệ', disabled={loading}
8. Hiển thị status.message bằng div có màu: success → bg-green-100 text-green-800, error → bg-red-100 text-red-800
9. Dùng className container: max-w-2xl mx-auto p-6
10. Heading: 'Liên hệ với chúng tôi'

npm run dev

​

6. Cách nhanh hơn: Gửi thông báo không cần API Route (Server Actions)

​

Ý tưởng đằng sau

Khi nào dùng cách nào? Nếu bạn chỉ gửi từ form trên website → dùng Server Actions (phần này). Nếu bạn muốn ứng dụng khác (app mobile, phần mềm bên ngoài) gọi được → dùng API Route (phần 5).

​

6.1. Tạo Server Action

Prompt để tạo file app/actions/notify.ts:

Viết file TypeScript `app/actions/notify.ts` trong Next.js với:

1. `'use server'` directive
2. Import `sendTelegramMessage` từ '@/lib/telegram'
3. Export async function `sendContactNotification(formData: FormData)`:
   - Lấy name, email, message từ formData.get()
   - Nếu thiếu name hoặc email hoặc message → return { success: false, error: 'Thiếu thông tin' }
   - Tạo text HTML Telegram với icon 🔔 tiêu đề "Liên hệ mới", 👤 name, 📧 email, 💬 message
   - await sendTelegramMessage({ text })
   - return { success: true }
   - Catch: return { success: false, error: 'Gửi thất bại' }

​

6.2. Cập nhật trang form liên hệ

Prompt để cập nhật app/contact/page.tsx:

Viết lại file `app/contact/page.tsx` với Server Action:

1. `'use client'` directive
2. Import `useState` từ 'react'
3. Import `sendContactNotification` từ '@/app/actions/notify'
4. State `pending` (boolean, mặc định false)
5. Hàm async `handleSubmit(formData: FormData)`:
   - setPending(true)
   - const result = await sendContactNotification(formData)
   - setPending(false)
   - if (result.success) alert('Gửi thành công! Chúng tôi sẽ liên hệ sớm.')
   - else alert(result.error || 'Có lỗi xảy ra')
6. Form có: h1 'Liên hệ với chúng tôi', input name (required), input email type=email (required), input phone type=tel, textarea message (required, rows=5), button submit (disabled={pending}, hiển thị pending ? 'Đang gửi...' : 'Gửi liên hệ')
7. Dùng form action={handleSubmit}, className container: max-w-2xl mx-auto p-6 space-y-4
8. Các input dùng className: w-full px-4 py-2 border rounded-lg
9. Button: w-full bg-blue-600 text-white py-3 rounded-lg hover:bg-blue-700 disabled:opacity-50

​

7. Trang trí tin nhắn đẹp hơn

​

7.1. Tin nhắn với định dạng HTML

​

Ý tưởng đằng sau

​

Cách làm từng bước

Prompt để thêm vào lib/telegram.ts:

Thêm vào file `lib/telegram.ts` một hàm async `sendFormattedMessage(text: string): Promise<TelegramResponse>`:

- Lấy token từ process.env.TELEGRAM_BOT_TOKEN, chatId từ process.env.TELEGRAM_CHAT_ID
- Nếu thiếu throw Error 'Thiếu TELEGRAM_BOT_TOKEN hoặc TELEGRAM_CHAT_ID'
- fetch POST đến https://api.telegram.org/bot${token}/sendMessage
- Body: { chat_id: chatId, text, parse_mode: 'HTML', cache: 'no-store' }
- Parse response.json(), nếu !data.ok throw Error(data.description)
- Return data

Prompt để gọi hàm sendFormattedMessage:

Viết một đoạn TypeScript gọi hàm sendFormattedMessage với nội dung HTML gồm:
- Tiêu đề 🛒 Đơn hàng mới (dùng thẻ <b>)
- Dòng <i>Tên khách:</i> Nguyễn Văn A
- Dòng <b>Giá trị:</b> 1.200.000đ (dùng <s> cho giá cũ gạch ngang, <u> cho giá mới)
- Dòng <code>Mã vận đơn: VN123456</code>
- Dòng link: <a href="https://shop.com/orders/DH-001">👀 Xem chi tiết</a>

​

7.2. Gửi tin nhắn kèm nút bấm

​

Ý tưởng đằng sau

​

Cách làm từng bước

Prompt để thêm vào lib/telegram.ts:

Thêm vào file `lib/telegram.ts` hàm async `sendMessageWithButtons(text: string, buttons: Array<Array<{ text: string; url?: string; callback_data?: string }>>): Promise<TelegramResponse>`:

- Lấy token từ process.env.TELEGRAM_BOT_TOKEN, chatId từ process.env.TELEGRAM_CHAT_ID
- Nếu thiếu throw Error 'Thiếu TELEGRAM_BOT_TOKEN hoặc TELEGRAM_CHAT_ID'
- fetch POST đến https://api.telegram.org/bot${token}/sendMessage
- Body: { chat_id: chatId, text, parse_mode: 'HTML', reply_markup: { inline_keyboard: buttons }, cache: 'no-store' }
- Parse response.json(), nếu !data.ok throw Error(data.description)
- Return data

Prompt để gọi hàm sendMessageWithButtons:

Viết một đoạn TypeScript gọi hàm sendMessageWithButtons với:
- text: chuỗi HTML '<b>🛒 Đơn hàng mới #DH-123</b>' + thông tin khách hàng và tổng tiền
- buttons: mảng 2 hàng — hàng 1 gồm 2 nút ['👀 Xem chi tiết' (url đến shop.com/orders/DH-123), '✅ Xác nhận đơn' (callback_data: 'confirm_DH-123')], hàng 2 gồm 1 nút ['❌ Hủy đơn' (callback_data: 'cancel_DH-123')]

Nút url → Mở link trong trình duyệt khi bấm. Nút callback_data → Gửi phản hồi về cho bot (cần lập trình thêm phần xử lý phản hồi).

​

8. Gửi hình ảnh và file đính kèm

​

8.1. Gửi hình ảnh

​

Ý tưởng đằng sau

​

Cách làm từng bước

Prompt để thêm vào lib/telegram.ts:

Thêm vào file `lib/telegram.ts` hàm async `sendPhoto(photoUrl: string, caption?: string): Promise<TelegramResponse>`:

- Lấy token từ process.env.TELEGRAM_BOT_TOKEN, chatId từ process.env.TELEGRAM_CHAT_ID
- Nếu thiếu throw Error 'Thiếu TELEGRAM_BOT_TOKEN hoặc TELEGRAM_CHAT_ID'
- fetch POST đến https://api.telegram.org/bot${token}/sendPhoto
- Body: { chat_id: chatId, photo: photoUrl, caption: caption, parse_mode: 'HTML' }
- Parse response.json(), nếu !data.ok throw Error(data.description)
- Return data

Prompt để gọi hàm sendPhoto:

Viết một đoạn TypeScript gọi hàm sendPhoto với URL ảnh sản phẩm và caption HTML gồm: tên sản phẩm 💻 Laptop HP 15s, giá 14.500.000đ, trạng thái 📦 Còn hàng

Lưu ý: Link ảnh phải là link công khai (public URL). Ảnh từ Google Drive, Dropbox (link chia sẻ) sẽ không gửi được.

​

8.2. Gửi file tài liệu (PDF, Excel, Word)

​

Cách làm từng bước

Prompt để thêm vào lib/telegram.ts:

Thêm vào file `lib/telegram.ts` hàm async `sendDocument(fileUrl: string, caption?: string): Promise<TelegramResponse>`:

- Lấy token từ process.env.TELEGRAM_BOT_TOKEN, chatId từ process.env.TELEGRAM_CHAT_ID
- Nếu thiếu throw Error 'Thiếu TELEGRAM_BOT_TOKEN hoặc TELEGRAM_CHAT_ID'
- fetch POST đến https://api.telegram.org/bot${token}/sendDocument
- Body: { chat_id: chatId, document: fileUrl, caption: caption }
- Parse response.json(), nếu !data.ok throw Error(data.description)
- Return data

Prompt để gọi hàm sendDocument:

Viết một đoạn TypeScript gọi hàm sendDocument 2 lần:
1. Gửi file báo cáo Excel URL: https://shop.com/reports/daily-2024-01-15.xlsx, caption: 📊 Báo cáo doanh thu ngày 15/01/2024, Tổng đơn: 45, Doanh thu: 125.000.000đ
2. Gửi file hợp đồng PDF URL: https://shop.com/contracts/HD-2024-001.pdf, caption: 📄 Hợp đồng #HD-2024-001, Khách hàng: Công ty ABC

​

9. Xử lý lỗi thường gặp

​

9.1. Các lỗi phổ biến và cách khắc phục

​

9.2. Giới hạn tốc độ gửi (Rate Limit)

Thực tế: Với website thông thường, bạn sẽ không bao giờ vượt quá giới hạn này. Chỉ cần lưu ý khi gửi nhiều tin nhắn liên tiếp trong vòng lặp.

​

9.3. Gửi lại tự động khi thất bại

​

Ý tưởng đằng sau

​

Cách làm từng bước

Prompt để thêm vào lib/telegram.ts:

Thêm vào file `lib/telegram.ts` hàm async `sendWithRetry(options: SendMessageOptions, maxRetries = 3): Promise<TelegramResponse>`:

- Loop từ 0 đến maxRetries - 1
- Trong try: return await sendTelegramMessage(options)
- Trong catch: nếu là lần thử cuối (attempt === maxRetries - 1) → throw error
- Ngược lại: tính delay = Math.pow(2, attempt) * 1000 (tức 1s, 2s, 4s)
- console.log thông báo đang thử lại
- await new Promise(resolve => setTimeout(resolve, delay))
- Sau vòng loop throw Error 'Đã hết số lần thử lại'

Prompt để thay thế lời gọi hàm:

Tìm trong file app/actions/notify.ts (hoặc app/api/notify/route.ts) dòng await sendTelegramMessage({ text }) và thay bằng await sendWithRetry({ text })

​

10. Bài tập thực hành

​

Bài tập 1: Form đăng ký nhận bản tin

1. Tạo thư mục app/subscribe và file page.tsx bên trong
2. Copy prompt bên dưới vào Claude Code/ChatGPT để tạo file:

Prompt để tạo app/subscribe/page.tsx:

Viết file `app/subscribe/page.tsx` là trang đăng ký nhận bản tin:

1. 'use client'
2. State: email (string), pending (boolean), message (string) — khởi tạo rỗng/false
3. Import `sendContactNotification` từ '@/app/actions/notify'
4. Hàm handleSubmit(e): e.preventDefault(), tạo FormData với email, name='Người đăng ký bản tin', message chứa email, gọi sendContactNotification, cập nhật message thành công/thất bại
5. UI: h1 '📬 Đăng ký nhận bản tin', form có input email (type=email, required, placeholder 'Nhập email của bạn'), button 'Đăng ký' (disabled={pending})
6. Hiển thị message bên dưới form
7. Container: max-w-md mx-auto p-6
8. Các input: w-full px-4 py-2 border rounded-lg
9. Button: w-full bg-blue-600 text-white py-2 rounded-lg hover:bg-blue-700 disabled:opacity-50

3. Chạy npm run dev → mở http://localhost:3000/subscribe → điền email và bấm Đăng ký
4. Kiểm tra Telegram — bạn sẽ nhận được tin nhắn thông báo

​

Bài tập 2: Thông báo đơn hàng với nút bấm

1. Tạo thư mục app/checkout và file page.tsx
2. Copy prompt bên dưới để tạo file:

Prompt để tạo app/checkout/page.tsx:

Viết file `app/checkout/page.tsx` là trang giả lập checkout:

1. 'use client'
2. State: ordered (boolean, mặc định false)
3. Import `sendMessageWithButtons` từ '@/lib/telegram'
4. Hàm handleOrder: tạo orderId = 'DH-' + random 6 ký tự, total = 1_450_000, gọi sendMessageWithButtons với message HTML có: icon 🛒, mã đơn hàng, thông tin khách, icon 💰 tổng tiền dùng toLocaleString('vi-VN'), nút bấm: ['👀 Xem chi tiết' (url đến shop.com/orders/{orderId}), '✅ Xác nhận đơn' (callback_data: confirm_{orderId})]
5. Sau khi gọi: setOrdered(true)
6. UI: nếu ordered → hiển thị '🎉 Đặt hàng thành công!'
7. Ngược lại: h1 '🛒 Thanh toán đơn hàng', div thông tin sản phẩm (💻 Laptop HP 15s, Giá: 1.450.000đ), button 'Đặt hàng ngay' (bg-green-600, w-full)

3. Chạy npm run dev → mở http://localhost:3000/checkout
4. Bấm Đặt hàng ngay → kiểm tra Telegram

​

Bài tập 3: Gửi ảnh sản phẩm qua Telegram

1. Mở file lib/telegram.ts, thêm hàm sendPhoto (xem phần 8.1)
2. Tạo thư mục app/product và file page.tsx bằng prompt:

Prompt để tạo app/product/page.tsx:

Viết file `app/product/page.tsx` với tính năng gửi ảnh sản phẩm qua Telegram:

1. 'use client'
2. Import `sendPhoto` từ '@/lib/telegram'
3. Hàm handleNotify: gọi sendPhoto với URL ảnh 'https://images.unsplash.com/photo-1491553895911-0055uj6e4cef?w=800' và caption HTML '<b>💻 Laptop mới về!</b>\n💰 Giá: 18.900.000đ\n📦 Số lượng: 5 cái', alert thành công
4. UI: h1 'Chi tiết sản phẩm', thẻ img src ảnh đó (w-400, rounded-lg, mb-4), p '💻 Laptop HP 15s — 18.900.000đ', button 'Gửi thông báo Telegram' (bg-blue-600 text-white px-6 py-2 rounded-lg)

3. Chạy thử và kiểm tra kết quả

​

Bài tập 4 (nâng cao): Tự động thử lại khi gửi thất bại

1. Mở file app/actions/notify.ts
2. Thêm sendWithRetry từ phần 9.3 vào lib/telegram.ts
3. Trong file notify.ts, thay sendTelegramMessage bằng sendWithRetry bằng prompt:

Prompt để cập nhật app/actions/notify.ts:

Cập nhật file `app/actions/notify.ts`:

1. Thêm import `sendWithRetry` từ '@/lib/telegram' (thay vì sendTelegramMessage)
2. Thay await sendTelegramMessage({ text }) bằng await sendWithRetry({ text })
3. Catch block: return { success: false, error: 'Gửi thất bại sau nhiều lần thử' }

​

11. Tổng kết

​

Những điểm cần nhớ

• Token Telegram phải được bảo mật, không bao giờ đặt ở client-side.
• Luôn validate và escape input của user trước khi gửi.
• Sử dụng API Route hoặc Server Action — đừng gọi Telegram API trực tiếp từ browser.
• Hiểu rõ rate limit để tránh bot bị Telegram block tạm thời.
• HTML parse mode dễ dùng hơn Markdown vì ít ký tự cần escape.

​

Tài liệu tham khảo

• Tài liệu chính thức Telegram Bot API: https://core.telegram.org/bots/api
• Hướng dẫn tạo bot với BotFather: https://core.telegram.org/bots/tutorial
• Next.js App Router & Server Actions: https://nextjs.org/docs/app
• Telegram Bot API formatting options: https://core.telegram.org/bots/api#formatting-options

​

Hướng phát triển tiếp theo

• Webhook: Nhận tin nhắn 2 chiều thay vì chỉ gửi ra.
• Telegraf.js: Framework xây dựng bot Telegram phức tạp với Node.js.
• Inline Mode: Cho phép user gọi bot từ bất kỳ chat nào với cú pháp @your_bot query.
• Payments API: Tích hợp thanh toán trực tiếp trong Telegram.
• Mini Apps: Xây dựng web app chạy bên trong Telegram.