Clomni

Создание приложения на developer.clomni.ai: пошагово

Обновлено: 11 ноября 2026 · 7 мин чтения

Приложение это интеграция, которую Вы регистрируете на developer.clomni.ai: внутри неё название, scope (разрешения), токены и вебхук. Приложение можно создать только в workspace, где Вы администратор. На портал Вы входите со своим аккаунтом my.clomni.co, отдельной регистрации нет.

Шаги

  1. 1

    Войдите и примите условия

    Откройте developer.clomni.ai и нажмите «Sign in with Clomni». При первом входе открываются «Developer Terms» (условия для разработчиков, версия 2026-11-09). Пока Вы не примете условия, создать приложение нельзя. Основные правила: продавать данные workspace и использовать их для рекламы запрещено, токены хранятся только на сервере, об утечке нужно сообщить в Clomni не позже чем через 72 часа.

  2. 2

    Создайте приложение

    Кнопка «New app» открывает форму из трёх шагов:

    1. Название (до 60 символов) и краткое описание (до 500 символов).
    2. Workspace: в списке видны только workspace, где Вы администратор. Затем выберите готовый набор или scope.
    3. Итоговая проверка.

    Выберите тип: внутреннее приложение для своего workspace или «Public app» для приложения, которое будут подключать другие компании. Тип потом изменить нельзя. У одного человека может быть не больше 50 приложений. Если в списке нет workspace, Вы не администратор ни в одном workspace: попросите роль у администратора.

  3. 3

    Выберите готовый набор

    Набор сам отмечает scope, лишние Вы потом удаляете:

    • «Clomni in my own panel» (Clomni в моей панели): показывать диалоги в своей системе, отвечать, назначать.
    • «CRM sync» (синхронизация с CRM): держать контакты и диалоги синхронизированными с CRM.
    • «BI and reporting» (BI и отчёты): забирать цифры отчётов в BI-инструмент.
    • «Data export» (экспорт данных): массово выгружать данные.
    • «AI management» (управление AI): управлять AI-агентами и базой знаний из кода.

    Что делает каждый scope, описано в статье «Какие scope нужны: scope и endpoint по Вашей задаче».

  4. 4

    Заполните данные приложения

    Укажите в настройках приложения следующее, review (проверка) смотрит на эти данные:

    • сайт, ссылка на политику конфиденциальности (с https://), ссылка на условия использования;
    • e-mail поддержки;
    • ссылка на порядок удаления данных: страница, которая объясняет, как Вы удаляете данные, полученные из Clomni, когда приложение удалено;
    • название компании и ИНН (VOEN, 10 цифр).

    Для публичного приложения дополнительно заполняются redirect URI (не больше 10) и листинг для каталога.

  5. 5

    Отправьте scope на review

    Новый scope получает статус «Draft» (черновик). В форме review для каждого scope напишите не меньше 100 символов о том, зачем он нужен, и отправьте. Сотрудник Clomni смотрит, решение приходит по e-mail. Поля формы и причины отказа: статья «Review: проверка scope и причины отказа». Пока ждёте review, можно проверять приложение в тестовом канале.

    Список «Go live» на странице обзора приложения показывает, что осталось: ссылка на политику конфиденциальности, scope запрошен, review отправлен, scope одобрен, токен создан (у публичного приложения: первая установка), первый запрос. У публичного приложения дополнительно: redirect URI, готовность листинга и появление в каталоге.

  6. 6

    Создайте токен

    Когда одобрен хотя бы один scope, нажмите «Create token» в разделе «Credentials» (учётные данные) приложения: выберите название, scope и срок (30, 60, 90, 180 или 365 дней). Токен показывается только один раз, сразу сохраните его в надёжном месте. Для серверной интеграции можно также создать client secret кнопкой «Create secret». Подробнее: статья «Токены и аутентификация в Developer API».

  7. 7

    Статусы приложения

    • «Draft» (черновик): ни один scope не отправлен.
    • «In review» (на проверке): есть ожидающий review, ни один scope ещё не одобрен.
    • «Changes requested» (нужны исправления): в последнем review запрошены исправления.
    • «Live»: одобрен хотя бы один scope. Когда Вы добавляете новый scope, приложение остаётся Live.
    • «Rejected» (отклонено): все scope отклонены.
    • «Suspended» (приостановлено): Clomni приостановил приложение, токены отозваны.
    • «Archived» (в архиве): Вы удалили приложение. Все его токены отзываются, вебхук отключается, а если это публичное приложение, оно удаляется из всех workspace, которые его подключили.

    Создавайте приложение с постоянного аккаунта компании: если владелец приложения не администратор workspace, токены не работают.

Документ

Платформа для разработчиков: руководство v1.0 · 41 стр. Открыть Скачать