← Về trang chủ
📋 Workflow notification
| Sự kiện | Tin nhắn | Mention ai |
|---|
| 📥 HR upload CV mới | "CV mới chờ TPMKT duyệt" | TPMKT |
| ❌ TPMKT loại CV | "Đã loại CV" | HR |
| 🟡 TPMKT đánh dấu Tiềm năng | "CV được đánh dấu Tiềm năng" | HR |
| 🟢 TPMKT hẹn PV V1 | "TPMKT hẹn PV — HR triển khai" | HR |
| 📝 HR gửi bài test | "Đã gửi test cho ứng viên" | (không mention) |
| ✅ Ứng viên nộp bài | "Ứng viên ĐÃ NỘP BÀI TEST" | HR + TPMKT |
🚀 BƯỚC 1: Tạo Custom Bot trong group Lark
1
Mở Lark / Feishu app → vào group muốn nhận thông báo
Vd: tạo group "📥 KITA Tuyển dụng" gồm HR + TPMKT + GĐ
2
Bấm icon ⚙️ Cài đặt nhóm (góc phải trên)
3
Chọn Group Bot → bấm + Add Bot
4
Chọn Custom Bot
- Bot name: KITA Interview
- Description: Thông báo trạng thái CV / phỏng vấn
- Avatar: upload logo KITA (tuỳ chọn)
5
Bấm Add → màn hình hiện Webhook URL
URL có dạng: https://open.larksuite.com/open-apis/bot/v2/hook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Copy URL này — sẽ paste vào Apps Script ở Bước 2.
⚠️ Bot chỉ gửi tin nhắn vào ĐÚNG group này. Muốn gửi đến nhiều group → tạo nhiều bot.
6
(Tuỳ chọn) Bật Security Setting
Có thể bỏ qua để đơn giản. Nếu muốn bảo mật → chọn Custom Keywords với từ khoá KITA (mọi tin nhắn phải chứa từ này — em đã đảm bảo trong code).
⚙️ BƯỚC 2: Cấu hình trong Apps Script
1
Mở Google Sheet → Extensions → Apps Script
2
Tìm phần config ở đầu code:
const LARK_WEBHOOK_URL = ''; // Paste webhook ở đây
const LARK_USERS = {
hr: '', // Email Lark của HR
tpmkt: '', // Email Lark của TPMKT
director: '' // Email Lark của Giám đốc
};
Sửa thành:
const LARK_WEBHOOK_URL = 'https://open.larksuite.com/open-apis/bot/v2/hook/xxx-xxx-xxx';
const LARK_USERS = {
hr: 'hr@kitabooks.com',
tpmkt: 'tpmkt@kitabooks.com',
director: 'gd@kitabooks.com'
};
3
Lưu code (Ctrl+S) → Deploy New Version
Apps Script → Deploy → Manage Deployments → ✏️ Edit → New Version → Deploy
👥 Cách lấy Email Lark của thành viên
1
Mở Lark → Click vào avatar người đó
2
Xem mục "Email" trong profile
Đây là email đăng ký Lark (thường giống email công ty). Copy chính xác email này vào LARK_USERS.
💡 Mention bằng email có lợi: dùng được cho Lark Suite + Lark Personal. Người dùng nhận notification trên app Lark như bị tag trực tiếp.
🧪 BƯỚC 3: Test thử
Sau khi setup + deploy, vào /cv/ upload 1 CV thử.
→ Trong group Lark sẽ nhận được card đẹp:
┌─────────────────────────────────────┐
│ 📥 CV mới chờ TPMKT duyệt │
├─────────────────────────────────────┤
│ @TPMKT │
│ │
│ 👤 Ứng viên: Nguyễn Văn A │
│ 💼 Vị trí: Junior Bậc 2 │
│ 📞 Liên hệ: 0912xxx │
│ 📝 Ghi chú: CV sạch sẽ, có ảnh. │
├─────────────────────────────────────┤
│ [✍️ Vào duyệt CV] │
└─────────────────────────────────────┘
✅ Card có nút bấm — TPMKT click 1 phát mở luôn /cv/ trên browser, không cần copy URL.
🔧 Tuỳ chỉnh thêm (advanced)
Trong code Apps Script function notifyLark() có biến events chứa template cho từng sự kiện:
- title: Tiêu đề card
- template: Màu header (blue / green / red / yellow / purple)
- mention: Email người được @ mention
- url: Nút bấm dẫn đến trang nào
- btn: Text nút bấm
Anh có thể sửa template tuỳ ý. Lark hỗ trợ Markdown, có thể dùng **bold**, danh sách, link...
📞 Troubleshoot
| Lỗi | Cách sửa |
|---|
| Không nhận tin nhắn | Check LARK_WEBHOOK_URL đã paste đúng + đã Deploy New Version |
| Card hiện nhưng không @mention | Email trong LARK_USERS sai format — phải đúng email Lark đăng ký |
| Bot bị remove khỏi group | Tạo lại bot, copy URL mới, update Apps Script |
| Bot 1 ngày spam quá | Lark giới hạn 5 tin/giây/group — đủ cho HR thông thường |