Интеграция Freshdesk SDK для поддержки в мобильном приложении
Freshdesk SDK (Freshchat) — выбор, когда нужна тикет-система с чатом и при этом хочется избежать enterprise-ценников Zendesk или Intercom. SDK достаточно зрелый, но документация периодически отстаёт от актуальных версий, что создаёт нестандартные сложности при интеграции.
Установка
iOS
# Podfile
pod 'FreshchatSDK'
Freshchat SDK — тяжёлый: добавляет около 8–12 MB к размеру бинарника. Для приложений, где вес критичен, это важно учесть до начала интеграции.
Android
// build.gradle.kts
implementation("com.freshchat.consumer.sdk:freshchat-android:5.x.x")
Для Android требуется минимальный minSdk = 21 — если в проекте ниже, потребуется понижение или условная загрузка.
Инициализация
// iOS: AppDelegate
import FreshchatSDK
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
let config = FreshchatConfig(
appID: "YOUR_APP_ID",
andAppKey: "YOUR_APP_KEY"
)
config.teamMemberInfoVisible = true
config.showNotificationBanner = true
Freshchat.sharedInstance().initWith(config)
return true
}
// Android: Application.onCreate()
val config = FreshchatConfig("YOUR_APP_ID", "YOUR_APP_KEY")
config.isTeamMemberInfoVisible = true
Freshchat.init(this, config)
Идентификация и пользовательские свойства
// iOS: установка данных пользователя
let user = FreshchatUser.sharedInstance()
user.firstName = "John"
user.lastName = "Doe"
user.email = "[email protected]"
user.externalID = "user_id_12345"
Freshchat.sharedInstance().setUser(user)
// Кастомные свойства для агента
Freshchat.sharedInstance().setUserPropertyforKey("subscription_plan", withValue: "premium")
Важно: кастомные свойства передаются агенту — они видны в панели Freshdesk при просмотре чата. Не передавайте чувствительные данные (пароли, полные номера карт) даже в замаскированном виде.
Открытие интерфейса
// Конкретный канал поддержки
Freshchat.sharedInstance().showConversations(self, with: nil)
// FAQ-раздел
Freshchat.sharedInstance().showFAQs(self, with: nil)
Freshchat позволяет ограничить показываемые FAQ по тегам — удобно, если FAQ написаны на нескольких языках или для разных сегментов пользователей:
let options = FreshchatOptions()
options.tags = ["premium", "ios"]
Freshchat.sharedInstance().showFAQs(self, with: options)
Push-уведомления
// iOS: передаём APNs токен
func application(_ application: UIApplication,
didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
Freshchat.sharedInstance().setPushRegistrationToken(deviceToken)
}
// Обработка push
func application(_ application: UIApplication,
didReceiveRemoteNotification userInfo: [AnyHashable: Any]) {
if Freshchat.sharedInstance().isFreshchatNotification(userInfo) {
Freshchat.sharedInstance().handleRemoteNotification(userInfo, andAppState: application.applicationState)
}
}
Freshchat использует собственный push-канал через APNs. p8-ключ или p12-сертификат загружается в Freshdesk Admin → Mobile App.
Типичные проблемы
Конфликт тем на Android. Freshchat тянет свою тему FreshchatTheme и переопределяет цвета ActionBar. Если в приложении кастомная тема — после открытия Freshchat UI цвета тулбара сбрасываются. Решение: наследовать тему Freshchat от вашей базовой темы через FreshchatTheme override в styles.xml.
Localisation. SDK из коробки поддерживает несколько языков, но если нужна кастомная локализация строк интерфейса (например, брендированная кнопка «Написать нам» вместо «Start a conversation») — необходимо переопределять строки через Localizable.strings (iOS) или strings.xml (Android) с теми же ключами, что использует SDK.
Restore ID. После удаления и переустановки приложения история чата пропадает, если не реализовать механизм Restore ID. Freshchat генерирует ID при первой инициализации — его нужно сохранить на backend и восстанавливать при следующей сессии.
Ориентиры по срокам
Базовая интеграция с чатом и push — 2–4 дня. Полная интеграция с Restore ID, кастомной темой, FAQ по тегам и мультиязычностью — до 1 недели.