爱 客 服 快 速 接 入 指 南 400 005 0025 / aikf@huilan.com
目 录 / CATALOG 一 桌 面 网 站 接 入 1. JAVASCRIPT 网 页 插 件 接 入 2. JS 代 码 操 作 指 引 3. 网 页 链 接 独 立 页 面 接 入 4. 网 页 链 接 接 入 操 作 指 引 5. 自 定 义 桌 面 网 站 接 入 图 标 颜 色 等 01 01 02 04 06 07 二 移 动 网 站 接 入 1. 移 动 网 站 JAVASCRIPT 网 页 插 件 接 入 2. 移 动 网 页 JAVASCRIPT 插 件 接 入 操 作 指 引 3. 网 页 链 接 独 立 页 面 接 入 4. 自 定 义 移 动 网 页 接 入 图 标 按 钮 颜 色 导 航 及 电 话 9 9 10 11 12 三 微 信 接 入 1. 在 微 信 菜 单 添 加 爱 客 服 聊 天 链 接 2. 直 接 授 权 爱 客 服 部 署 微 信 公 众 号 13 13 15 四 APP 接 入 1. 在 APP 中 添 加 爱 客 服 咨 询 链 接 2. 使 用 APP 原 生 接 入 爱 客 服 3. 爱 客 服 APP 接 入 的 DEMO 示 例 17 17 18 21
一 桌 面 网 站 接 入 1. JAVASCRIPT 网 页 插 件 接 入 JAVASCRIPT 网 页 插 件 接 入 的 方 式 是 指 将 爱 客 服 咨 询 窗 口 的 插 件 代 码 插 入 至 需 要 使 用 客 服 咨 询 窗 口 的 网 页 当 中, 网 页 右 下 角 将 出 现 机 器 人 图 标 或 咨 询 按 钮, 使 得 客 户 在 访 问 您 网 站 时 可 以 点 击 咨 询 按 钮, 调 用 咨 询 窗 口, 与 您 的 客 服 机 器 人 或 者 人 工 客 服 取 得 联 系 网 页 接 入 样 例 : 1 返 回 目 录
2. JS 代 码 操 作 指 引 使 用 注 册 账 号 登 录 爱 客 服 网 站, 进 入 接 入 管 理, 进 入 桌 面 网 站 客 服 页 面, 查 看 网 站 JS 代 码 复 制 JS 代 码 到 网 站 代 码 中, 将 JS 代 码 放 置 于 前 端 网 页 代 码 的,</body> 之 前, 使 其 能 够 成 为 插 件, 为 客 户 提 供 服 务 ( 如 果 您 不 了 解 代 码 接 入 程 序, 请 咨 询 您 的 网 站 建 设 人 员 或 者 网 站 建 设 方 ) 2 返 回 目 录
JS 代 码 示 例 <script> var tenantid='9e67a634167b499b826856e5fd5bca55'; var r = Math.random();document. write(unescape("%3cscriptsrc='http://www.aikf.com/ask/resources/app/ask/webmain. js?_="+r+"'type='text/javascript'%3e%3c/script%3e")) </script> 代 码 放 置 后 效 果 如 下 ( 右 下 角 出 现 机 器 人 小 图 标 或 者 在 线 咨 询 图 标 ) 即 为 成 功, 如 未 出 现 咨 询 按 钮 或 者 图 标, 可 以 先 行 检 查 代 码 放 置 位 置 : 3 返 回 目 录
3. 网 页 链 接 独 立 页 面 接 入 如 果 您 拥 有 自 己 设 计 的 网 页 图 标 / 样 式 / 按 钮 您 也 可 以 运 用 网 页 链 接 将 独 立 页 面 接 入 您 的 网 页, 让 客 户 直 接 点 击 跳 转 成 对 话 页 面 独 立 页 面 接 入 样 例 ( 高 亮 处 点 击 后 为 对 话 页 面 ): 4 返 回 目 录
独 立 页 面 接 入 样 式 : 5 返 回 目 录
4. 网 页 链 接 接 入 操 作 指 引 进 入 爱 客 服 后 台, 点 击 接 入 管 理, 进 入 桌 面 网 站 接 入, 点 击 复 制 前 台 页 面 地 址, 将 前 台 页 面 地 址 放 至 您 需 要 链 接 的 网 页 入 口 即 可 6 返 回 目 录
5. 自 定 义 桌 面 网 站 接 入 图 标 颜 色 等 爱 客 服 为 各 位 企 业 用 户 提 供 桌 面 网 站 接 入 图 标 颜 色 导 航 等 设 置 项 的 自 定 义 设 置, 从 而 为 您 提 供 更 加 丰 富 的 设 置 与 定 义 进 入 爱 客 服 后 台, 点 击 接 入 管 理, 进 入 桌 面 网 站 客 服 页 面, 根 据 您 的 需 求 自 由 定 义 您 所 需 的 咨 询 按 钮 展 现 形 式 颜 色 弹 出 方 式 等 7 返 回 目 录
企 业 可 以 在 后 台 选 择 不 同 的 窗 口 颜 色, 从 而 匹 配 自 身 网 页 格 调 和 颜 色 企 业 可 以 上 传 自 己 的 单 位 LOGO, 定 义 单 位 名 称 标 语, 并 定 义 LOGO 跳 转 地 址, 可 以 跳 转 到 企 业 自 身 官 网 8 返 回 目 录
二 移 动 网 站 接 入 1. 移 动 网 站 JAVASCRIPT 网 页 插 件 接 入 企 业 可 以 在 自 己 的 移 动 网 页 或 者 H5 网 站 上 设 置 咨 询 按 钮 接 入 爱 客 服, 从 而 为 移 动 端 客 户 咨 询 提 供 良 好 的 服 务 移 动 网 页 页 面 接 入 样 例 : 9 返 回 目 录
2. 移 动 网 页 JAVASCRIPT 插 件 接 入 操 作 指 引 进 入 爱 客 服 后 台, 点 击 接 入 管 理, 进 入 移 动 网 站 客 服 页 面, 复 制 JS 代 码, 将 JS 代 码 放 置 于 移 动 前 端 网 页 代 码 的,</body> 使 其 能 够 成 为 插 件, 为 客 户 提 供 服 务 ( 如 果 您 不 了 解 代 码 接 入 程 序, 请 咨 询 您 的 网 站 建 设 人 员 或 者 网 站 建 设 方 ) 移 动 JS 代 码 示 例 : <script> var tenantid='9e67a634167b499b826856e5fd5bca55'; var r = Math.random();document. write(unescape("%3cscript src='http://www.aikf.com/ask/resources/app/ask/mobilemain. js?_="+r+"' type='text/javascript'%3e%3c/script%3e")) </script> 代 码 放 置 后 移 动 网 站 页 面 或 者 H5 页 面 出 现 咨 询 按 钮 即 为 成 功, 如 未 出 现 咨 询 按 钮 或 者 图 标, 可 以 先 行 检 查 代 码 放 置 位 置 10 返 回 目 录
3. 网 页 链 接 独 立 页 面 接 入 与 桌 面 网 站 接 入 方 式 一 样, 企 业 可 以 根 据 自 身 移 动 网 站 特 点 自 定 义 咨 询 按 钮 入 口, 通 过 H5 链 接 独 立 页 面 接 入 咨 询 移 动 网 页 自 定 义 入 口 样 例 ( 高 亮 处 为 入 口 ): 11 返 回 目 录
4. 自 定 义 移 动 网 页 接 入 图 标 按 钮 颜 色 导 航 及 电 话 进 入 爱 客 服 后 台, 点 击 接 入 管 理, 进 入 移 动 网 站 接 入 管 理 企 业 可 以 自 定 义 移 动 网 站 接 入 图 标 按 钮 及 颜 色, 设 置 方 法 与 桌 面 网 站 无 异, 值 得 一 提 的 是, 企 业 可 以 通 过 设 置 咨 询 页 面 的 导 航 以 及 电 话 系 统, 丰 富 咨 询 页 面 的 功 能, 用 户 在 咨 询 时 可 以 直 接 拨 打 预 设 的 电 话 移 动 网 页 自 定 义 界 面 : 电 话 功 能 开 启 后 咨 询 页 将 启 用 电 话 功 能 : 12 返 回 目 录
三 微 信 接 入 1. 在 微 信 菜 单 添 加 爱 客 服 聊 天 链 接 进 入 爱 客 服 后 台, 点 击 接 入 管 理, 进 入 移 动 网 站 接 入 管 理 复 制 聊 天 页 面 链 接 地 址 添 加 到 微 信 公 众 号 的 自 定 义 菜 单 中 即 可 微 信 菜 单 添 加 链 接 : 登 录 微 信 公 众 号 平 台 或 者 代 管 理 的 第 三 方 平 台, 使 用 自 定 义 菜 单 功 能, 在 需 要 添 加 链 接 的 菜 单 处, 点 击 跳 转 网 页, 填 写 自 定 义 菜 单 13 返 回 目 录
微 信 菜 单 接 入 样 例 样 例 ( 高 亮 处 为 入 口, 右 侧 为 点 击 后 咨 询 页 面 ): 14 返 回 目 录
2. 直 接 授 权 爱 客 服 部 署 微 信 公 众 号 进 入 爱 客 服 后 台, 点 击 接 入 管 理, 进 入 微 信 接 入, 点 击 快 速 授 权 微 信 授 权 接 入 页 面 : 15 返 回 目 录
点 击 快 速 授 权 按 钮, 使 用 微 信 公 众 平 台 绑 定 的 公 众 号 扫 描 授 权 二 维 码, 绑 定 授 权 成 功 后 即 部 署 成 功 爱 客 服 绑 定 授 权 提 供 智 能 机 器 人 客 服 功 能, 直 接 与 公 众 号 对 话 即 可 体 验 微 信 公 众 号 接 入 样 例 : 注 意 : 爱 客 服 在 微 信 优 化 后, 可 与 您 的 其 他 第 三 方 平 台 一 同 使 用, 不 干 涉 您 在 其 他 第 三 方 平 台 上 使 用 的 自 定 义 菜 单 等 工 具, 只 需 要 您 扫 描 授 权 后 即 可 使 用 16 返 回 目 录
四 APP 接 入 1. 在 APP 中 添 加 爱 客 服 咨 询 链 接 我 们 为 需 要 在 APP 中 集 成 爱 客 服 的 用 户 提 供 两 种 接 入 方 式, 第 一 种 是 在 企 业 自 己 开 发 的 APP 中 添 加 爱 客 服 移 动 咨 询 链 接, 企 业 可 以 在 自 己 开 发 的 APP 中 添 加 咨 询 按 钮 或 者 咨 询 入 口, 直 接 链 接 到 客 服 咨 询 页 面 APP 中 咨 询 链 接 的 获 取 方 式 与 移 动 网 站 独 立 页 面 链 接 获 取 方 式 一 致 进 入 爱 客 服 后 台, 点 击 接 入 管 理, 进 入 移 动 网 站 客 服, 点 击 复 制 前 台 页 面 地 址, 将 前 台 页 面 地 址 放 至 您 需 要 链 接 的 APP 入 口 即 可 APP 咨 询 链 接 获 取 页 面 : 17 返 回 目 录
2. 使 用 APP 原 生 接 入 爱 客 服 我 们 为 企 业 提 供 APP 调 用 地 址 和 集 成 方 法, 调 用 说 明 如 下 : 调 用 方 式 : Httpclient 接 入 http 请 求 方 式 : POST 请 求 地 址 : 按 照 以 下 步 骤 复 制 APP 接 口 url 请 求 地 址 需 要 登 录 爱 客 服 后 台 进 行 获 取, 进 入 爱 客 服 后 台, 点 击 接 入 管 理, 点 击 接 入 APP, 复 制 APP 接 口 url APP 咨 询 链 接 获 取 页 面 : 18 返 回 目 录
请 求 参 数 示 例 : 请 求 参 数 解 释 : 返 回 参 数 示 例 : 19 返 回 目 录
返 回 参 数 解 释 : 返 回 码 errcode 问 题 类 型 quedtiontye 返 回 值 解 释 : 20 返 回 目 录
3. 爱 客 服 APP 接 入 的 DEMO 示 例 您 可 以 让 您 的 技 术 和 开 发 人 员 参 考 DEMO 示 例 需 要 的 jar 包 : httpclient-4.3.3jar httpclient-cache-4.3.3jar httpcore-4.3.2jar httpmime-4.3.3jar Java 程 序 : package com.web.dao; import java.io.ioexception; importjava.io.unsupportedencodingexception; import java.util.arraylist; import java.util.list; importorg.apache.http.httpentity; importorg.apache.http.namevaluepair; importorg.apache.http.client.clientprotocolexception; importorg.apache.http.client.entity.urlencodedformentity; importorg.apache.http.client.methods.closeablehttpresponse; importorg.apache.http.client.methods.httppost; importorg.apache.http.impl.client.closeablehttpclient; importorg.apache.http.impl.client.httpclients; import org.apache.http.message.basicnamevaluepair; importorg.apache.http.util.entityutils; 21 返 回 目 录
public class Demo { public static HttpPost gethttppost(string url,string fromuser,string reqtype,string ip,string q){ HttpPost httppost = null; try { httppost = new HttpPost(url); // 创 建 参 数 队 列 List<NameValuePair>formparams = new ArrayList<NameValuePair>(); formparams.add(new BasicNameValuePair("fromuser", fromuser)); formparams.add(new BasicNameValuePair("reqtype", reqtype)); formparams.add(new BasicNameValuePair("ip", ip)); formparams.add(new BasicNameValuePair("q", q)); // 打 包 将 要 传 入 的 参 数 UrlEncodedFormEntity uefentity = new UrlEncodedFormEntity(formparams, "UTF-8"); httppost.setentity(uefentity); } catch (UnsupportedEncodingException e) { e.printstacktrace(); } return httppost; } public static void main(string[] args){ CloseableHttpClient httpclient = HttpClients.createDefault(); // 创 建 httppost 22 返 回 目 录
HttpPost httppost = gethttppost("[ 复 制 的 域 名 ]","[ 用 户 ID]","[ 请 求 类 型 ]","[ 用 户 IP]","[ 问 题 内 容 ]"); // 提 交 请 求 数 据 CloseableHttpResponse response = null; try { response = httpclient.execute(httppost); HttpEntity entity = response.getentity(); // 请 求 成 功 if (entity!= null) { System.out.println("Response content: " + EntityUtils.toString(entity, "UTF-8")); }else{ // 请 求 失 败 代 码 } } catch (ClientProtocolException e) { e.printstacktrace(); } catch (IOException e) { e.printstacktrace(); }finally { try { if(response!=null){ response.close(); } httpclient.close(); } catch (IOException e) { 23 返 回 目 录
e.printstacktrace(); } } } } 爱 客 服 的 接 入 帮 助 指 南 至 此 结 束 如 您 任 何 疑 问, 请 与 我 们 工 作 人 员 联 系, 我 们 将 竭 诚 为 您 服 务 24 返 回 目 录