Pango AIPango AI Team
Module 04: Chatbot Widget (Embed)
Module 04 • CRM & Web Embed SDK

Case Study Thực Tế 2: VUS CRM (V-Buddy AI Assistant)

Hệ thống Anh Văn Hội Việt Mỹ (VUS) đã tích hợp trợ lý ảo mang tên V-Buddy vào phần mềm quản lý quan hệ học viên nội bộ (VUS CRM). Trợ lý ảo đồng hành cùng đội ngũ tư vấn viên tuyển sinh (Educational Advisors) và chuyên viên tiếp thị qua điện thoại (Telemarketing - TMK) để tra cứu học phí, chính sách ưu đãi, vị trí cơ sở và kịch bản chăm sóc học viên tức thì.


1. Điểm Khác Biệt Trong Thiết Kế Của VUS

  1. Tự Động Kích Hoạt (Zero-config Auto Mount): Script của VUS được cấu hình tự động tải và hiển thị bong bóng chat tròn ở góc dưới màn hình ngay khi chèn thẻ <script>, không bắt buộc phải gọi hàm init() thủ công.
  2. Phân Quyền Chi Tiết Cho Đội Ngũ TMK (extraInfo): Dữ liệu tài khoản của Agent được bổ sung thông tin phòng ban (CRM_TMK), vai trò (CRM_TMK_AGENT) và mã đội ngũ (teamId: "T-01") để AI điều chỉnh văn phong trả lời phù hợp với kịch bản của từng bộ phận.
  3. Chống Che Khuất Thanh Tổng Đài Cuộc Gọi (setOffset): Trên giao diện CRM của VUS có thanh điều khiển cuộc gọi VoIP (Softphone Toolbar) nằm cố định ở đáy màn hình. Widget V-Buddy sử dụng hàm setOffset để nâng cao vị trí bong bóng chat, tránh hoàn toàn hiện tượng che khuất nút nhận cuộc gọi.

2. Thẻ Nhúng SDK Script Cho VUS CRM

Team CRM của VUS chỉ cần chèn một dòng thẻ script trước thẻ đóng </body> của trang web quản trị:

Nhúng Script V-Buddy vào VUS CRM
<script src="https://vus-staging.pango-chat-widget-1aj.pages.dev/widget.js"></script>

Tự Động Sẵn Sàng

Ngay sau khi thẻ script tải xong, biến toàn cục window.pcw sẽ sẵn sàng hoạt động và bong bóng chat hình tròn sẽ tự động xuất hiện ở góc dưới bên phải màn hình.


3. Cấu Trúc Payload Phân Quyền TMK Agent

Khi tư vấn viên đăng nhập vào CRM hoặc mở hồ sơ học viên, hệ thống CRM gọi setPayload để truyền định danh phiên và ngữ cảnh người dùng:

window.pcw.setPayload({
  externalPrivateKey: "vus_secure_token_2026",
  account: {
    id: "737a445da12ddbd3d5d40a88ee314864",
    username: "TMK 1 - Nguyễn Thị Mai",
    mainEmail: "tmk1@vus.edu.vn",
    mainPhone: "0902442992",
    extraInfo: {
      department: "CRM_TMK",
      role: "CRM_TMK_AGENT",
      teamId: "T-01",
      assignedCampus: "HCM_HTP2"
    }
  }
});

Dữ liệu này giúp V-Buddy:

  • Nhận diện đúng chi nhánh cơ sở mà Agent đang phụ trách (assignedCampus).
  • Đưa ra kịch bản xử lý từ chối và nhắc hẹn theo đúng quy chuẩn của bộ phận TMK (đã đồng bộ tại Collection vus_business_sop).

4. Các Kỹ Thuật Điều Khiển Chuyên Biệt Trên VUS CRM

4.1. Nâng Vị Trí Tránh Thanh Cuộc Gọi VoIP (setOffset)

Để bong bóng chat không che mất thanh quay số của tổng đài:

// Đẩy widget cách mép phải 24px và mép đáy 90px (nằm phía trên Softphone Toolbar)
window.pcw.setOffset(24, 90);

4.2. Mở Chat Khi Bấm Nút "Hỏi V-Buddy" Trên Hồ Sơ Học Viên

Trên mỗi trang chi tiết thông tin học viên, VUS đặt một nút bấm nhanh:

<button 
  class="btn-ask-vbuddy" 
  onclick="askVBuddyAboutStudent('STUDENT_10928')">
  Hỏi Trợ Lý V-Buddy Về Học Viên Này
</button>

<script>
function askVBuddyAboutStudent(studentId) {
  if (window.pcw) {
    // 1. Cập nhật mã hội thoại theo học viên
    window.pcw.setPayload({
      conversation: {
        conversationId: `STUDENT_PROFILE_${studentId}`
      }
    });

    // 2. Mở bung cửa sổ chat ngay lập tức
    window.pcw.open();
  }
}
</script>

4.3. Tàng Hình Widget Trên Các Màn Hình Cấu Hình (hide / show)

Khi nhân viên chuyển sang tab báo cáo doanh thu hoặc quản trị phân quyền hệ thống:

// Khi chuyển sang trang Báo Cáo Doanh Thu
crmRouter.on('/reports', () => {
  window.pcw?.hide(); // Tàng hình hoàn toàn cả bong bóng chat
});

// Khi quay lại trang Chăm Sóc Khách Hàng
crmRouter.on('/leads', () => {
  window.pcw?.show(); // Hiển thị trở lại
});

5. Giá Trị Đạt Được Tại VUS

  • Thời gian tra cứu thông tin khóa học & học phí: Giảm từ 2 - 3 phút (khi phải mở file Excel bảng giá) xuống còn 3 giây khi hỏi trực tiếp V-Buddy trên Widget.
  • Tỷ lệ thao tác thành công: 100% tư vấn viên sử dụng Widget hàng ngày mà không gặp bất kỳ lỗi xung đột giao diện nào với các phần mềm quản trị sẵn có.