setContextProvider

Bán hàng đa kênh cho Customer Service cung cấp một bộ khả năng nâng sức mạnh của Dynamics 365 Customer Service Enterprise để cho phép các tổ chức kết nối và tương tác với khách hàng ngay tức thì trên các kênh nhắn tin kỹ thuật số. Cần có giấy phép bổ sung để truy cập Bán hàng đa kênh cho Customer Service. Để biết thêm thông tin, hãy xem các trang Tổng quan về giá của Dynamics 365 Customer Service và Gói giá của Dynamics 365 Customer Service.

Đặt nhà cung cấp ngữ cảnh cho các kênh trò chuyện trực tiếp. Hàm cung cấp ngữ cảnh, khi được gọi, trả về ngữ cảnh được sử dụng để khởi tạo một phiên trò chuyện.

Quan trọng

  • Phương thức setContextProvider chỉ được hỗ trợ cho cuộc trò chuyện chưa được xác thực. Đối với cuộc trò chuyện được xác thực, bạn phải sử dụng Mã thông báo web JSON (JWT). Thông tin thêm: Gửi mã thông báo xác thực
  • Bạn chỉ có thể chuyển 100 biến ngữ cảnh tùy chỉnh trong mỗi phiên trò chuyện.
  • Các phương thức SDK live chat sẽ được gọi sau khi sự kiện lcw:ready được đưa ra. Bạn có thể lắng nghe sự kiện này bằng cách thêm trình nghe sự kiện của riêng bạn trên đối tượng cửa sổ.
  • Bạn không cần sử dụng phương thức này setContextProvider nếu bạn đang sử dụng startChat API SDK để chuyển ngữ cảnh và khởi tạo phiên trò chuyện.

Cú pháp

Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(contextProvider);

Thông số

Thông số Type Description
contextProvider Chức năng mà khi được gọi, sẽ trả về ngữ cảnh tùy chỉnh

Giá trị trả về

Không ai

Example

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
        // Set the custom context provider
        // Throws error if contextProvider is not a function
        Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
                   //Here it is assumed that the corresponding work stream would have context variables with logical name of 'contextKey1', 'contextKey2', 'contextKey3'. If no context variable exists with a matching logical name, items are created assuming Type:string               
	               return {
                             'contextKey1': {'value': 'contextValue1', 'isDisplayable': true},
                             'contextKey2': {'value': 12.34, 'isDisplayable': false},
                             'contextKey3': {'value': true}
                   };
        });
});

Trong mã mẫu trước, thuộc tính chứa value giá trị của các biến ngữ cảnh.

Thuộc isDisplayable tính, nếu được đặt thành , truesẽ hiển thị các mục được chuyển trong tab thứ ba trên Kiểm soát Tóm tắt Cuộc hội thoại cho một cuộc hội thoại.

Lưu ý

Nếu không có biến ngữ cảnh nào được tạo trong luồng công việc trực tiếp với tên logic phù hợp, thì các biến sẽ được tạo trong thời gian chạy với loại String. Thông tin thêm: Biến ngữ cảnh

Hiển thị các phím ngữ cảnh.

Chuyển dịch vụ tự phục vụ của khách hàng theo ngữ cảnh

Bạn có thể chuyển dịch vụ tự phục vụ của khách hàng làm ngữ cảnh khi bắt đầu cuộc trò chuyện với khách hàng đó. Phương pháp này setContextProvider chuyển các hành động của khách hàng gần đây như một phần của ngữ cảnh với loại tự phục vụ, cho một cuộc trò chuyện mới giữa khách hàng và tổng đài viên. Bản ghi hành trình của khách truy cập được tạo cho mỗi hành động tự phục vụ.

Dưới đây là mã mẫu cho thấy cách sử dụng phương thức này setContextProvider .

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){

Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
    return {
            'SelfService': { 'value' : 
                '[ {"msdyn_displaytitle":"Page visited", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350000}, \
                   {"msdyn_displaytitle":"Phrase searched", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350001}, \
                   {"msdyn_displaytitle":"Knowledge article viewed", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350002}, \
                   {"msdyn_displaytitle":"Custom action performed", "msdyn_starttime":"yyyy-mm-ddThh:mm:ssZ","msdyn_type":192350003} \
                 ]'
             }, // Additional context can be added as shown below
                //Here it is assumed that the corresponding work stream would have context variables with logical name of 'contextKey1', 'contextKey2', 'contextKey3'. If no context variable exists with a matching logical name, items are created assuming Type:string
                'contextKey1': {'value': 'contextValue1', 'isDisplayable': true},
                'contextKey2': {'value': 12.34, 'isDisplayable': false},
                'contextKey3': {'value': true}
         };
    });
});

Đối với tập lệnh mẫu để theo dõi các hành động tự phục vụ có thể được đưa vào Cổng thông tin tự phục vụ, hãy xem mã mẫu Tự phục vụ.

Mã lỗi

Lỗi sau có thể xảy ra đối với phương pháp này.

Mã lỗi Thông báo lỗi
1 Thực thi phương thức cung cấp ngữ cảnh không thành công

Tài liệu tham khảo API JavaScript cho SDK trò chuyện trực tiếp
Hiển thị ngữ cảnh tùy chỉnh

  • Last updated on