Створення інтеграції

Мобільні SDK чату

Додайте чат підтримки Sonny у свій клієнтський застосунок для iOS, Android або React Native. Клієнти зможуть зв’язатися з вашою командою прямо із застосунку, а ви відповідатимете в наявних вхідних Sonny.

Шукаєте застосунок, у якому ваша команда підтримки відповідає клієнтам? Установіть застосунок Sonny для агентів.

Виберіть SDK

Підключіть свій застосунок

  1. У середовищі Sonny з увімкненою мобільною підтримкою відкрийте Канали → Онлайн-чат → Мобільні застосунки. Власник або адміністратор створює ключ застосунку для кожної платформи та кожного bundle ID чи application ID.
  2. Установіть SDK згідно з README у його репозиторії. Налаштуйте його, вказавши ID сайту та публічний ключ застосунку для відповідної цільової збірки. Для React Native потрібні окремі ключі застосунку для iOS та Android.
  3. Показуйте чат як повноекранну розмову або вбудуйте його у свій застосунок. Одночасно має бути активним лише одне вікно чату.
  4. Для клієнтів, які ввійшли в систему, створіть JWT ідентичності на своєму сервері й передайте його в SDK. Під час виходу викличте reset(), щоб розпочати новий сеанс відвідувача.

Ключі застосунків — це публічні ідентифікатори. Секрети для підписування ідентичності та ключі постачальників сповіщень зберігаються на вашому сервері або в захищених налаштуваннях Sonny.

Push-сповіщення

Дозвіл на сповіщення й отримання токена — відповідальність вашого застосунку. SDK приймає токен APNs на iOS або токен FCM на Android і обробляє натискання на сповіщення Sonny. Для доставки потрібні облікові дані вашого власного застосунку: ключ підпису APNs та ID команди й ключа Apple або сервісний обліковий запис FCM для вашого проєкту Firebase. Облікові дані застосунку Sonny для агентів належать іншому застосунку. У цій попередній версії доставка push-сповіщень ще перевіряється.

  1. Завантажте облікові дані постачальника для свого застосунку в розділі Мобільні застосунки. Для APNs середовище (sandbox чи production) має відповідати вашій збірці.
  2. Відкрийте застосунок, дозвольте сповіщення й передайте його токен у SDK. Оновіть список пристроїв у налаштуваннях і виберіть свій тестовий пристрій за часом реєстрації.
  3. Переведіть застосунок у фоновий режим і натисніть Надіслати тестове push-сповіщення. Перевірте, чи надійшло воно на пристрій. Статус у налаштуваннях показує, чи прийняв сповіщення постачальник, або безпечний код помилки; саме прийняття ще не підтверджує доставку.
  4. Щоб протестувати розмову, надішліть відповідь агента або AI, поки відвідувач не підключений. Сповіщення про відповідь відкриває цю розмову, якщо ваш застосунок передає натискання в handlePush. Загальне тестове сповіщення розмову не відкриває.

Повідомте про проблему або долучіться до розробки

Відкрийте issue в репозиторії SDK, яким користуєтеся. Укажіть його версію або коміт, версії ОС і фреймворка, а також мінімальний приклад для відтворення. Кожен репозиторій приймає pull request і містить настанови щодо внеску та повідомлення про проблеми безпеки. Не додавайте в публічні issue дані клієнтів, JWT ідентичності, токени пристроїв і приватні ключі.

Пов’язані посібники