Tích hợp Mattermost

Tích hợp Mattermost cho phép CNV Connect gửi thông báo tự động đến các kênh Mattermost khi có sự kiện quan trọng trong hệ thống.

Truy cập

Vào menu Cài đặt > Mattermost trên thanh sidebar.

Tổng quan

Mattermost là nền tảng nhắn tin nội bộ của công ty. Tích hợp này giúp:

• Nhận thông báo khi có đơn nghỉ phép mới
• Biết khi deal chuyển giai đoạn
• Theo dõi lệnh triển khai mới
• Nhận cảnh báo hóa đơn quá hạn
• Thông báo chấm công bất thường

Thiết lập kết nối

Bước 1: Tạo Incoming Webhook trên Mattermost

1. Đăng nhập Mattermost với quyền Admin
2. Vào Main Menu > Integrations > Incoming Webhooks
3. Nhấn Add Incoming Webhook
4. Điền thông tin:
   • Title: CNV Connect
   • Description: Thông báo từ hệ thống CNV Connect
   • Channel: Chọn kênh nhận thông báo mặc định
5. Nhấn Save
6. Sao chép Webhook URL

Bước 2: Cấu hình trong CNV Connect

1. Tại Cài đặt > Mattermost
2. Dán Webhook URL vào trường tương ứng
3. Nhấn Kiểm tra kết nối để xác nhận
4. Nếu thành công, sẽ hiển thị "Đã kết nối" và gửi tin nhắn thử đến kênh Mattermost
5. Nhấn Lưu

Mẹo

Tạo kênh riêng cho từng loại thông báo. Ví dụ: #thong-bao-nghi-phep, #thong-bao-deal, #thong-bao-trieu-khai. Điều này giúp mềm thông báo không bị lẫn và dễ theo dõi.

Cấu hình thông báo

Chọn sự kiện thông báo

Tại trang cấu hình Mattermost, bật/tắt các sự kiện:

Module HR

Sự kiện	Mô tả	Kênh
Đơn nghỉ phép mới	Khi nhân viên gửi đơn nghỉ phép	Tùy chọn
Nghỉ phép được duyệt	Khi đơn được duyệt/từ chối	Tùy chọn
Chấm công bất thường	Đi trễ, về sớm, thiếu check-out	Tùy chọn
Nhân viên mới	Khi thêm nhân viên vào hệ thống	Tùy chọn

Module CRM

Sự kiện	Mô tả	Kênh
Deal mới	Khi tạo deal mới	Tùy chọn
Deal thắng/thua	Khi deal được chốt	Tùy chọn
Lead mới	Khi có lead mới vào hệ thống	Tùy chọn
Hóa đơn quá hạn	Khi hóa đơn vượt hạn thanh toán	Tùy chọn
Thanh toán mới	Khi ghi nhận thanh toán	Tùy chọn

Module Fulfillment

Sự kiện	Mô tả	Kênh
Lệnh mới	Khi tạo lệnh triển khai mới	Tùy chọn
Chuyển giai đoạn	Khi lệnh chuyển giai đoạn	Tùy chọn
Lệnh quá hạn	Khi lệnh vượt deadline	Tùy chọn
Hoàn tất triển khai	Khi lệnh được đóng	Tùy chọn

Cấu hình kênh cho từng sự kiện

1. Tại mỗi sự kiện, nhấn Cấu hình
2. Chọn kênh Mattermost nhận thông báo
3. Tùy chỉnh nội dung tin nhắn (nếu cần)
4. Nhấn Lưu

Định dạng tin nhắn

Tin nhắn gửi đến Mattermost có định dạng:

**[CNV Connect] Đơn nghỉ phép mới**
- Nhân viên: Nguyễn Văn A
- Loại phép: Phép năm
- Từ ngày: 15/04/2026
- Đến ngày: 17/04/2026
- Lý do: Việc gia đình
[Xem chi tiết](https://connect.cnvwork.com/leaves/123)

Tùy chỉnh nội dung

1. Tại cấu hình sự kiện, nhấn Tùy chỉnh tin nhắn
2. Sử dụng placeholder để chèn dữ liệu động
3. Hỗ trợ Markdown của Mattermost
4. Xem trước và lưu

Nhiều kênh thông báo

Có thể gửi thông báo đến nhiều kênh:

1. Tạo nhiều Incoming Webhook trên Mattermost (mỗi kênh 1 webhook)
2. Tại CNV Connect, thêm webhook cho từng kênh
3. Gán sự kiện vào kênh phù hợp

Ví dụ:

• #hr-general: thông báo nghỉ phép, nhân viên mới
• #sales-team: deal mới, lead mới, thanh toán
• #fulfillment: lệnh triển khai, trạng thái
• #finance: hóa đơn, thanh toán, quá hạn

Lưu ý

Mỗi kênh Mattermost cần một Incoming Webhook riêng. Liên hệ Admin Mattermost để tạo webhook.

Tắt thông báo tạm thời

Tắt từng sự kiện

1. Tại cấu hình, tắt toggle của sự kiện không muốn nhận
2. Nhấn Lưu

Tắt toàn bộ

1. Nhấn Tắt tất cả thông báo ở đầu trang
2. Xác nhận
3. Có thể bật lại bất cứ lúc nào

Lưu ý

Khi tắt thông báo, các sự kiện vẫn xảy ra trong hệ thống nhưng không gửi tin đến Mattermost. Đảm bảo có kênh thông báo thay thế (email, Dashboard) khi tắt Mattermost.

Xử lý lỗi

Lỗi	Nguyên nhân	Xử lý
"Không gửi được tin nhắn"	Webhook URL sai hoặc hết hạn	Kiểm tra và cập nhật Webhook URL
"Kênh không tồn tại"	Kênh đã bị xóa trên Mattermost	Cập nhật kênh mới
"Không có quyền"	Webhook bị tắt quyền	Kiểm tra cấu hình trên Mattermost
Tin nhắn bị trễ	Mattermost quá tải	Kiểm tra tình trạng server Mattermost

Mẹo

Kiểm tra trạng thái kết nối định kỳ bằng cách nhấn Kiểm tra kết nối trên trang cài đặt. Nếu mất kết nối, hệ thống sẽ hiển thị cảnh báo.