您可以預測客戶需要幫助的領域，然後在他們瀏覽您的網站一段時間時通過聊天與他們互動，從而幫助提高客戶滿意度。
請考慮下列案例，以主動開始聊天。
備註
下列案例中列出的程式碼範例使用 setContextProvider API ，該 API 只能用於未經驗證的聊天。 對於已驗證的聊天，您必須使用 JSON Web 權杖 （JWT）。 其他資訊： 傳送驗證權杖
場景 1：客戶等待時間
Amy 不小心損壞了 Surface Book，並在產品知識庫中試圖尋求答案大約 20 秒。 主動聊天請求是根據 Amy 正在瀏覽的產品頁面和在頁面上花費的時間觸發的。
Hi! Just checking in to see if I can help answer any questions you may have.
艾米可以接受聊天提議並開始對話來解決問題。
範例程式碼
<!-- Code to show proactive chat invite after visitor has spend given time on the webpage -->
<script id="Proactivechattrigger">
// Wait for Chat widget to load completely
window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
var timeToWaitBeforeOfferingProactiveChatInMilliseconds = 20000;//time to wait before Offering proactive chat to webpage visitor
// Setting context variables
Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
return {
'Proactive Chat':{'value':'True','isDisplayable':true},
'Time On Page':{'value': timeToWaitBeforeOfferingProactiveChatInMilliseconds ,'isDisplayable':true},
'Page URL':{'value': window.location.href,'isDisplayable':true},
};
});
//Display proactive chat invite after 'timeToWaitBeforeOfferingProactiveChatInMilliseconds' milliseconds
setTimeout(function(){
Microsoft.Omnichannel.LiveChatWidget.SDK.startProactiveChat({message: "Hi! Just checking in to see if I can help answer any questions you may have."}, false)
},timeToWaitBeforeOfferingProactiveChatInMilliseconds);
});
</script>
案例 2：客戶多次造訪網頁
Thomas 正在瀏覽 Microsoft Surface 社區網頁，並正在尋找有關 Microsoft Surface 設備的信息。 托馬斯曾多次訪問過某個網頁，但無法找到答案。
實現此場景後，組織向客戶提供聊天請求，其中包含以下消息。
Hi! Do you have a question on Surface device ? I am here to help.
範例程式碼
<!-- Code to show proactive chat invite(after given time) after visitor visits the webpage given number of time -->
<!-- Operations on cookies like creating cookies, deleting cookies etc.. -->
<script>
var expdate = new Date ();
expdate.setTime (expdate.getTime() + (24 * 60 * 60 * 1000*365)); // 1 yr from now
/* ####################### start set cookie ####################### */
function setCookie(name, value, expires, path, domain, secure) {
var thisCookie = name + "=" + escape(value) +
((expires) ? "; expires=" + expires.toGMTString() : "") +
((path) ? "; path=" + path : "") +
((domain) ? "; domain=" + domain : "") +
((secure) ? "; secure" : "");
document.cookie = thisCookie;
}
/* ####################### start get cookie value ####################### */
function getCookieVal (offset) {
var endstr = document.cookie.indexOf (";", offset);
if (endstr == -1)
endstr = document.cookie.length;
return unescape(document.cookie.substring(offset, endstr));
/* ####################### end get cookie value ####################### */
}
/* ####################### start get cookie (name) ####################### */
function GetCookie (name) {
var arg = name + "=";
var alen = arg.length;
var clen = document.cookie.length;
var i = 0;
while (i < clen) {
var j = i + alen;
if (document.cookie.substring(i, j) == arg)
return getCookieVal (j);
i = document.cookie.indexOf(" ", i) + 1;
if (i == 0) break;
}
return null;
}
/* ####################### End get cookie (name) ####################### */
/* ####################### Start delete cookie ####################### */
function DeleteCookie (name,path,domain) {
if (GetCookie(name)) {
document.cookie = name + "=" +
((path) ? "; path=" + path : "") +
((domain) ? "; domain=" + domain : "") +
"; expires=Thu, 01-Jan-70 00:00:01 GMT";
}
}
/* ####################### End of delete cookie ####################### */
/* ####################### Count number of visits to current webpage ####################### */
function VisitCounter(){
var visits = GetCookie("timesPageVisited");
if (!visits) { visits = 1;
document.write("Select a Conversation Space");
}
else {
visits = parseInt(visits) + 1;document.write("Select a Conversation Space.");}
setCookie("timesPageVisited", visits,expdate);
}
/* ####################### End of count number of visits to current webpage ####################### */
</script>
<!-- Count number of visits to current webpage -->
<script>
VisitCounter();
</script>
<script id="Proactivechattrigger">
// Wait for Chat widget to load completely
window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
// setting Context variables
Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
return {
'Proactive Chat':{'value':'True','isDisplayable':true},
'No. of visits':{'value':'2','isDisplayable':true},
'Forums':{'value':'Surface Devices','isDisplayable':true},
};
});
setTimeout(function(){
var timeToWaitBeforeOfferingProactiveChatInMilliseconds = 5000;//Time to wait before offering proactive chat to webpage visitor
var visits = GetCookie("timesPageVisited");
//Check if webpage has been visited 2 or more times by the user.
if (visits > 2) {
//Display proactive chat invite
Microsoft.Omnichannel.LiveChatWidget.SDK.startProactiveChat({message: "Hi! Do you have a question on Surface device? I am here to help."}, false);
DeleteCookie("timesPageVisited");//Delete the cookie to reset the counter
}
},timeToWaitBeforeOfferingProactiveChatInMilliseconds);
});
</script>
案例 3：客戶檢查開啟支援案例的狀態
Jacob 正在瀏覽 Microsoft Surface 裝置的支援頁面，以尋找有關開啟支援案例的詳細資訊。 Jacob 已在頁面上停留 10 秒鐘，然後會主動聊天，並附上以下訊息。
Hi! How are you doing today? The status of the case:<caseid> is in progress. Would you like to get more details?
範例程式碼
<!--Code to show proactive chat invite after visitor has spend given time on the webpage, with relevant details about user.-->
<script id="Proactivechattrigger">
// Wait for Chat widget to load completely
window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
var timeToWaitBeforeOfferingProactiveChatInMilliseconds = 10000;//Time to wait before offering proactive chat to webpage visitor
var caseId = '< your case id relevant to the user.>';//Set case id relevant to the user.
// setting Context variables
Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
return {
'Proactive Chat':{'value':'True','isDisplayable':true},
'Case Id':{'value':caseId,'isDisplayable':true}
};
});
//Show proactive chat invite after 'timeToWaitBeforeOfferingProactiveChatInMilliseconds' milliseconds
setTimeout(function(){
Microsoft.Omnichannel.LiveChatWidget.SDK.startProactiveChat({message: "Hi! How are you doing today? The status of the case: " + caseId + " is in progress. Would you like to get more details?"}, false)
},timeToWaitBeforeOfferingProactiveChatInMilliseconds);
});
</script>
案例 4：客戶在網頁上花費一些時間後嘗試離開網頁
Amy 已經瀏覽了 15 秒的網頁，對可用資訊不滿意。 當 Amy 即將在網頁瀏覽器上切換索引標籤時，會向 Amy 傳送包含下列訊息的主動聊天請求。
Hi! Just checking in to see if I can help answer any questions you may have.
範例程式碼
//Code to show proactive chat invite when visitor tries to leave page after spending given time (15 seconds in this case) on the webpage. This invite is offered once and only for the first time. All subsequent tries to leave page are ignored and proactive chat is not offered in them.
<script id="Proactivechattrigger">
//Track if proactive chat has been already offered to the visitor
var hasProactiveChatBeenOffered = false;
//Wait for Chat widget to load completely
window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
var timeToWaitBeforeEnablingOfferingProactiveChatInMillisecondsOnLeaving = 15000; //Time to wait before Offering proactive chat to webpage visitor
//Enable showing proactive chat invite on leaving page after browsing page for 'timeToWaitBeforeEnablingOfferingProactiveChatInMillisecondsOnLeaving' milliseconds
setTimeout(function(){
//Show proactive chat invite on leaving page
window.document.body.onmouseleave = function(){
//Offer proactive chat if it has not been offered earlier during this visit
if( hasProactiveChatBeenOffered == false )
{
// Set this to true as proactive chat has been almost offered.
hasProactiveChatBeenOffered = true;
//Setting Context variables
Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
return {
'Proactive Chat':{'value':'True','isDisplayable':true},
'Page URL':{'value': window.location.href,'isDisplayable':true},
};
});
//Offer proactive chat
Microsoft.Omnichannel.LiveChatWidget.SDK.startProactiveChat({message: "Hi! Just checking in to see if I can help answer any questions you may have."}, false);
}
};
},timeToWaitBeforeEnablingOfferingProactiveChatInMillisecondsOnLeaving);
});
</script>
案例 5：客戶瀏覽了另一個網頁，然後在目前網頁上花費時間
Amy 已瀏覽該產品的常見問題解答文檔，目前在知識庫頁面上停留超過 15 秒。 Amy 主動獲得聊天會話，並附有以下訊息。
Hi! Just checking in to see if I can help answer any questions you may have.
範例程式碼
//Code to show proactive chat invite when visitor spends given time on current page, after coming from given last visited page
<script id="Proactivechattrigger">
var lastVisitedPage = "www.contoso.com/FAQ";// last visited page. A visitor coming form this page will be shown proactive chat invite after given time on current page
// Wait for Chat widget to load completely
window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
var timeToWaitBeforeOfferingProactiveChat = 15000;//Time to wait before Offering proactive chat to webpage visitor
//Check if referrer page( read: https://www.w3schools.com/jsref/prop_doc_referrer.asp ) is same as last Visited page
if( window.document.referrer == lastVisitedPage) )
{
//Show proactive chat invite after browsing page for 'timeToWaitBeforeOfferingProactiveChat' milliseconds
setTimeout(function(){
//Setting Context variables
Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
return {
'Proactive Chat':{'value':'True','isDisplayable':true},
'Page URL':{'value': window.location.href,'isDisplayable':true},
'Last Page URL':{'value': window.document.referrer,'isDisplayable':true}
};
});
//Offer proactive chat
Microsoft.Omnichannel.LiveChatWidget.SDK.startProactiveChat({message: "Hi! Just checking in to see if I can help answer any questions you may have."}, false);
},timeToWaitBeforeOfferingProactiveChat);
}
});
</script>
案例 6：客戶從特定地理區域登入
Klarissa 從 Ruritania 登錄您的網站，您的公司正在為產品提供特別折扣。 您可以為來自特定位置的客戶設定觸發器，以主動啟動聊天工作階段。 系統會提示 Klarissa 聊天，並顯示以下訊息。
Hi! Just checking in to see if I can help answer any questions you may have.
範例程式碼
此範例程式碼示範如何使用 Bing 的地理位置 API 來瞭解客戶的地理區域，並據此提供聊天要求。 Bing 位置 API 的詳細資訊： Bing 地圖服務位置 API。
//Code to show proactive chat invite if visitor is visiting the page in a particular country or region
<script id="Proactivechattrigger">
// Wait for Chat widget to load completely
window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
var countryNameWhereProactiveChatInviteShouldBeOffered = 'Ruritania';//Country name where proactive chat invite should be offered, if user is visiting webpage from this country
// Get Country name using Bing Geolocation API and proactively offer chat if visitor's country matches with given country name
function GetCountryUsingBingGeoLocationAPIAndOfferProactiveChatIfVisitorCountryMatchesWithGivenCountry( latitude, longitude, bingMapApiKey, countryToMatch) {
var xhttp = new XMLHttpRequest();
xhttp.onreadystatechange = function() {
if (this.readyState == 4)
if(this.status == 200) {
console.log(this.responseText);
var currentCountryName = JSON.parse(this.responseText).resourceSets[0].resources[0].address.countryRegion;
//Check if visitor's country matches with given Country name
if( currentCountryName == countryToMatch){
alert(currentCountryName);
// setting Context variables
Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
return {
'Proactive Chat':{'value':'True','isDisplayable':true},
'Country':{'value': currentCountryName ,'isDisplayable':true},
'Page URL':{'value': window.location.href,'isDisplayable':true},
};
});
//Show proactive chat invite
Microsoft.Omnichannel.LiveChatWidget.SDK.startProactiveChat({message: "Hi! Just checking in to see if I can help answer any questions you may have."}, false);
}
}
else{
console.log("Bing Geolocation API call has failed and returned error: " + this.statusText);
}
};
xhttp.open("GET", 'https://dev.virtualearth.net/REST/v1/Locations/'+ latitude +','+ longitude +'?key='+ bingMapApiKey, true);
xhttp.setRequestHeader("Content-type", "application/json");
xhttp.send();
}
//fetching latitude and longitude is success
function successGetlatLong(position) {
var latitude = position.coords.latitude;
var longitude = position.coords.longitude;
console.log('Your latitude is :'+latitude+' and longitude is '+longitude);
//convert current loaction to a country/ region via Bing Geolocation APIs
var bingMapApiKey = 'Enter your Bing Map API key';// Get Bing Map API key here : https://learn.microsoft.com/bingmaps/getting-started/bing-maps-dev-center-help/getting-a-bing-maps-key
GetCountryUsingBingGeoLocationAPIAndOfferProactiveChatIfVisitorCountryMatchesWithGivenCountry( latitude, longitude, bingMapApiKey, countryNameWhereProactiveChatInviteShouldBeOffered);// get Country name using Bing Geolocation API and offer proctiveChat if visitor's country matches with Country name where proactive chat invite should be offered
}
//fetching latitude and longitude has failed
function errorGetlatLong() {
console.log('It seems browser was not allowed to access location. Please allow browser to access location.');
}
//fetch latitude and longitude via browser
if (navigator.geolocation) {
navigator.geolocation.getCurrentPosition(successGetlatLong, errorGetlatLong);
} else {
console.log('It seems like Geolocation, which is required for this page, is not enabled in your browser. Please use a browser which supports it.');
}
});
</script>
案例 7：在特定時段內主動向客戶提供聊天
假設您的組織在特定日期之間進行節日促銷，並且您想要主動向客戶提供聊天請求，看看他們是否有任何問題。
範例程式碼
下列範例程式碼顯示如何在客戶在一段時間內造訪您的網站時主動向他們提供聊天邀請。
//Code to show proactive chat invite if visitor visits webpage between given time period
<script id="Proactivechattrigger">
// Wait for Chat widget to load completely
window.addEventListener("load", function handleLivechatReadyEvent(){//lcw:ready
var startTimeOfTimePeriod = new Date('01 Jan 2019 00:00:00 GMT');//start time of time period in which proactive chat will be shown to webpage visitor
var endTimeOfTimePeriod = new Date('01 Jan 2100 00:00:00 GMT');//end time of time period in which proactive chat will be shown to webpage visitor
var currentDateTime = new Date();//current date and time
//Make sure that endTimeOfTimePeriod is always greater and equal to startTimeOfTimePeriod
if( endTimeOfTimePeriod < startTimeOfTimePeriod)
{
console.log("The time period given for proactive chat has start time: " + startTimeOfTimePeriod.toGMTString() + " more that the end time: " + endTimeOfTimePeriod.toGMTString() + " of time period. So, proactive chat will not be offered.");
return;
}
//Check if current date time is between given time period
if( startTimeOfTimePeriod < currentDateTime && endTimeOfTimePeriod > currentDateTime){
// setting Context variables
Microsoft.Omnichannel.LiveChatWidget.SDK.setContextProvider(function contextProvider(){
return {
'Proactive Chat':{'value':'True','isDisplayable':true},
'Page URL':{'value': window.location.href,'isDisplayable':true},
};
});
//Show proactive chat invite
Microsoft.Omnichannel.LiveChatWidget.SDK.startProactiveChat({message: "Hi! Just checking in to see if I can help answer any questions you may have."}, false);
}
});
</script>
案例 8：主動向客戶提供具有預先問卷的聊天
假設您的組織想要同意授權來開始與客戶聊天，或想要在將工作階段路由給適當的客服專員之前詢問與客戶查詢相關的主題。
範例程式碼
下列範例程式碼顯示如何主動向客戶提供具有問卷前問題的聊天。
window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
Microsoft.Omnichannel.LiveChatWidget.SDK.startProactiveChat(
"Hi! How are you doing today? Do you wish to start a chat?",
true);
});
相關信息
startProactiveChat API
管理自訂內容中了解詳細資訊
開始聊天
顯示自訂上下文
即時聊天 JavaScript API 參考