<small id="aimcq"></small>
  • # iOS集成文檔

    相關限制及注意事項
    1、iOS SDK新版支持 iOS8 以上版本。

    2、目前發布xcode版本為XCode 12.0,建議使用新版開發

    3、iOS目前僅僅支持超鏈接標簽,其他html標簽和屬性均不識別

    4、iOS需要申請麥克風、相機、相冊權限,否則部分功能無法使用

    智齒客服SDK具有以下特性

    • 在線咨詢:咨詢人工客服(收發圖片、發送視頻)、發送表情;
    • 高度自定義UI;

    # 1 文檔介紹

    # 1.1 集成流程示意圖

    圖片

    # 1.2.文件說明

    SDK包含(SobotOnline.framework和SobotOnline.bundle)、SobotDemo、和Doc相關說明文檔。

    文件名 說明 備注
    SobotOnline.framework 智齒SDK代碼庫
    SobotOnline.bundle SDK資源庫,包含圖片文件、多語言文件、顏色
    SobotOnlineService.h 關鍵功能操作類
    SobotOnlineConfig.h 功能配置類
    SobotCache.h 基礎框架設置類

    # 2 集成方式

    使用客服SDK需要加入的權限

    
    <key>NSCameraUsageDescription</key>
      <string>發送圖片需要訪問相機</string>
    <key>NSMicrophoneUsageDescription</key>
      <string>發送語音需要訪問麥克風</string>
    <key>NSPhotoLibraryUsageDescription</key>
      <string>發送圖片需要訪問相冊</string>
      
    

    # 2.1 手動集成

    下載鏈接:

    下載并解壓iOS_OnlineSDK,添加必要文件SobotOnline.framework和SobotOnline.bundle到你的工程里。

    # 2.2 CocoPods集成

    集成代碼,在podfile中加入:

    pod 'SobotOnlineSDK', '~> 1.0.0'
    
    

    如果查詢不到庫,請清除pod緩存:

    
    // 搜索不到最新版本
    pod cache clean --all
    rm -rf ~/Library/Caches/CocoaPods
    pod repo update
    
    刪除代碼中的pod 文件夾,
    pod cache clean 插件名
    再重新 pod install
    

    # 3.1 初始化和域名設置

    【說明:appid, app_key 請聯系智齒售后人員獲??;如果使用token方式接入,請參考接口文檔獲取token

    域名說明:

    * 默認SaaS平臺域名為:https://api.sobot.com

    * 如果您是騰訊云服務,請設置為:https://ten.sobot.com

    * 如果您是本地化部署,請使用自己的部署的服務域名

    方式一:以appid和appkey方式初始化SDK

    示例代碼:

    
    /// 初始化SDK,設置域名,獲取token
    /// @param appid  公司appid
    /// @param appkey 商戶appkey
    /// @param host  可以為空,默認阿里云服務;如果需要,請設置自己的域名
    +(void)initWithAppid:(NSString *) appid appkey:(NSString *) appkey host:(NSString * __nullable) host result:(void (^)(id object))resultBlock;
    
    // lg:
    [SobotOnlineService initWithAppid:@"你的appid" appkey:@"你的appkey" host:@"https://test.sobot.com" result:^(id  _Nonnull object) {
        
    }];
        
        
        
        
    

    方式二:直接以token方式初始化SDK

    
    /// 初始化SDK,設置域名和認證token
    /// @param token 認證token
    /// @param host  可以為空,默認阿里云服務;如果需要,請設置自己的域名
    /// @param resultBlock 返回結果
    +(void)initWithToken:(NSString *) token host:(NSString * __nullable) host result:(void (^)(id object))resultBlock;
        
    

    # 3.2 資源配置

    可選,默認為以下值,可自定義資源庫

    
    //指定加載的bundle名稱,默認SobotOnline
        [SobotCache shareSobotCache].sobotCacheEntity.bundleName = @"SobotOnline";
       
    //指定加載的顏色文件名稱,默認SobotColor
        [SobotCache shareSobotCache].sobotCacheEntity.colorTableName = @"SobotColor";
        
        
    

    # 3.3 啟動頁面

    # 3.3.1 普通版:

    詳情見Demo調用代碼;

    主要調用代碼如下:

    【注意:啟動頁面之前,必須調用初始化接口initWithAppid,否則將無法啟動】

    接口:

    
    
    
    /// 啟動客服認證頁面
    /// @param account 客服賬戶(郵箱)
    /// @param loginStatus 登錄狀態 2:忙碌,1:在線,0默認
    /// @param byController  啟動的controller
    +(void)startAuthWithAcount:(NSString *) account status:(int) loginStatus vc:(UIViewController *) byController result:(void (^)(id object))resultBlock;
     
            
    

    參數:

    參數名 類型 描述
    account NSString 客服郵箱
    status int -1為不置頂,0忙碌,1在線
    resultBlock NSString 啟動結果狀態回調

    示例代碼:

    
    #import <SobotOnline/SobotOnline.h>
    
    [SobotOnlineService startAuthWithAcount:@"zhangxy@sobot.com" status:1 vc:self result:^(id  _Nonnull object) {
        
    }];
    
    

    # 3.4 接口說明:

    # 3.4.1 登錄

    靜默上線客服,登錄后如果客服為在線狀態,能收到實時消息監聽

    
    #import <SobotOnline/SobotOnline.h>
    
    
    /// 僅登錄客服,不執行頁面邏輯
    /// @param account 客服賬戶(郵箱)
    /// @param loginStatus 登錄狀態 2:忙碌,1:在線,0使用默認值
    /// @param resultBlock 登錄結果
    [SobotOnlineService doLoginWithAccount:@"zhangxy@sobot.com" status:1 result:^(id  _Nonnull object) {
        
    }];
    
    
    

    # 3.4.2 退出登錄

    離線當前客服

    
    #import <SobotOnline/SobotOnline.h>
    
    
    /// 手動離線客服
    [SobotOnlineService outAdmin];
    
    

    # 3.4.3 獲取未讀消息

    獲取當前未讀消息總數,本地消息,重新登錄會清空

    
    #import <SobotOnline/SobotOnline.h>
    
    
    /// 獲取未讀消息數
    int num = [SobotOnlineService getUnReadNumber];
    
    

    # 3.4.4 設置消息監聽

    代理方式和block方式可任選一個監聽

    
    #import <SobotOnline/SobotOnline.h>
    
    // 以block方式
    [SobotOnlineService setReceiveMessageBlock:^(id message, int nleft, NSDictionary *object) {
        
    }];
        
    // 設置代理方式
    [SobotOnlineService setReceiveMessageDelegate:self];
        
        
        
        
    //設置消息鏈接點擊監聽; 返回YES自己處理,內部不會再做處理
    [SobotOnlineService setSobotLinkBlock:^BOOL(id object, NSString *linkUrl) {
        if([linkUrl isEqual:@"我喜歡"]){
            // do something
            return YES;
        }
        return NO;
    }];
    
    

    # 3.4.5 功能配置

    以屬性方式配置部分功能、配置顏色配置功能顯影等,暫未實現 例如: 是否自動提醒

    
        SobotOnlineConfig *config = [SobotOnlineService getCurOnlincConfig];
        config.autoNotifaction = YES;
        [SobotOnlineService configSobotOnline:config];
            
        
    
    大星彩票 <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <文本链> <文本链> <文本链> <文本链> <文本链> <文本链>