
ã第564åã Agentforce ïŒ ãµãŒãã¹ãšãŒãžã§ã³ãã®ã¹ã¿ãŒã¿ãŒããã³ããå®è£
Agentforce Service Agent ã Web ãµã€ãã«é 眮ããå Žåãé垞㯠Salesforce ã® Enhanced Web Chat v1 or v2 ãå©çšããŠãæšæºã®ãã£ãããã¿ã³ããäŒè©±ãéå§ããŸãã
ããããå®éã® Web ãµã€ãã§ã¯ãæåããèªç±å ¥åã®ãã£ããç»é¢ãéãã®ã§ã¯ãªãã
ãµãŒãã¹ã«ã€ããŠç¥ããã
æéã«ã€ããŠç¥ããã
æ åœè ã«çžè«ããã
ãšãã£ãéžæè¢ãæåã«è¡šç€ºãããŠãŒã¶ãŒãç®çãéžæããŠãã Agentforce ãšã®äŒè©±ãéå§ãããã±ãŒã¹ããããšæããŸãã
ä»åã¯ããã®ãããªÂ ç¬èªã®ã¹ã¿ãŒã¿ãŒããã³ããä»ãéå§ç»é¢Â ã Web ãµã€ãåŽã«äœæãããããã Agentforce Service Agent ãšã®äŒè©±ãéå§ããæ¹æ³ã玹ä»ããŸãã

ä»åã®æ€èšŒã§ããã®ãããªãã®ãäœæããããšãããšãã« Agentforce èªäœãæ¹ä¿®ãã話ã§ã¯ãªã ãšããããšã«æ°ã¥ããŸã§æéãããããŸããã
Agentforce Builder ãªã©ã倿ŽããŠç¬èªã®éå§ç»é¢ãäœãã®ã§ã¯ãªããWebãµã€ãåŽã«ç¬èªã® UI ãäœæããEnhanced Web Chat ãæäŸãã JavaScript API ãå©çšã㊠Agentforce ãšã® Conversation ãéå§ããŸãã
ãã®éããæåã«çè§£ããŠããããšããä»åã®å®è£ ã§ã¯éåžžã«éèŠã§ããã
å®çŸãããããš
ä»åäœæããã®ã¯ãäŸãã°ä»¥äžã®ãããªéå§ç»é¢ã§ãã
Online Support
äœããæäŒãããŸããããïŒ
ã» [ ãµãŒãã¹ã«ã€ããŠç¥ããã ]
ã» [ æéã«ã€ããŠç¥ããã ]
ã» [ æ åœè ã«çžè«ããã ]
----------- ãŸã㯠-----------
[ ã¡ãã»ãŒãžãå ¥å... ] [éä¿¡]
ãã®ç»é¢èªäœã¯ Salesforce ã® Enhanced Web Chat ã®äžã«äœããã®ã§ã¯ãããŸããããã®ãã㪠UI ãäœæããèšå®ç»é¢ã¯ãããŸããã
ãã£ãŠãéåžžã® HTMLãCSSãJavaScript ãå©çšããŠãWeb ãµã€ãåŽã«äœæããç¬èªã® UI ãšãªããŸãã
äŸãã°ããŠãŒã¶ãŒãã
æéã«ã€ããŠç¥ããã
ãã¯ãªãã¯ãããšã
ã¹ã¿ãŒã¿ãŒããã³ãããã¯ãªãã¯
â
Enhanced Web Chat ãèµ·å
â
Agentforce ã Conversation ã«åå
â
ãæéã«ã€ããŠç¥ããããã ãŠãŒã¶ãŒã®æåã®ã¡ãã»ãŒãžãšããŠéä¿¡
â
Agentforce ã åç
ãšããæµãã«ãªããŸãã
ãã¡ãããèªç±å ¥åæ¬ããå ¥åãããã¡ãã»ãŒãžã«ã€ããŠããåãä»çµã¿ã§ Agentforce ãžæž¡ãããšãã§ããŸãã
Agentforce ãæ¹ä¿®ããå¿ èŠã¯ãªã
ä»åãæåã¯ãAgentforce ã®éå§ç»é¢ãã«ã¹ã¿ãã€ãºããããšãã芳ç¹ããæ¹æ³ãæ¢ããŠããŸããã
ãã®ããã
Agentforce Builder
Enhanced Web Chat ã® UI
Lightning Web Components
Custom Lightning Types
äºåãã£ãã
ãªã©ãSalesforceåŽã®ã«ã¹ã¿ãã€ãºæ¹æ³ãäžå¿ã«èª¿æ»ããŠããŸããã
ããããä»åå®çŸãããããšãæŽçãããšã倿Žãããã®ã¯ Agentforce ãšã®Conversation ãå§ãŸã£ãåŸã®ç»é¢ã§ã¯ãããŸããã
Conversation ãéå§ããåã® Web äœéšã倿ŽããããšããèŠä»¶ã§ãã
ã€ãŸãã
Web ãµã€ã
â
ç¬èªã®éå§ç»é¢
â
Enhanced Web Chat
â
Agentforce
ãšããæ§æã«ããã°ããããšãåãããŸããã
Salesforce ã® Enhanced Web Chat ã«ã¯ãWeb ãµã€ããããã£ãããèµ·åãã JavaScript API ãçšæãããŠããŸãã
ãã®ãããAgentforce åŽã«ç¹æ®ãªéå§ç»é¢ãå®è£ ããã®ã§ã¯ãªããWeb ãµã€ãåŽã§ Enhanced Web Chat API ãå©çšããããšã§å®çŸã§ããŸãã
launchChat() ã§ Enhanced Web Chat ãèµ·å
ä»åã®å®è£ ã§æåã«å©çšããã®ãã
embeddedservice_bootstrap.utilAPI.launchChat()ã§ãã
launchChat() ãå©çšãããšãSalesforce æšæºã®ãã£ãããã¿ã³ããŠãŒã¶ãŒãã¯ãªãã¯ããªããŠããWeb ãµã€ãåŽã® JavaScript ãã Enhanced Web Chat ãèµ·åã§ããŸãã
ãã®ããã
Salesforce æšæºãã£ãããã¿ã³
ã§ã¯ãªãã
ç¬èªã®ã¹ã¿ãŒã¿ãŒããã³ãã
ç¬èªã®ãã¿ã³
ç¬èªã® Web UI
ã Enhanced Web Chat ã®å ¥å£ãšããŠå©çšã§ããŸãã
ä»åã®ãããªç¬èªã®éå§ç»é¢ãäœãå Žåã¯ãSalesforce æšæºã®ãã£ãããã¿ã³ãæåããé衚瀺ã«ããããšãã§ããŸãã
embeddedservice_bootstrap.settings.hideChatButtonOnLoad = true;ãããŠç¬èª UI ããã
embeddedservice_bootstrap.utilAPI.launchChat();ãå®è¡ããŸãã
ããã«ãã£ãŠã
ç¬èª UI
â
launchChat()
â
Enhanced Web Chat
ãšããæµããäœãããšãã§ããŸãã
ã¹ã¿ãŒã¿ãŒããã³ãããAgentforceãžéä¿¡
Enhanced Web Chatãéãã ãã§ããã° launchChat() ã ãã§å®çŸã§ããŸãã
ãããä»åã¯ãäŸãã°ã
æéã«ã€ããŠç¥ããã
ãšããã¹ã¿ãŒã¿ãŒããã³ãããéžæããå Žåããã®å 容ããã®ãŸãŸAgentforceãšã®æåã®äŒè©±ãšããŠå©çšããããšæããŸãã
Enhanced Web Chat v2ã§ã¯ã
embeddedservice_bootstrap.utilAPI.sendTextMessage()ãå©çšããŠããŠãŒã¶ãŒã®çºè©±ãéä¿¡ã§ããŸãã
äŸãã°ã
embeddedservice_bootstrap.utilAPI.sendTextMessage(
"æéã«ã€ããŠç¥ããã"
);ãšããããšã§ããã®å 容ããŠãŒã¶ãŒããã®ã¡ãã»ãŒãžãšããŠAgentforceãžæž¡ãããšãã§ããŸãã
ããã«ãã£ãŠã
ã¹ã¿ãŒã¿ãŒããã³ãã
â
launchChat()
â
sendTextMessage()
â
Agentforce
ãšããæ§æãå¯èœã«ãªããŸãã
launchChat() çŽåŸã®ã¡ãã»ãŒãžã¯å€±æã ã£ã
ä»åãå®è£ æã«æåã«ã€ãŸã¥ããã®ãããã§ããã
æåã¯åçŽã«ã
await embeddedservice_bootstrap.utilAPI.launchChat();
await embeddedservice_bootstrap.utilAPI.sendTextMessage(
"æéã«ã€ããŠç¥ããã"
);ãšããã°ãããšèããŠããŸããã
ããããå®éã«è©ŠããŠã¿ããšå®å®ããŠåäœããŸããã§ããã
launchChat() ãå®äºãããããšãã£ãŠãAgentforce ããŠãŒã¶ãŒã®ã¡ãã»ãŒãžãåãåããç¶æ ãŸã§æºåã§ããŠãããšã¯éããªãããã§ãã
Enhanced Web Chat ã®ç»é¢èªäœã¯èµ·åããŠããŠããAgentforce ããŸã Conversation ãžåå ããŠããªãã¿ã€ãã³ã°ããããŸãã
ããã§ã
setTimeout(...)ãå©çšããŠã
1ç§åŸ ã€
2ç§åŸ ã€
3ç§åŸ ã€
ãšããããšãèããããŸãã
ãããããããã¯ãŒã¯ãç°å¢ã«ãã£ãŠå¿ èŠãªæéãå€ããããããã®æ¹æ³ã§ã¯å®å®ããŸããã
ããã§å©çšããã®ã Salesforce ã®ã€ãã³ãã§ãã
onEmbeddedMessagingFirstBotMessageSent ãå©çšãã
Enhanced Web Chat ã«ã¯ããã£ããå ã§çºçããç¶æ å€åã Web ãµã€ãåŽã§åãåãããã®ã€ãã³ããçšæãããŠããŸãã
ä»åç¹ã«éèŠã ã£ãã®ãã
onEmbeddedMessagingFirstBotMessageSent
ã§ãã
ãã®ã€ãã³ãã¯ãæåã® Bot ã Conversation ã«åå ããŠãæåã®ã¡ãã»ãŒãžãéä¿¡ãããšãã«çºçããŸãã
ããã§ã
ã¹ã¿ãŒã¿ãŒããã³ãããã¯ãªãã¯
â
launchChat()
â
AgentforceãConversationãžåå
â
Agentforceãæåã®ã¡ãã»ãŒãžãéä¿¡
â
onEmbeddedMessagingFirstBotMessageSent
â
sendTextMessage()
ãšããé çªã«å€æŽããŸããã
å®è£ ãããšãäŸãã°ä»¥äžã®ããã«ãªããŸãã
let pendingMessage = null;
window.addEventListener(
"onEmbeddedMessagingFirstBotMessageSent",
async function () {
if (!pendingMessage) {
return;
}
await embeddedservice_bootstrap
.utilAPI
.sendTextMessage(
pendingMessage
);
pendingMessage = null;
}
);ã¹ã¿ãŒã¿ãŒããã³ãããã¯ãªãã¯ããæ®µéã§ã¯ãããã«ã¡ãã»ãŒãžãéä¿¡ããã
pendingMessage = "æéã«ã€ããŠç¥ããã";ãšããŠäžæçã«ä¿æããŸãã
ãã®åŸãAgentforceãæºåã§ããããšãã€ãã³ãã§ç¢ºèªããŠããã
sendTextMessage()ãå®è¡ããŸãã
ä»åã®å®è£ ã§ã¯ããã®æ¹æ³ã«å€æŽããããšã§å®å®ããŠæåã®ã¡ãã»ãŒãžãéä¿¡ã§ããããã«ãªããŸããã
ãäœç§åŸ ã€ããã§ã¯ãªãã€ãã³ããå©çšãã
ãã®å®è£ ã§éèŠãªã®ã¯ãæéã§ã¯ãªãç¶æ ãåºæºã«æ¬¡ã®åŠçãå®è¡ããããšã§ãã
äŸãã°ã
setTimeout(
function () {
sendMessage();
},
2000
);ã®ãããªå®è£ ã§ã¯ã
éä¿¡ãéãç°å¢ â 2 ç§ãå¿ èŠãªã
éä¿¡ãé ãç°å¢ â 2 ç§ã§ãè¶³ããªã
ãšããåé¡ãçºçããŸãã
äžæ¹ã
onEmbeddedMessagingFirstBotMessageSent
ãå©çšããã°ã
Agentforceã®æºåãã§ãã
â
ã¡ãã»ãŒãžéä¿¡
ãšããé çªã«ãªããŸãã
Enhanced Web Chat ã§ã¯ããã®ã»ãã«ãå€ãã®æšæºã€ãã³ããçšæãããŠããŸãã
ä»åã®ããã« Web ãµã€ãåŽãã Enhanced Web Chat ãæäœããå Žåã¯ãã§ããã ã Salesforce ãæäŸããŠããã€ãã³ããå©çšããŠåŠçãçµã¿ç«ãŠãæ¹ãå®å®ããå®è£ ã«ãªããŸãã
onEmbeddedMessagingReady ãéèŠ
Enhanced Web Chat API ã¯ãWeb ããŒãžãéããç¬éããå©çšã§ããããã§ã¯ãããŸããã
Salesforce ã«ã¯ã
onEmbeddedMessagingReady
ãšããã€ãã³ãããããŸãã
ãã®ã€ãã³ããçºçãããšãEnhanced Web Chat ã® JavaScript API ãå©çšã§ããç¶æ ã«ãªããŸãã
äŸãã°ã
let messagingReady = false;
window.addEventListener(
"onEmbeddedMessagingReady",
function () {
messagingReady = true;
}
);ãšããŠãããŸãã
ã¹ã¿ãŒã¿ãŒããã³ãããã¯ãªãã¯ããããšãã«ã
if (!messagingReady) {
return;
}ãšç¢ºèªããããšã§ãAPI ã®æºåãã§ããåã«åŠçãå®è¡ããããšãé²ããŸãã
launchChat()ã§ã¯onEmbeddedMessagingButtonCreated ã確èªãã
launchChat() ã«ã€ããŠã¯ãSalesforce ã®å ¬åŒããã¥ã¡ã³ãã§ã
onEmbeddedMessagingButtonCreated
ã®ã€ãã³ããªã¹ããŒã远å ããŠããå©çšããæ¹æ³ãæ¡å ãããŠããŸãã
äŸãã°ã
let buttonCreated = false;
window.addEventListener(
"onEmbeddedMessagingButtonCreated",
function () {
buttonCreated = true;
}
);ãšããŠãããŸãã
ã¹ã¿ãŒã¿ãŒããã³ãããã¯ãªãã¯ããéã«ã
if (!buttonCreated) {
return;
}ãšç¢ºèªããŠããã
embeddedservice_bootstrap.utilAPI.launchChat();ãå®è¡ããŸãã
Salesforce æšæºã®ãã£ãããã¿ã³ãã
hideChatButtonOnLoad = true;ã§é衚瀺ã«ããŠããŠãããã®ã€ãã³ããå©çšã§ããŸãã
sendMessage() ãš sendTextMessage() ã§å°ãè¿·ã£ã
ä»åãããäžã€åããã«ããã£ãã®ãããŠãŒã¶ãŒã®ã¡ãã»ãŒãžãéä¿¡ããAPI ã§ããã
Salesforce ã«ã¯ããŠãŒã¶ãŒãšããŠã¡ãã»ãŒãžãéä¿¡ããããã® sendMessage() ã«é¢ããå ¬åŒããã¥ã¡ã³ãããããŸãã
äžæ¹ãEnhanced Web Chat v2 ã® Context Events ã§ã¯ã
sendTextMessage()ãæäŸãããŠããŸãã
ä»åã®å®ç°å¢ã§ Developer Tools ãã確èªãããšããã
typeof embeddedservice_bootstrap.utilAPI.sendMessageã¯ã"undefined" ãšãªããsendMessage ã¯å®çŸ©ãããŠããªãããšã確èªã§ããŸããã
äžæ¹ã
typeof embeddedservice_bootstrap.utilAPI.sendTextMessageã¯ã"function" ãšãªããsendTextMessage ã¯é¢æ°ãšããŠå®çŸ©ãããŠããããšã確èªã§ããŸããã
å®éã«ã
embeddedservice_bootstrap
.utilAPI
.sendTextMessage(
"ãã¹ãã¡ãã»ãŒãž"
);ãå®è¡ãããšãEnhanced Web Chat äžã«ãŠãŒã¶ãŒã®çºèšãšããŠè¡šç€ºãããAgentforce ããã®å 容ãåä¿¡ããŸããã
ãã®ãããä»åã® Enhanced Web Chat v2 ç°å¢ã§ã¯ sendTextMessage() ãå©çšããŠããŸãã
å®è£ æã« API ã®æåãæ³å®ãšç°ãªãå Žåã¯ããã©ãŠã¶ã® Developer Tools ããã
embeddedservice_bootstrap.utilAPIã確èªããŠãå®éã«å©çšå¯èœãª API ã確èªããæ¹æ³ãæå¹ã§ããã
æ¢åã® Conversation ãèæ ®ãã
å®éã« Web ãµã€ãã§å©çšããå Žåãããäžã€èæ ®ãããã®ãæ¢å Conversation ã§ãã
äŸãã°ããŠãŒã¶ãŒã ãã§ã« Agentforce ãšäŒè©±ããŠããç¶æ ã§ Web ããŒãžãåèªã¿èŸŒã¿ãããšããŸãã
ãã®ãšãã
æ¢åã® Enhanced Web Chat
ãšã
ç¬èªã®ã¹ã¿ãŒã¿ãŒããã³ãã
ãåæã«è¡šç€ºãããã®ã¯äžèªç¶ã§ãã
ããã§å©çšã§ããã®ãã
onEmbeddedMessagingConversationOpened
ã§ãã
ãã®ã€ãã³ãã¯ãMessaging Conversation ããã©ãŠã¶ã¿ãã«ããŒãããããšãã«çºçããŸãã
äŸãã°ã
window.addEventListener(
"onEmbeddedMessagingConversationOpened",
function () {
document.getElementById(
"starterPanel"
).style.display = "none";
}
);ãšããŠããã°ãæ¢å Conversation ãããŒããããå Žåã«ãç¬èªã®éå§ç»é¢ãé衚瀺ã«ã§ããŸãã
ãæ¢å Conversation ããªãããšããã€ãã³ãã¯ãªã
ãããå®è£ æã«å°ãæ©ãã ãã€ã³ãã§ãã
Salesforceã«ã¯ã
onEmbeddedMessagingConversationOpened
ãããããã
Conversation ãååšãã
ããšã¯ã€ãã³ãã§å€æã§ããŸãã
ãããéã«ã
æ¢å Conversation ã¯ååšããŸãã
ãšããã€ãã³ãã¯ãããŸããã
ãã®ããå®çšçã§ã¯ãããŒãžãéããçŽåŸã«ã¹ã¿ãŒã¿ãŒããã³ããã衚瀺ããã®ã§ã¯ãªãã
ãµããŒããæºåããŠããŸã...ïŒPreparing support...ïŒ
ã®ãããªå°ããªããŒãã£ã³ã°è¡šç€ºãåºããŸããã
ãããŠã
onEmbeddedMessagingReady
â
çæéåŸ æ©
â
ConversationOpened ãçºçããŠããªã
â
æ°èŠãŠãŒã¶ãŒãšå€æ
â
ã¹ã¿ãŒã¿ãŒããã³ããã衚瀺
ãšããæ§æã«ããŸããã
äŸãã°ã
window.addEventListener(
"onEmbeddedMessagingReady",
function () {
setTimeout(
function () {
if (!conversationOpen) {
showStarterPanel();
}
},
2000
);
}
);ãšããèãæ¹ã§ãã
ããã§ã¯ 2 ç§çšåºŠã® Fallback Timer ãå©çšããŠããŸãã
ãã ããå ã»ã©èª¬æããã
Agentforce ãæºåã§ãããŸã§ 2 ç§åŸ ã€
ãšããåŠçãšã¯æå³ããŸã£ããç°ãªããŸãã
Agentforce ãžã®ã¡ãã»ãŒãžéä¿¡ã¯ã
onEmbeddedMessagingFirstBotMessageSent
ãšããã€ãã³ãã§å€æããŸãã
Fallback Timer ãå©çšããŠããã®ã¯ãç¬èªã®ã¹ã¿ãŒã¿ãŒããã³ããã衚瀺ããŠããã倿ããæåã® 1 åã ãã§ãã
æ±çšçã«å©çšã§ãããµã³ãã«ã³ãŒã
ãããŸã§ã®å 容ããŸãšããç°¡æçãªãµã³ãã«ã以äžã§ãã
ã©ã®ãããªãã®ãã§ãããã® ãµã³ãã«ãµã€ã ãçšæããŸããã

ãèªèº«ã® Enhanced Web Chat Deployment ããååŸãã Code Snippet ã®å€ã«çœ®ãæããŠãã¹ãããŠã¿ãŠãã ããã
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<style>
body {
font-family: Arial, sans-serif;
}
/* Loading */
#starterLoading {
position: fixed;
right: 24px;
bottom: 24px;
padding: 10px 16px;
background: #032d60;
color: #ffffff;
border-radius: 20px;
font-size: 13px;
}
/* Starter Panel */
#starterPanel {
display: none;
position: fixed;
right: 24px;
bottom: 24px;
width: 350px;
padding: 20px;
box-sizing: border-box;
background: #ffffff;
border: 1px solid #dddddd;
border-radius: 16px;
box-shadow: 0 12px 30px rgba(0,0,0,0.15);
}
#starterPanel h2 {
margin: 0 0 8px;
font-size: 20px;
}
#starterPanel p {
margin: 0 0 16px;
color: #666666;
font-size: 13px;
}
.starter-button {
width: 100%;
margin-bottom: 10px;
padding: 12px;
border: 1px solid #dddddd;
border-radius: 10px;
background: #ffffff;
cursor: pointer;
text-align: left;
}
.starter-button:hover {
background: #f5f7fa;
}
.input-area {
display: flex;
gap: 8px;
margin-top: 14px;
}
.input-area input {
flex: 1;
min-width: 0;
padding: 10px;
border: 1px solid #dddddd;
border-radius: 10px;
}
.input-area button {
padding: 10px 14px;
border: 0;
border-radius: 10px;
background: #0176d3;
color: #ffffff;
cursor: pointer;
}
@media (max-width: 480px) {
#starterPanel {
right: 12px;
bottom: 12px;
width: calc(100vw - 24px);
}
#starterLoading {
right: 12px;
bottom: 12px;
}
}
</style>
</head>
<body>
<!-- Loading -->
<div id="starterLoading">Preparing support...</div>
<!-- Starter Panel -->
<div id="starterPanel">
<h2>How can we help?</h2>
<p>Choose an option below or enter your message.</p>
<button class="starter-button" onclick="startWithMessage('Tell me about your services')">
Learn about services
</button>
<button class="starter-button" onclick="startWithMessage('Tell me about pricing')">
Learn about pricing
</button>
<button class="starter-button" onclick="startWithMessage('I would like to speak with a support representative')">
Contact customer support
</button>
<div class="input-area">
<input
id="freeText"
type="text"
placeholder="Type your message..."
onkeydown="handleKeyDown(event)"
>
<button onclick="sendFreeText()">Send</button>
</div>
</div>
<script>
let messagingReady = false;
let buttonCreated = false;
let conversationOpen = false;
let botReady = false;
let pendingMessage = null;
let sending = false;
let starterDecisionCompleted = false;
/* Enhanced Web Chat API Ready */
window.addEventListener("onEmbeddedMessagingReady", function () {
messagingReady = true;
/* Wait briefly to check whether an existing conversation is loaded */
setTimeout(function () {
if (starterDecisionCompleted) return;
starterDecisionCompleted = true;
document.getElementById("starterLoading").style.display = "none";
if (!conversationOpen) {
document.getElementById("starterPanel").style.display = "block";
}
}, 2000);
});
/* Chat Button Created */
window.addEventListener("onEmbeddedMessagingButtonCreated", function () {
buttonCreated = true;
});
/* Existing Conversation Loaded */
window.addEventListener("onEmbeddedMessagingConversationOpened", function () {
conversationOpen = true;
starterDecisionCompleted = true;
document.getElementById("starterLoading").style.display = "none";
document.getElementById("starterPanel").style.display = "none";
});
/* First Bot Message */
window.addEventListener("onEmbeddedMessagingFirstBotMessageSent", async function () {
botReady = true;
if (pendingMessage) {
await sendPendingMessage();
}
});
/* Starter Prompt */
async function startWithMessage(message) {
if (!messagingReady || !buttonCreated) return;
pendingMessage = message;
document.getElementById("starterPanel").style.display = "none";
try {
await embeddedservice_bootstrap.utilAPI.launchChat();
/* Send immediately if the bot is already ready */
if (botReady) {
await sendPendingMessage();
}
} catch (error) {
console.error("Unable to launch chat:", error);
pendingMessage = null;
document.getElementById("starterPanel").style.display = "block";
}
}
/* Send Pending Message */
async function sendPendingMessage() {
if (!pendingMessage || sending) return;
sending = true;
const message = pendingMessage;
try {
await embeddedservice_bootstrap.utilAPI.sendTextMessage(message);
pendingMessage = null;
} catch (error) {
console.error("Unable to send message:", error);
} finally {
sending = false;
}
}
/* Free Text */
function sendFreeText() {
const input = document.getElementById("freeText");
const message = input.value.trim();
if (!message) return;
startWithMessage(message);
}
/* Prevent Enter from sending a message while using an IME */
function handleKeyDown(event) {
if (event.key === "Enter" && !event.isComposing) {
event.preventDefault();
sendFreeText();
}
}
/* Enhanced Web Chat Initialization */
function initEmbeddedMessaging() {
try {
embeddedservice_bootstrap.settings.language = "en_US";
/* Hide the standard Salesforce chat launcher */
embeddedservice_bootstrap.settings.hideChatButtonOnLoad = true;
/* Replace the following values with your own deployment settings */
embeddedservice_bootstrap.init(
"YOUR_ORG_ID",
"YOUR_DEPLOYMENT_NAME",
"YOUR_ESW_URL",
{
scrt2URL: "YOUR_SCRT2_URL"
}
);
} catch (error) {
console.error("Embedded Messaging initialization failed:", error);
}
}
</script>
<!-- Replace with the bootstrap URL from your deployment -->
<script
type="text/javascript"
src="YOUR_ESW_URL/assets/js/bootstrap.min.js"
onload="initEmbeddedMessaging()"
></script>
</body>
</html>倿Žããå¿ èŠãããã®ã¯äž»ã«ä»¥äžã§ãã
YOUR_ORG_ID
YOUR_DEPLOYMENT_NAME
YOUR_ESW_URL
YOUR_SCRT2_URL
Agentforce ã®åã蟌ã¿çšã®ã³ãŒããååŸã§ããããäžã®ãµã³ãã«ã³ãŒãã«é©çšããããã«çæ AI ã«äŸé Œããã°ç°¡åã«é©çšããŠãããŸãã
ãã®ãµã³ãã«ã³ãŒãã§è¡ã£ãŠããããš
ã³ãŒãå šäœãèŠããšå°ãé·ãæããŸãããå®éã®åŠçã¯ã·ã³ãã«ã§ãã
æåã«ã
hideChatButtonOnLoad = trueã§ Salesforce æšæº Launcher ãé衚瀺ã«ããŸãã
ãã®åŸã
onEmbeddedMessagingReadyã§ Enhanced Web Chat API ãæºåãããããšã確èªããŸãã
æ¢å Conversation ãããŒããããå Žåã¯ã
onEmbeddedMessagingConversationOpenedã«ãã£ãŠç¬èªã®ã¹ã¿ãŒã¿ãŒããã³ãããé衚瀺ã«ããŸãã
æ¢å Conversation ã確èªã§ããªãã£ãå Žåã¯ã2 ç§åŸã«ã¹ã¿ãŒã¿ãŒããã³ããã衚瀺ããŸãã
ãŠãŒã¶ãŒãã¹ã¿ãŒã¿ãŒããã³ãããã¯ãªãã¯ãããšã
launchChat()ã§ Enhanced Web Chat ãéããŸãã
ãããŠã
onEmbeddedMessagingFirstBotMessageSentãåŸ ã£ãŠã
sendTextMessage()ã§éžæãããå 容ã Agentforce ãžéããŸãã
ã€ãŸãå šäœãšããŠã¯ã
WebããŒãžãéã
â
Enhanced Web Chat Ready
â
æ¢åConversation確èª
â
ç¬èªStarter衚瀺
â
ãŠãŒã¶ãŒãéžæ
â
launchChat()
â
Agentforceãåå
â
FirstBotMessageSent
â
sendTextMessage()
â
Agentforceãšã®äŒè©±éå§
ãšããæ§æã§ãã
ã¹ã¿ãŒã¿ãŒããã³ããã®å 容ã¯èªç±ã«å€æŽå¯èœ
ä»åã®ãµã³ãã«ã§ã¯ã
<button
onclick="startWithMessage('æéã«ã€ããŠæããŠãã ãã')"
>
æéã«ã€ããŠç¥ããã
</button>ãšããŠããŸãã
ãã®ããã衚瀺ããæåãš Agentforce ãžéãæåãåããããšãã§ããŸãã
äŸãã°ã
<button
onclick="startWithMessage('補åAã®æéäœç³»ã«ã€ããŠæããŠãã ãã')"
>
æéã«ã€ããŠç¥ããã
</button>ãšããã°ããŠãŒã¶ãŒã«ã¯ã
æéã«ã€ããŠç¥ããã
ãšã ã衚瀺ããªãããAgentforce ã«ã¯ã
補å A ã®æéäœç³»ã«ã€ããŠæããŠãã ãã
ãšãããããå ·äœçãªã¡ãã»ãŒãžãéä¿¡ã§ããŸãã
ãã®ä»çµã¿ãå©çšããã°ãWeb ãµã€ãåŽã®å°ç·ãš Agentforce åŽã® Topic ã Instruction ãçµã¿åãããèšèšãå¯èœã«ãªããŸãã
Enhanced Web Chat v2 ã§ããããšã確èª
ä»åå©çšããŠãã sendTextMessage() ã¯ãEnhanced Web Chat v2 ã® Context Events ã§æäŸãããŠãã API ã§ãã
ãã®ããããã®ãµã³ãã«ããã®ãŸãŸå©çšããå Žåã¯ã察象 Deployment ãEnhanced Web Chat v2 ã§ããããšã確èªããŠãã ããã
ãŸããä»åã®æ€èšŒã§ã¯ Developer Tools ããã
embeddedservice_bootstrap.utilAPIã確èªããããšãããã©ãã«ã·ã¥ãŒãã£ã³ã°ã§éåžžã«åœ¹ç«ã¡ãŸããã
äŸãã°ã
typeof embeddedservice_bootstrap
.utilAPI
.sendTextMessageãå®è¡ããŠã
functionãšãªãã°ããã® Runtime ã§ sendTextMessage() ãå©çšå¯èœã§ããããšã確èªã§ããŸãã
ãããã§ããã§ããããã
ä»åã®æ€èšŒã§æã倧ããã£ãçºèŠã¯ãç¬èªã®ã¹ã¿ãŒã¿ãŒããã³ããä»ãéå§ç»é¢ãäœãããã«ãAgentforceèªäœãæ¹ä¿®ããå¿ èŠã¯ãªãã£ããšããããšã§ãã
ä»åäœãããã£ããã®ã¯ã
Agentforce ã® Conversation UI ã倿Žãã
ãã®ã§ã¯ãªãã
Agentforce ãšã® Conversation ãå§ãŸãåã®
Web ãµã€ãäžã®äœéšã倿Žãã
ãã®ã§ããã
ãã®ããã
Web ãµã€ã
â
ç¬èª Starter UI
â
Enhanced Web Chat API
â
Agentforce
ãšããæ§æã§å®çŸã§ããŸãã
ãŸããå®è£ ããŠã¿ããšã
launchChat()ãå®è¡ããçŽåŸã«ã
sendTextMessage()ãå®è¡ããã ãã§ã¯å®å®ããŸããã§ããã
ããã§ã
onEmbeddedMessagingReady
onEmbeddedMessagingButtonCreated
onEmbeddedMessagingConversationOpened
onEmbeddedMessagingFirstBotMessageSent
ãšãã£ã Salesforce ã®æšæºã€ãã³ããå©çšããŠãEnhanced Web Chat ãAgentforce ã®ç¶æ ã«åãããŠåŠçãé²ããæ§æã«ããŸããã
ç¹ã«ã
äœç§åŸ ã£ãŠããæ¬¡ã®åŠçãããã
ã§ã¯ãªãã
å¿ èŠãªç¶æ ã«ãªã£ãããšã
Salesforce ã®ã€ãã³ãã§ç¢ºèªããŠããæ¬¡ãžé²ã
ãšããèãæ¹ãéèŠã§ãã
äŸå€ãšããŠãSalesforce ã«ã¯ãæ¢å Conversation ãååšããªããããšãéç¥ããã€ãã³ãããªããããç¬èª Starter ãæåã«è¡šç€ºãããã©ããã®å€å®ã«ã ãçã Fallback Timer ãå©çšããŠããŸãã
Agentforce ã®éå§ç»é¢ãç¬èªã«ããããšããèŠä»¶ããã£ãå Žåã
ãAgentforce ãã©ãæ¹ä¿®ãããïŒãã ãã§ã¯ãªã
ãWeb ãµã€ãåŽãã Enhanced Web Chat API ãå©çšã§ããªããïŒã
ãšãã芳ç¹ã§èããŠã¿ããšãå®è£ æ¹æ³ãèŠã€ãããããããŸããã
ãã®å 容ã¯ãç§ããã®ä»çµã¿ãäœãããšãããšãã«ãã©ãã調ã¹ãŠãæ å ±ãåŸãããªãã£ããããèšé²çšã«ã¡ã¢ãšããŠæ®ããŠãããŸãã
ä»åã¯ä»¥äžã§ãã