数据收集表单

借助此功能,您可以为移动和 Web SDK 设置并管理用于收集消费者数据的表单。CCAI 平台同时支持客户托管的 HTML 表单(浏览器表单)和由 SDK 呈现的门户定义的表单(自定义表单)。消费者可以在有效的聊天会话期间填写表单,并且提交的表单数据可以根据配置路由到您的 CRM 和外部存储空间。

启用此功能之前,请确认您的 SDK 符合相关要求。如需了解详情,请参阅准备工作。

表单类型

本页介绍了如何设置数据收集表单,以便代理在聊天期间发送给最终用户。

CCAI Platform 支持在 Web 和移动 SDK 中以两种不同的方式呈现表单:

  • 浏览器表单:您可以在自己的 Web 服务器上托管 HTML 表单。 CCAI 平台在 SDK 内的嵌入式浏览器视图中加载表单。这需要有效的表单外部 ID 和指向托管表单的表单预览网址。浏览器表单仅在 Widget Web SDK 中受支持。 无头 SDK 不支持这些功能。如果您的网站渠道使用 Headless,请改用自定义表单。

    如需了解详情,请参阅添加浏览器表单。

  • 自定义表单:您可以在 CCAI 平台门户中直接定义表单(字段、布局和选项)。CCAI Platform 会在 Web 和移动 SDK 中呈现表单,无需客户托管的表单基础架构。表单数据可以发送到您的 CRM(作为工单注释),还可能会发送到外部存储空间,具体取决于您的配置。

    如需了解详情,请参阅添加自定义表单。

准备工作

如需启用表单,您需要输入公司密钥进行身份验证。

如需获取公司密令,请按以下步骤操作:

  1. 在 CCAI 平台门户中,依次点击设置 > 开发者设置。 如果您没有看到设置菜单,请点击 菜单。

  2. 前往公司密钥和密钥代码窗格。系统会显示您的公司密码。您需要在启用表单时使用此代码。

启用表单

如需启用表单,请按以下步骤操作:

  1. 在 CCAI Platform 门户中,依次点击设置 > 表单。如果您没有看到设置菜单,请点击 菜单。系统会显示表单页面。

  2. 点击启用表单切换开关,将其切换到开启位置。

  3. 对于表单设置,请点击配置。系统随即会显示浏览器表单设置窗格。

  4. 在 Secret 字段中,输入您的公司密钥代码,然后点击保存。

  5. 点击返回以返回到表单页面。

添加浏览器表单

如需添加浏览器表单,请按以下步骤操作:

  1. 按照启用表单中的步骤操作。

  2. 在表单页面上,点击添加模板。系统会显示添加表单模板页面。

  3. 如需配置表单设置,请执行以下操作:

    1. 在类型部分,选择浏览器表单。

    2. 对于渠道,选择您希望表单在哪些渠道中提供。

    3. 对于排队语言,请选择您希望表单支持的排队语言。例如,如果您选择渠道 = 网络聊天和队列语言 = 德语,则最终用户可以通过网络渠道和德语队列使用该表单。

  4. 如需配置表单详细信息,请执行以下操作:

    1. 在表单模板名称字段中,输入面向内部的表单模板名称。客服人员在聊天适配器中选择表单时,会看到表单模板名称。

    2. 在表单标题字段中,输入表单的标题。最终用户在聊天期间会在联系人卡片上看到表单标题。如需了解详情,请参阅最终用户体验。

    3. 在表单副标题(可选)字段中,您可以选择为表单输入副标题。最终用户在聊天期间会在联系人卡片上看到表单副标题。

    4. 在表单外部 ID 字段中,输入表单服务器上表单的标识符。

    5. 在预览网址字段中,输入代理适配器中显示的表单预览的网址。对于表单预览,您可以使用实际表单或通用表单。如果表单包含 PII,Google 建议使用通用表单预览,以帮助客服人员在不查看 PII 的情况下识别正确的表单。

    6. 如需添加表单图片,请执行以下操作:

      1. 在表单图片(可选)字段中,视需要输入图片。

      2. 剪裁图片,然后点击剪裁。

    最终用户在聊天期间会在联系人卡片上看到表单图片。

  5. 点击保存并预览。系统会显示模板预览对话框。

  6. 执行下列其中一项操作:

    • 如果表单未按预期显示,请点击修改。系统会再次显示修改表单模板页面,您可以在其中更改所做的修改。

    • 如果表单按预期显示,请点击完成。

添加自定义表单

如需添加自定义表单,请按照以下步骤操作:

  1. 按照启用表单中的步骤操作。

  2. 在表单页面上,点击添加模板。系统会显示添加表单模板页面。

  3. 如需配置表单设置,请执行以下操作:

    1. 对于类型,选择自定义表单。

    2. 对于类别,请保留已选中的聊天。

    3. 对于渠道,请选中网页聊天复选框。

    4. 对于排队语言,请选择您希望表单支持的排队语言。例如,如果您选择渠道 = 在线聊天和队列语言 = 德语,则最终用户可以使用网络渠道和德语队列来访问该表单。

    5. 可选:对于数据存储,选中将表单提交数据作为 CRM 工单注释包含在内复选框,以将表单数据作为工单注释发送到您的 CRM。

  4. 如需配置表单详细信息,请执行以下操作:

    1. 在表单模板名称字段中,输入面向内部的表单模板名称。客服人员在聊天适配器中选择表单时,会看到表单模板名称。

    2. 在表单标题字段中,输入表单的标题。最终用户会在聊天期间在联系人卡片上看到表单标题。如需了解详情,请参阅最终用户体验。

    3. 在表单副标题(可选)字段中,可以选择性地输入表单的副标题。最终用户在聊天期间会在联系人卡片上看到表单副标题。

    4. 如需添加表单图片,请执行以下操作:

      1. 在表单图片字段中,输入图片。

      2. 剪裁图片,然后点击剪裁。

    最终用户在聊天期间会在联系人卡片上看到表单图片。

  5. 在表单标题字段中,输入显示在表单开头的文字。

  6. 在表单页脚(可选)字段中,您可以选择输入显示在表单末尾的文字。

  7. 点击下一步。系统会显示问题部分。

  8. 如需向表单添加问题,请执行以下操作:

    1. 点击添加问题。系统会显示添加问题页面。

    2. 在问题类型列表中,选择问题类型。显示的选项取决于您选择的问题类型。

    3. 在问题文本字段中,输入您的问题。

    4. 如需配置强制切换开关,请执行以下操作:

      • 如果您之前在问题类型列表中选择了 Toggle button:如需要求最终用户在表单中开启此切换开关,然后才能提交表单,请点击必填切换开关,将其切换到开启位置。

      • 如果您之前在问题类型列表中选择了除 Toggle button 之外的任何值:如需要求最终用户先回答此问题,然后才能提交表单,请点击必填切换开关,将其切换到开启位置。

    5. 可选:如需屏蔽最终用户在文本字段中输入的文本,请将屏蔽切换开关切换到开启位置。只有当您之前在问题类型列表中选择过 Text Entry 时,才会显示遮盖切换开关。

    6. 可选:在占位文本字段中,输入占位文本。此功能不适用于所有问题类型。

    7. 可选:添加帮助文本和帮助图片。此功能不适用于所有问题类型。

    8. 在字符数上限字段中,输入文本字段的字符数上限。仅当问题类型 = Text Entry 时可用。

    9. 在输入源类型列表中,选择一种输入源类型。仅当问题类型 = Text Entry 时可用。

    10. 配置所有剩余字段,然后点击添加。

  9. 如需添加其他问题,请点击添加问题,然后为表单配置其他问题。

  10. 点击保存。

为 Web 和移动设备配置自定义表单

如需让智能体能够使用 Web 和移动 SDK 发送表单,您必须按照以下步骤将这些渠道明确分配给表单模板:

  1. 前往表单模板:登录门户,然后前往添加 / 修改表单模板页面。

  2. 选择类别:在“表单设置”中,选择 Chat 作为类别。选择“Chat”后,Web Chat 和 Mobile Chat 的渠道复选框会变为可用状态。

  3. 启用频道:找到频道选择复选框。选择网页聊天,以便在 Web SDK 中提供此表单。选择移动聊天,以便在移动 SDK 上提供此表单。

  4. 设计表单:

    • 问题:添加 Text、List 或 Toggle 类型的问题。
    • 帮助上下文:您可以选择为特定问题添加帮助文本或帮助图片,以引导消费者。
    • 图片:如果上传的是表单图片,请确保其宽高比为 8:3。您可以在门户中剪裁图片。
    • CRM 设置:如需将表单回答作为工单评论发送到 CRM,请在表单设置中启用将表单提交数据作为 CRM 工单评论包含在内。

    启用后,系统可以将表单活动添加到您的 CRM 工单注释中(例如,在发送表单和成功完成表单时),并且 - 如果此选项已启用 - 将提交的字段值附加到完成注释中。

  5. 预览并保存:点击保存并预览,验证表单布局是否符合预期的消费者体验。

    • 门户中显示的预览仅为代理预览,可能与 SDK 中表单的实际显示效果不完全一致。

配置表单数据存储

配置 CCAI 平台,以将表单数据存储在外部存储空间中。

设置外部存储设备

设置外部存储位置,以便您存储表单数据。如需了解详情,请参阅外部存储空间。

您可以将系统配置为将从自定义表单收集的数据直接推送到外部存储空间(例如 S3)。

配置实例以将表单数据发送到外部存储空间

如需将实例配置为将表单数据发送到外部存储空间,请按以下步骤操作:

  1. 在 CCAI 平台门户中,依次点击设置 > 开发者设置。 如果您没有看到设置菜单,请点击 菜单。

  2. 前往外部存储窗格,然后点击相应开关,将其切换到开启位置。

  3. 选中自定义表单复选框。系统会显示外部存储位置中表单数据文件的默认路径。您可以修改路径。

  4. 点击保存。

权限

为确保安全,对外部存储空间内表单数据的访问权限由特定权限控制。

如果没有此权限,即使门户用户知道路径或 UUID,也无法访问外部存储空间中的自定义表单数据。

配置权限

为相关用户角色(例如管理员、经理数据)分配查看权限。

为了帮助保护最终用户数据,查看外部存储设备中的表单数据受 CCAI 平台用户角色的控制。只有管理员、经理、经理管理员、经理团队和经理数据默认角色拥有查看外部存储空间中表单数据的权限。

如果默认角色不能满足您的需求,您可以添加具有查看表单数据权限的自定义角色。您可以在添加角色对话框中配置自定义角色权限,方法是依次前往设置 > 用户和团队 > 角色和权限 > 添加角色。

权限位置

在添加角色对话框中,表单数据设置位于以下位置:

  • 部分:外部存储空间

  • 页面:表单

  • 功能:表单数据

后续步骤