Как создать канал Mobile app (App SDK) и где его настройки

Обновлено: 9 октября 2026 · 13 мин чтения

Шаги

1. 1

   Откройте каталог

   На странице «Settings › Workspace settings › Inboxes» нажмите «Add Inbox». В каталоге на карточке «Mobile app (App SDK)» нажмите «Connect».

   Если карточки нет, канал в Вашем аккаунте не включён. Его включает команда Clomni: напишите Clomni AI, запрос будет передан команде.

2. 2

   Шаг 1: App details

   • «Channel name»: имя, которое операторы видят в списке каналов, например «Example app».
   • «Platforms»: iOS, Android или обе.
   • «Android package name»: applicationId в app/build.gradle(.kts), например com.example.app.
   • «iOS Bundle ID»: Bundle Identifier цели приложения в Xcode (Signing & Capabilities). iOS SDK при подключении отправляет Bundle ID приложения, и если он отличается от указанного здесь, сервер отклоняет ключ. Вводите имя пакета и Bundle ID внимательно: после создания канала в панели нет места, где их можно изменить, ошибку исправляет команда Clomni.
   • «Take the look from a website chat»: цвет, логотип и тексты чата Вашего сайта станут начальными значениями. Или «Don't, use the default look».

   Нажмите «Create». Канал и его ключи создаются сразу.

3. 3

   Шаг 2: Installation

   App ID, «Android API key» и «iOS API key» показаны с кнопкой «Copy», есть готовый код для каждой платформы. Скопируйте ключи сейчас: полностью они показываются только на этом шаге. Потом панель показывает лишь начало ключа. Если ключ потерян, создайте новый кнопкой «New key» в разделе Installation.

4. 4

   Шаг 3: Identity verification

   Identity Secret показывается один раз. Сохраните его на сервере (например CLOMNI_IDENTITY_SECRET) и никогда не кладите в приложение. Отметьте «I have stored the secret safely». «Mode» пока оставьте «Recommended».

5. 5

   Шаги 4-6: Push, Appearance, Flows

   • «Push notifications»: service account JSON из Firebase (Android) и ключ APNs .p8 (iOS). Если их ещё нет, «Do it later».
   • «Appearance»: основной цвет, логотип, приветствие, тема и плавающая кнопка.
   • «Flows»: выберите «New conversation flow». Он копируется в этот канал как черновик. Messenger запускает его только после публикации.

   Шаг, пропущенный через «Do it later», остаётся предупреждением в «Overview» канала, пока его не выполнят. В конце «Finish».

6. 6

   Страница канала и колонка настроек

   Позже канал открывается из списка «Settings › Workspace settings › Inboxes». Настройки канала находятся в отдельной колонке рядом с меню панели. Вверху колонки название канала, кнопка ← справа от него возвращает к списку каналов. Разделы разбиты на три группы:

   • APP: «Overview», «Installation», «Security», «Push», «Guide».
   • MESSENGER: «Appearance», «Flows», «News», «CSAT» и «Bot Configuration», если в аккаунте включены боты.
   • INBOX: «Settings», «Collaborators», «Business Hours», «Analytics».

   Открытый раздел выделен в колонке цветом. На узком экране (меньше 900 px) колонка становится выпадающим списком вверху страницы. В этих статьях путь записывается так: «Settings › Workspace settings › Inboxes» › Ваш канал › колонка настроек › «Installation».

7. 7

   Overview

   Первое место, куда смотреть, если что-то не работает. Статус каждой платформы: «Not installed», «Installed» (была сессия за последние 30 дней), «Securely installed» (режим Enforced и был подтверждённый вход за 7 дней), «Push keys added», «Push active». «Warnings» называют проблему, например входы, отклонённые из-за неверного хеша, или старый SDK. «Fix» открывает нужный раздел.

8. 8

   Installation

   • «API keys»: App ID и начало ключа каждой платформы, кнопка «Copy».
   • «New key» создаёт новый ключ для платформы и один раз показывает его полностью. Старый ключ работает ещё 7 дней, потом версии приложения со старым ключом не подключаются.
   • «Revoke» сразу останавливает ключ. Используйте для утёкшего ключа.
   • «Code»: готовый код с Вашим App ID.
   • «Recent devices»: последние подключившиеся устройства, модель, ОС, версии приложения и SDK, время последнего появления. Устройство появляется через несколько секунд после того, как приложение вызвало initialize и открыло сессию.
9. 9

   Security

   • «Mode»: «Off», «Recommended» или «Enforced». Выбор вступает в силу после «Save».
   • «Identity Secret» › «Make a new secret»: новый secret показывается один раз, старый работает ещё 7 дней.
   • «Test a hash»: введите user_id и user_hash, сделанный Вашим сервером, нажмите «Check». Панель скажет, сделан ли хеш текущим secret, старым или не совпадает.
   • «The hash on your server»: готовый код для Node.js, PHP, Python, .NET и Java.

   Подробнее в статье «Ключи мобильного SDK и идентификация пользователей (user_hash)».

10. 10

    Push

    • «Android · Firebase Cloud Messaging» и «iOS · Apple Push Notification service»: здесь загружаются ключи, «Replace» заменяет ключ, «Remove» удаляет.
    • «Last 7 days»: по каждой платформе «Sent», «Failed», «Removed tokens» и «Skipped» (не отправлено, потому что нет ключа).
    • «Notification title»: что написано в первой строке уведомления.
    • «Test push»: отправляет тестовый push на выбранное устройство.

    Как получить ключи и что значат ответы, написано в статье «Ключи push для мобильного SDK: Firebase (FCM) и APNs».

11. 11

    Guide

    • «Download the guide (PDF)»: это руководство на четырёх языках: азербайджанском, английском, турецком и русском. Язык панели идёт первым.
    • «Online guide language»: ссылки ниже открывают руководство на этом языке.
    • «Platforms»: карточки Android, iOS, React Native, Flutter и Unity. В каждой строка установки пакета с кнопкой «Copy» и ссылка «Online guide» на главу этой платформы.
    • «Other chapters»: «Overview», «Panel settings», «User identity», «Push keys», «Troubleshooting».
12. 12

    Collaborators и Analytics

    • «Collaborators»: операторы, которые видят диалоги этого канала. Оператор, которого здесь нет, не видит диалоги из приложения.
    • «Analytics»: активные устройства (за день, 7 и 30 дней), диалоги, время первого ответа, отправленные push и версии SDK.
13. 13

    Полное руководство

    • PDF: руководство Clomni Mobile SDK, на русском языке.
    • Онлайн: Clomni dashboard (на английском).
    • В панели: раздел «Guide» в колонке настроек канала.