与应用用户聊天，集成您喜欢的工具，并提供卓越的客户体验。

Crisp iOS SDK

安装

Cocoapods

CocoaPods 是 Cocoa 项目的依赖管理器。您可以使用以下命令安装它：

$ gem install cocoapods

要使用 CocoaPods 将 Crisp 集成到您的 Xcode 项目中，在 Podfile 中指定它：

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'Crisp'
end

然后，运行以下命令：

$ pod install

Carthage

Carthage 是一个集中式依赖管理器，它会构建您的依赖项并提供二进制框架。

您可以使用以下命令通过 Homebrew 安装 Carthage：

$ brew update
$ brew install carthage

要使用 Carthage 将 Crisp 集成到您的 Xcode 项目中，在您的 Cartfile 中指定它：

github "crisp-im/crisp-sdk-ios"

运行 carthage update 以构建框架，并将构建的 Crisp.framework 拖入您的 Xcode 项目。

确保嵌入二进制文件

需求

⚠️添加相机和照片权限是强制性的，在 Info.plist 中添加 NSCameraUsageDescription 和 NSPhotoLibraryUsageDescription，以通知用户您需要访问相机和照片库。您还必须启用 “iCloud 文档” 功能

获取您的网站 ID

您的网站 ID 可在 Crisp 应用 URL 中找到

• https://app.crisp.chat/website/[网站ID]/inbox/

Crisp 网站 ID 是一个像 e30a04ee-f81c-4935-b8d8-5fa55831b1c0 这样的 UUID

用法（Swift）

通过在您的 AppDelegate 中添加以下代码开始使用 Crisp

import Crisp
Crisp.initialize(websiteId: "YOUR_WEBSITE_ID")

您可以通过在视图中添加 CrispView() 来添加 Crisp 视图

import UIKit
import Crisp

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        
        let crispView = CrispView()
        crispView.bounds = view.bounds
        crispView.center = view.center

        view.addSubview(crispView)
    }

    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
    }
}

用法（Objective-C）

通过在您的 AppDelegate 中添加以下代码开始使用 Crisp

#import "Crisp-Swift.h"

[[CrispMain alloc] initializeWithWebsiteId:@"YOUR_WEBSITE_ID"];

您可以通过在视图中添加 CrispView() 来添加 Crisp 视图

#import "Crisp-Swift.h"

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    CrispView *crispView = [[CrispView alloc] init];
    crispView.bounds = self.view.bounds;
    crispView.center = self.view.center;
    
    [self.view addSubview:crispView];
}

API 使用（Swift）

• Crisp.tokenId = "XXXX" 设置您的 own token_id
• Crisp.locale = "it" 使用自定义区域设置覆盖 Crisp locale
• Crisp.user.set(email: "[email protected]");
• Crisp.user.set(nickname: "John Doe");
• Crisp.user.set(phone: "003370123456789");
• Crisp.user.set(avatar: "https://pbs.twimg.com/profile_images/782474226020200448/zDo-gAo0_400x400.jpg");
• Crisp.session.set(data: ["key" : "value"]);
• Crisp.session.set(segment: "segment");
• Crisp.session.set(segments: ["segment1", "segment2"]);
• Crisp.session.pushEvent(name: "signup", ["key" : "value"], "blue");
• Crisp.session.reset();

API 使用（Objective-C ）

UserInterface *user = [[UserInterface alloc] init];
[user setWithEmail:@"[email protected]"];
[user setWithNickname:@"John Doe"];
[user setWithPhone:@"003370123456789"];
[user setWithAvatar:@"https://pbs.twimg.com/profile_images/782474226020200448/zDo-gAo0_400x400.jpg"];

SessionInterface *session = [[SessionInterface alloc] init];

NSMutableDictionary *dict = [NSMutableDictionary dictionary];
[dict setObject: @"Value"  forKey: @"Key"];

[session setWithData:dict];
[session setWithSegment:@"segment"];
    

致谢

Crisp iOS SDK 由 Crisp IM, SARL 拥有和维护。您可以在 crisp 上与我们交流，或在 Twitter 上关注我们 Crisp_im

授权

Crisp iOS SDK 在版权授权下。更多信息请参见 LICENSE。