# 客服系统
SDK 为你提供了机器人和人工两种用户对话方式。
我们默认向用户展示机器人客服，并通过机器人故事线的方式解答用户的疑问。
若机器人未能完全为用户解惑，用户还可以通过提交表单来生成人工客诉，并在下次进入客服系统时，会自动跳转至进行中的客诉会话。
当然，你还可以通过自由配置来达到定制化效果，比如为不同等级的用户展示不同的欢迎语，为高付费用户开通人工直达通道等。
# API
# showConversation
你可以通过此方法调起 AIHelp 客服系统，呼出机器人客服:
AIHelpSupport::showConversation();
也可以根据具体的需求对客服系统进行定制化配置：
ConversationConfig config = ConversationConfigBuilder()
.setConversationIntent(BOT_SUPPORT)
.setAlwaysShowHumanSupportButtonInBotPage(true)
.setWelcomeMessage("THIS IS YOUR SPECIAL WELCOME MESSAGE")
.setStoryNode("THE SAME CONTENT AS YOUR SPECIFIC 'User Say' CONFIGURATION")
.build();
AIHelpSupport::showConversation(config);
# 参数释义
# conversationConfig
- 类型：
ConversationConfig - 默认值：
null - 详情：可选参数。 客服系统的定制化配置。
# conversationIntent
- 类型：
ConversationIntent - 默认值：
ConversationIntent::BOT_SUPPORT - 详情：可选参数。 客服系统的跳转意图。
# alwaysShowHumanSupportButtonInBotPage
- 类型：
bool - 默认值：
false - 详情：可选参数。 机器人常显人工入口。
# welcomeMessage
- 类型：
string - 默认值：
'' - 详情：可选参数。 人工客服自定义欢迎语，自定义传参。
# storyNode
- 类型：
string - 默认值：
'' - 详情：可选参数。 特定故事线的入口节点，故事线配置内容。
# 场景假设
让我们来假定一个需求场景：
应用在个人中心需要有特殊的故事线入口，通过该入口可以直接反馈关于账号丢失、账号被盗、账号被封禁等常见的账号相关的问题；同时根据不同等级的用户，应用提供了不同的支持方案，具体如下：
1、为等级 < 20 级的用户响应机器人客服，这部分用户只能通过故事线以及表单来提交客诉，即系统默认情况；
2、20 级< 等级 < 50 级的用户也响应机器人客服，但是这部分用户可以选择直接联系人工客服；
3、为等级 > 50 级的用户直接响应人工客服，同时展示有别于其他用户的特殊欢迎语。
那么，针对这个场景的代码实现如下所示：
public void showConversation(int level)
{
ConversationConfigBuilder conversationBuilder = ConversationConfigBuilder();
conversationBuilder.SetStoryNode("EXACTLY THE SAME CONTENT AS YOUR 'User Say' CONFIGURATION");
if (level > 20 && level < 50)
{
conversationBuilder.setAlwaysShowHumanSupportButtonInBotPage(true);
}
else if (level > 50)
{
conversationBuilder.setConversationIntent(ConversationIntent:HUMAN_SUPPORT);
conversationBuilder.setWelcomeMessage("THIS IS YOUR SPECIAL WELCOME MESSAGE");
}
AIHelpSupport::showConversation(conversationBuilder.build());
}
# 页面示例
基于以上场景的 AIHelp 页面显示示例如下：
