# 客服系统

SDK 为你提供了机器人和人工两种用户对话方式。

我们默认向用户展示机器人客服，并通过机器人故事线的方式解答用户的疑问。

若机器人未能完全为用户解惑，用户还可以通过提交表单来生成人工客诉，并在下次进入客服系统时，会自动跳转至进行中的客诉会话。

当然，你还可以通过自由配置来达到定制化效果，比如为不同等级的用户展示不同的欢迎语，为高付费用户开通人工直达通道等。

# API

# showConversation

调用 init API 时，你可以配置 supportMode 字段为 showConversation 来调起 AIHelp 客服系统，呼出机器人客服:

<script src="https://cdn.aihelp.net/webchatv3/aihelp.js"></script>
<body>
  <script>
    (function () {
      let initConfig = {
        appKey: "THIS IS YOUR APP KEY",
        domain: "THIS IS YOUR APP DOMAIN",
        appId: "THIS IS YOUR APP ID",
        supportMode: 'showConversation'  
      };
      AIHelpSupport.init(initConfig);
      AIHelpSupport.show();
    })();
  </script>
</body>

也可以根据具体的需求，通过 supportConfig 字段对客服系统进行定制化配置：

<script src="https://cdn.aihelp.net/webchatv3/aihelp.js"></script>
<body>
  <script>
    (function () {
      let initConfig = {
        appKey: "THIS IS YOUR APP KEY",
        domain: "THIS IS YOUR APP DOMAIN",
        appId: "THIS IS YOUR APP ID",
        supportMode: 'showConversation',
        supportConfig: {
          conversationIntent: 'bot', 
          alwaysShowHumanSupportButtonInBotPage: true,
          welcomeMessage: 'THIS IS YOUR SPECIAL WELCOME MESSAGE',
          storyNode: 'THE SAME CONTENT AS YOUR SPECIFIC "User Say" CONFIGURATION'
        }  
      };
      AIHelpSupport.init(initConfig);
      AIHelpSupport.show();
    })();
  </script>
</body>

# URL

或者，你也可以通过拼接 URL 的方式实现同样的需求：

<script>
  let appKey = "THIS IS YOUR APP KEY";
  let domain = "THIS IS YOUR APP DOMAIN";
  let appId = "THIS IS YOUR APP ID";
  (function () {
    let baseUrl = `https://${domain}/webchatv3/#/appKey/${appKey}/domain/${domain}/appId/${appId}`;
    let params = `supportMode=showConversation&conversationIntent=human&alwaysShowHumanSupportButtonInBotPage=true&welcomeMessage=THIS IS YOUR SPECIAL WELCOME MESSAGE&storyNode=Bugs`;
    let url = `${baseUrl}?${params}`;
    window.open(url);
  })();
</script>

# 参数释义

# supportMode

类型：showConversation
详情：必传参数。 客服系统的支持选项配置，配置为 showConversation 可以打开客服系统。

# supportConfig API

类型：object
默认值：{}
详情：可选参数。 仅在 API 方案中生效，用于对客服系统进行自定义配置。

# conversationIntent

类型：bot | human
默认值：bot
详情：可选参数。 客服系统的跳转意图，bot 为机器人客服，human 为人工客服。

# alwaysShowHumanSupportButtonInBotPage

类型：boolean
默认值：false
详情：可选参数。 机器人常显人工入口。

# welcomeMessage

类型：string
默认值：''
详情：可选参数。 人工客服自定义欢迎语，自定义传参。

# storyNode

类型：string
默认值：''
详情：可选参数。 特定故事线的入口节点，故事线配置内容。

# 场景假设

让我们来假定一个需求场景：

应用在个人中心需要有特殊的故事线入口，通过该入口可以直接反馈关于账号丢失、账号被盗、账号被封禁等常见的账号相关的问题；同时根据不同等级的用户，应用提供了不同的支持方案，具体如下：

1、为等级 < 20 级的用户响应机器人客服，这部分用户只能通过故事线以及表单来提交客诉，即系统默认情况；

2、20 级< 等级 < 50 级的用户也响应机器人客服，但是这部分用户可以选择直接联系人工客服；

3、为等级 > 50 级的用户直接响应人工客服，同时展示有别于其他用户的特殊欢迎语。

那么，针对这个场景的代码实现如下所示：

# API

<script src="path/to/your/aihelp.js"></script>
<script>
  (function (level) {
    let conversationConfig = {
      storyNode: 'EXACTLY THE SAME CONTENT AS YOUR "User Say" CONFIGURATION'
    };
    if (level > 20 && level < 50) {
      conversationConfig['alwaysShowHumanSupportButtonInBotPage'] = true;
    } else if (level > 50) {
      conversationConfig['conversationIntent'] = 'human';
      conversationConfig['welcomeMessage'] = 'YOUR SPECIAL WELCOME MESSAGE';
    }
    let initConfig = {
      appKey: 'THIS IS YOUR APP KEY',
      domain: 'THIS IS YOUR APP DOMAIN',
      appId: 'THIS IS YOUR APP ID',
      appName: 'THIS IS YOUR APP NAME',
      language: 'THIS IS YOUR DEFAULT LANGUAGE(OPTIONAL)',
      supportMode: 'showConversation',
      supportConfig: conversationConfig,
    };
    AIHelpSupport.init(initConfig);
    AIHelpSupport.show()
  })();
</script>

# URL

<script>
  let appKey = 'THIS IS YOUR APP KEY';
  let domain = 'THIS IS YOUR APP DOMAIN';
  let appId = 'THIS IS YOUR APP ID';
  (function (level) {
    let url = `https://${domain}/webchatv3/#/appKey/${appKey}/domain/${domain}/appId/${appId}?supportMode=showConversation`;
    url = `${url}&storyNode=EXACTLY THE SAME CONTENT AS YOUR "User Say" CONFIGURATION`;
    if (level > 20 && level < 50) {
      url = `${url}&alwaysShowHumanSupportButtonInBotPage=true`;
    } else if (level > 50) {
      url = `${url}&conversationIntent=human&welcomeMessage=YOUR SPECIAL WELCOME MESSAGE`;
    }
    window.open(url);
  })();
</script>

# 页面示例

基于以上场景的 AIHelp 页面显示示例如下：

← 快速上手 FAQ →