菜单

SaleSmartly Android SDK开发者文档

注： Android版本 >= 7.0 webview组件版本 >= 53

App Manifest需要的权限

复制代码

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

aar包地址

传送门

1.初始化SDK

复制代码

    SaleSmartyInit.init(Context context,String scriptUrl);

scriptUrl 为插入的js，比如 https://assets.salesmartly.com/js/project_xxxxx.js

2.初始化SaleSmarty网页

复制代码

    SaleSmartyInit.initSaleSmartyView(Activity activity);

注意:在Activity初始化浏览器越早越好

3.添加浏览器到父布局

复制代码

    SaleSmartyInit.addSaleSmartyView(ViewGroup viewGroup);

注意:添加的父布局所在的Activity必须跟执行初始化salesmarty网页的Activity一致

4.上传用户信息

复制代码

    SaleSmartyInit.uploadUserMessage(String user_id,
                                     String user_name,
                                     String language,
                                     String phone,
                                     String email,
                                     String description,
                                     String[] label_names);

注意:上传用户信息暂时不支持回调, user_id 和 user_name 是必填的

5.打开窗口

复制代码

    SaleSmartyInit.openSaleSmartyView();

6.关闭窗口

复制代码

    SaleSmartyInit.closeSaleSmartyView();

7.获得未读信息数

复制代码

    SaleSmartyInit.setUnReadMessagesListener(c var0);

注意: 参数c接口会返回一个int值，就是未读的数量

8.文件选择回调

复制代码

    SaleSmartyInit.upLoadFiles(int requestCode,Intent var0);

注意: SaleSmartyInit要在执行初始化salesmarty网页的Activity的onActivityResult调用

9.监听加载完成(1.2.0版本开始支持)

复制代码

    SaleSmartyInit.setOnReadyListener(c var0);

10.监听窗口打开

复制代码

    SaleSmartyInit.setOnOpenSaleSmartyViewListener(c var0);
    // 1.2.0版本默认执行打开操作

11.监听窗口关闭

复制代码

    SaleSmartyInit.setOnCloseSaleSmartyViewListener(c var0);

12 发送预设文本消息

复制代码

SaleSmartyInit.sendTextMessage(String message);

13 隐藏上传入口

复制代码

SaleSmartyInit.hideUpload(String[] hideUploadList);

hideUploadList 可传 img、document、video。

14 隐藏关闭图标

复制代码

SaleSmartyInit.hideCloseIcon();

15 获取侧边栏折叠高度

复制代码

SaleSmartyInit.getSidebarHeight(SaleSmartlySidebarHeightListener listener);

通过 SaleSmartlySidebarHeightListener 返回 height。

16.新增回调型 API（1.2.3版本开始支持）

以下接口通过 SaleSmartlyEventListener 返回 widget 原始 payload 的 JSON 字符串：

复制代码

SaleSmartyInit.setOnOpenLineListener(SaleSmartlyEventListener listener);
SaleSmartyInit.setOnOpenLineAppListener(SaleSmartlyEventListener listener);
SaleSmartyInit.setOnOpenMessengerListener(SaleSmartlyEventListener listener);
SaleSmartyInit.setOnOpenEmailListener(SaleSmartlyEventListener listener);
SaleSmartyInit.setOnOpenTelegramListener(SaleSmartlyEventListener listener);
SaleSmartyInit.setOnOpenWhatsappListener(SaleSmartlyEventListener listener);
SaleSmartyInit.setOnOpenInstagramListener(SaleSmartlyEventListener listener);
SaleSmartyInit.setOnOpenTikTokListener(SaleSmartlyEventListener listener);
SaleSmartyInit.setOnOpenVKontakteListener(SaleSmartlyEventListener listener);
SaleSmartyInit.setOnOpenZaloListener(SaleSmartlyEventListener listener);
SaleSmartyInit.setOnOpenWeixinListener(SaleSmartlyEventListener listener);
SaleSmartyInit.setOnOpenCustomListener(SaleSmartlyEventListener listener);

示例：

复制代码

SaleSmartyInit.setOnSendMessageListener(data -> {
    // data 是 widget 传出的 JSON 字符串
});

17.WhatsApp 问候语回调（1.2.3版本开始支持）

demo示例

SaleSmartly Android SDK Demo示例，点击下载

上一个

SaleSmartly聊天插件JSSDK开发者文档

下一个

SaleSmartly IOS 开发者文档

最近修改: 2026-06-24Powered by

大纲