Ваш інтернет-магазин уже використовує Jivo для веб-чату. Тепер клієнти чекають підтримки в мобільному додатку. Але інтеграція Jivo SDK — не просто «додати бібліотеку»: потрібно налаштувати ініціалізацію, передачу контексту клієнта та push-сповіщення. Без тонкого налаштування оператори не бачать історію або не отримують повідомлення. Ми інтегрували Jivo SDK у 15+ проєктів під iOS та Android і знаємо, де найчастіше спотикаються. За багаторічний досвід виробили алгоритм, що скорочує час налаштування на 40% порівняно з самостійною реалізацією. Отримайте консультацію з інтеграції — це безкоштовно.
Перший сценарій — клієнт авторизований, і оператору потрібно бачити його дані: ім'я, контакт, тарифний план. Другий — push-сповіщення приходять тільки коли оператор онлайн. Третій — кастомізація: SDK дозволяє міняти кольори, але не layout, що конфліктує з дизайн-системами. Розберемо кожен кейс і покажемо, як ми це вирішуємо. Зв'яжіться з нами — оцінимо ваш проєкт за один робочий день.
Установка та ініціалізація
iOS
# Podfile pod 'JivoSDK' // AppDelegate.swift import JivoSDK func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { JivoSDK.shared.set(channelID: "your_channel_id") return true } func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) { JivoSDK.shared.setPushToken(deviceToken) } Android
// build.gradle.kts implementation("com.jivosite:sdk:3.x.x") // Application.onCreate() JivoSDK.init(this, "your_channel_id") channelID береться з панелі Jivo: Налаштування → Канали → Мобільний додаток.
Відкриття чату та передача даних клієнта
// iOS: відкрити чат і передати контекст JivoSDK.shared.presentContactForm(over: viewController) JivoSDK.shared.setContactInfo( name: "Іван Іванов", email: "[email protected]", phone: "+380901234567", brief: "Тариф: Premium, ID: 12345" ) Поле brief видно оператору як «замітка» — зручно передавати тариф, ID замовлення, останню дію. Оператор одразу розуміє, з ким розмовляє, не перемикаючи вікна.
Як налаштувати push-сповіщення?
SDK використовує APNs (iOS) та FCM (Android). Токен передається через setPushToken. Важливий нюанс: push-сповіщення приходять тільки коли оператор в мережі. Якщо всі офлайн — повідомлення не відправиться. Це особливість Jivo: SDK працює в зв'язці з операторським додатком, а не як самостійний push-сервіс. Ми реалізуємо fallback: якщо оператор неактивний, показуємо in-app сповіщення або пропонуємо залишити контакт. Згідно з документацією Jivo, push-сповіщення вимагають активної сесії оператора.
Чому кастомізація Jivo SDK — компроміс?
SDK надає базові методи зміни зовнішнього вигляду: setTitleColor, setAccentColor, setFont. Повністю перебудувати layout не можна. Якщо дизайн-система продукту строга, ми пропонуємо гібридний варіант: вбудувати WebView з Jivo-чатом і кастомізувати через CSS. Це потребує додаткової роботи (1–2 дні), але дає повний контроль.
Порівняння Jivo SDK з альтернативами
| Критерій | Jivo SDK | Zendesk SDK | Intercom SDK |
|---|---|---|---|
| Мова інтерфейсу | російська, англійська | 40+ мов | 20+ мов |
| Кастомізація | обмежена (кольори, шрифти) | широка (компоненти) | середня (теми) |
| Push-сповіщення | тільки при активному операторі | працюють завжди | працюють завжди |
| Термін інтеграції (наш досвід) | 1–2 дні | 3–5 днів | 2–4 дні |
| Передача контексту клієнта | через brief |
через SDK-методи | через атрибути |
Jivo SDK виграє у простоті інтеграції та швидкості — базове налаштування займає день. Якщо потрібна мультимовність або повний контроль UI, краще розглянути Zendesk. Але для українського ринку та україномовних операторів Jivo — оптимальний вибір.
Типові проблеми та їх вирішення
| Проблема | Рішення |
|---|---|
| Push не приходять на iOS | Перевірити виклик setPushToken після реєстрації push |
| Невірний channelID | Скопіювати з панелі Jivo: Налаштування → Канали |
| Застаріла версія SDK | Оновити до останньої з GitHub |
| Немає зворотного зв'язку при офлайн-операторі | Додати fallback: in-app сповіщення або контактна форма |
Що входить в інтеграцію Jivo SDK
- Встановлення та налаштування SDK під iOS (Swift 5.9+, UIKit/SwiftUI) та Android (Kotlin 1.9+, Jetpack Compose).
- Конфігурація каналу в панелі Jivo (отримання channelID, налаштування прав операторів).
- Реалізація передачі даних авторизованого клієнта (ім'я, контакт, контекстна записка).
- Інтеграція push-сповіщень через APNs (iOS) та FCM (Android) з генерацією сертифікатів та обробкою токенів.
- Налаштування обробки станів: оператор онлайн/офлайн, відсутність мережі.
- Тестування на реальних пристроях (iPhone, Android) та в TestFlight / Firebase App Distribution.
- Документація: архітектурна схема, опис методів, інструкція для операторів.
- Гарантія сумісності з останніми версіями iOS та Android.
Ця послуга — вкладення, яке окупається за рахунок автоматизації консультацій. Ми допомагаємо оптимізувати бюджет, виключаючи типові помилки.
Орієнтири за термінами
Базова інтеграція з чатом, передачею даних та push — 1–2 дні. Якщо потрібна глибока кастомізація або зв'язка з CRM/аналітикою — до 4 днів. Вартість розраховується індивідуально: залиште заявку, і ми підготуємо комерційну пропозицію.
Типові помилки при інтеграції Jivo SDK
- Забувають викликати
setPushTokenв iOS, через що push не приходить. - Передають невірний
channelID(плутають з ID сайту). - Використовують застарілу версію SDK: перевіряйте актуальну на Jivo Developer Hub.
- Не тестують сценарій офлайн-оператора: користувач пише повідомлення, але відповідь не приходить — і немає зворотного зв'язку.
- Намагаються кастомізувати layout стандартними методами — впираються в обмеження.
Ми за багаторічний досвід роботи з Jivo SDK накопичили бібліотеку типових рішень цих проблем. Якщо хочете уникнути граблів, отримайте консультацію — це безкоштовно. Замовте оцінку вашого проєкту — ми зв'яжемося протягом дня.