Giao diện
@digiforce-nc/plugin-workflow-telegram
Plugin đăng ký node gửi tin nhắn Telegram trong workflow, mở rộng plugin-workflow. Gửi tin nhắn text, HTML, hoặc Markdown đến chat/group/channel Telegram qua Bot API.
Plugin này làm gì?
Node Telegram gửi tin nhắn đến Telegram chat thông qua Bot API. Cấu hình bot token và chat ID, node sẽ gửi tin nhắn với nội dung từ template sử dụng biến workflow. Hỗ trợ text thuần, HTML, và Markdown format.
Yêu cầu trước khi sử dụng:
- Tạo bot qua @BotFather để lấy bot token
- Lấy chat ID của người nhận, group, hoặc channel
- Bot phải là thành viên của group/channel (nếu gửi vào group)
Cấu hình
| Tham số | Kiểu | Mô tả |
|---|---|---|
botToken | string | Token của Telegram Bot (từ BotFather) |
chatId | string | ID của chat, group, hoặc channel |
parseMode | string | Format: Text, HTML, MarkdownV2 |
message | string | Nội dung tin nhắn (template biến workflow) |
disableNotification | boolean | Gửi im lặng (không sound/vibration) |
replyToMessageId | number | ID tin nhắn cần reply |
Input / Output
| Hướng | Dữ liệu | Mô tả |
|---|---|---|
| Input | chatId | Chat đích (có thể từ biến workflow) |
| Input | message | Nội dung tin nhắn (template) |
| Output | messageId | ID tin nhắn đã gửi |
| Output | ok | true nếu gửi thành công |
| Output | error | Chi tiết lỗi nếu thất bại |
Tính năng chính
| # | Tính năng | Chi tiết |
|---|---|---|
| 1 | Bot API | Gửi qua Telegram Bot API chính thức |
| 2 | Nhiều format | Text thuần, HTML, MarkdownV2 |
| 3 | Template | Nội dung sử dụng biến workflow |
| 4 | Group / Channel | Gửi đến private chat, group, hoặc channel |
| 5 | Silent mode | Gửi không gây notification trên thiết bị |
Trường hợp sử dụng
| # | Kịch bản | Mô tả |
|---|---|---|
| 1 | Cảnh báo đơn hàng | Gửi thông báo đơn mới vào group Telegram bán hàng |
| 2 | Alert hệ thống | Gửi cảnh báo lỗi server vào channel DevOps |
| 3 | Xác nhận giao dịch | Gửi chi tiết thanh toán cho khách qua Telegram |
| 4 | Báo cáo tự động | Gửi tóm tắt doanh thu cuối ngày vào group quản lý |
Parse mode hỗ trợ
| Mode | HTML tags | Format | Ví dụ |
|---|---|---|---|
Text | Không | Plain text | Tin nhắn đơn giản |
HTML | <b>, <i>, <a>, <code>, <pre> | HTML cơ bản | <b>Bold</b> text |
MarkdownV2 | Không | Markdown syntax | *bold* _italic_ |
Lưu ý quan trọng
- Bot token phải được bảo mật - không chia sẻ hoặc commit vào git
- Telegram rate limit: tối đa 30 tin nhắn/giây cho bot, 20 tin/phút cho group
- MarkdownV2 yêu cầu escape ký tự đặc biệt:
.,!,(,),-, ... - HTML mode chỉ hỗ trợ tag cơ bản:
<b>,<i>,<a>,<code>,<pre> - Chat ID cho group thường là số âm (ví dụ: -1001234567890)
Dependencies
| Package | Vai trò |
|---|---|
@digiforce-nc/plugin-workflow | Workflow engine (peer) |
@digiforce-nc/server | Server framework (peer) |