Use_Desk_iOS_SDK
Example
To run the example project, clone the repo, and run pod install from the Example directory first.
Requirements
Installation
Use_Desk_iOS_SDK is available through CocoaPods. To install it, simply add the following line to your Podfile:
Тестовое приложение
Для запуска тестового приложения нужно:
-Клонировать репозиторий
-Запустить терминал
-Перейти в скаченную дирректорию (в папку Example)
-Выполнить команду pod install
Скриншоты Тестового приложения
Добавление библиотеки в проект:
Библиотека Use_Desk_iOS_SDK доступна через систему управления зависимостями CocoaPods.
-Добавьте строчку в Podfile вашего приложения
pod 'Use_Desk_iOS_SDK'-Выполните команду в терминале pod update
-Подключаем библиотеку #import "UseDeskSDK.h"`
Выполняем операцию инициализации чата параметрами:
| Переменная | Тип | Описание |
|---|---|---|
| CompanyID | NSString | идентификатор компании |
| NSString | почта клиента | |
| URL | NSString | адрес сервера с номером порта |
Блок возвращает следующие параметры:
| Переменная | Тип | Описание |
|---|---|---|
| Success | BOOL | статус подключения к серверу |
| Error | NSString | описание ошибки при неудачном подключении |
Пример:
UseDeskSDK * usedesk = [[UseDeskSDK alloc] init];
[usedesk startWithCompanyID:@”1234567” email:@”[email protected]” url:@”https:dev.company.ru” port:@”213” connectionStatus:^(BOOL success, NSString *error) {
}];
Подключение SDK без графического интерфейса
-
Подключаем библиотеку #import "UseDeskSDK.h"
-
Выполняем операцию инициализации чата параметрами без GUI:
| Переменная | Тип | Описание |
|---|---|---|
| CompanyID | NSString | идентификатор компании |
| NSString | почта клиента | |
| URL | NSString | адрес сервера |
| Port | NSString | порт сервера |
Пример:
UseDeskSDK * usedesk = [[UseDeskSDK alloc] init];
[usedesk startWithoutGUICompanyID: :@”1234567” email: @”[email protected]” url: @”https:dev.company.ru:213” connectionStatus:^(BOOL success, NSString *error) {
}];Блок возвращает следующие параметры:
| Переменная | Тип | Описание |
|---|---|---|
| Success | BOOL | статус подключения к серверу |
| Error | NSString | описание ошибки при неудачном подключении |
Если тип ошибки noOperators то нет доступных операторов в данный момент времени
Отправка тестового сообщения:
| Переменная | Тип | Описание |
|---|---|---|
| Message | NSString | тест сообщения |
Пример:
[self.usedesk sendMessage:@”привет как дела?”];Отправка тестового сообщения с вложением:
| Переменная | Тип | Описание |
|---|---|---|
| Message | NSString | тест сообщения |
| FileName | NSString | имя файла |
| fileType | NSString | тип файла (MIMO) |
| contentBase64 | Base64 | данные |
Пример:
[self.usedesk sendMessage:text withFileName:@"file" fileType:@"image/png" contentBase64:content];Отправка оффлайн формы на сервер:
| Переменная | Тип | Описание |
|---|---|---|
| Message | NSString | тест сообщения |
| URL | NSString | адрес отправки |
Пример:
[self.usedesk sendOfflineFormWithMessage:@”привет” url: @”https:dev.cany.ru” callback:^(BOOL success, NSString *error){
}];Блок возвращает следующие параметры:
| Переменная | Тип | Описание |
|---|---|---|
| Success | BOOL | статус отправки |
| Error | NSString | тип ошибки |
CallBack – уведомления о действиях
Статус соединия:
Пример:
self.usedesk.connectBlock = ^(BOOL success, NSString *error) {
};Блок возвращает следующие параметры:
| Переменная | Тип | Описание |
|---|---|---|
| Success | BOOL | статус соединения |
| Error | NSString | тип ошибки |
Новое входящее сообщение:
| Переменная | Тип | Описание |
|---|---|---|
| incoming | BOOL | флаг входящего сообщения |
| outgoing | BOOL | флаг исходящего сообщения |
| text | NSString | текст сообщения |
| picture_image | UIImage | изображение |
| Error | NSString | тип ошибки |
Пример:
self.usedesk.newMessageBlock = ^(BOOL success, RCMessage *message) {
if(message.incoming)
[UDAudio playMessageIncoming];
};Статус соединия:
self.usedesk.errorBlock = ^(NSArray *errors) {
if(errors.count > 0)
hudErrorConnection.label.text = [errors objectAtIndex:0];
[hudErrorConnection showAnimated:YES];
};- Операторы завершили разговор
Блок возвращает следующие параметры:
| Переменная | Тип | Описание |
|---|---|---|
| Message | RCMessage | сообщение с type 4 – пользователь завершил разговор |
Пример:
self.usedesk.feedbackMessageBlock =^(RCMessage *message) {
};Author
Maxim, [email protected]
License
Use_Desk_iOS_SDK is available under the MIT license. See the LICENSE file for more info.


