Раздел для разработчиков

Developer-раздел

Откройте раздел "Developer" или "Разработчикам".

Раздел предназначен для внешних интеграций, готовых решений и других типов приложений, доступных в текущей версии кабинета.

Возможности

интеграции на внешнем сайте через OAuth;
каталог готовых решений;
установка приложений в проект;
управление установленными приложениями;
готовые решения;
версии готовых решений;
инструменты агентов и встроенные страницы, если эти типы доступны;
webhooks;
ссылки на API-документацию и Storybook.

Типы приложений

Интеграция на вашем сайте - внешний сайт подключает проект через Client ID, Client Secret, адрес возврата и выбранные разрешения.
Готовое решение - готовый сценарий или воронка, которые пользователи устанавливают в свой проект; у этого типа нет OAuth-настроек.
Инструмент для агента - приложение, которое добавляет агенту новые действия; доступность зависит от версии продукта.
Встроенная страница - приложение со своей страницей внутри кабинета; доступность зависит от версии продукта.

Создание developer-приложения

имя;
описание;
тип приложения: выбирается один вариант карточкой.

Участники приложения

У developer-приложения есть отдельный экран "Участники". Он относится к команде, которая разрабатывает и публикует приложение, а не к проектам, куда приложение установлено.

Участники проекта управляются отдельно: откройте пункт «Участники» в боковом меню проекта, затем страницу участников проекта и кнопку приглашения сотрудника. Не используйте участников developer-приложения для выдачи доступа к проекту.

Вкладка "Участники" показывает активных и неактивных участников, роль и дату добавления. Поиск работает по имени, email или ID. Роли: владелец, администратор, разработчик и наблюдатель. Владельца нельзя редактировать из обычного меню; администратор и владелец могут управлять участниками.

Вкладка "Приглашения" показывает приглашения по ID пользователя или email. Состояния: ожидает ответа, принято, отклонено, истекло или отменено. Ожидающее приглашение можно переотправить после небольшой паузы или отменить; после отмены ссылка больше не работает.

Как пригласить участника

На странице участников приложения нажмите «Пригласить».
Выберите приглашение по ID пользователя или по email.
Укажите ID пользователя либо email в зависимости от выбранного способа.
Выберите роль: администратор, разработчик или наблюдатель. Роль владельца через приглашение не передается.
Нажмите «Создать приглашение».
Кабинет покажет ссылку приглашения. Нажмите копирование и передайте ссылку приглашенному человеку.

До принятия приглашения человек не становится участником приложения. Созданное приглашение также появляется на вкладке "Приглашения", где можно проверить его состояние.

Как изменить или удалить участника

Откройте участника на вкладке "Участники". На странице редактирования выберите роль и нажмите «Сохранить». Блок разрешений показывает права, которые даёт роль; отдельные разрешения на этой странице не переключаются.

Чтобы отозвать доступ к приложению, нажмите «Удалить участника» и подтвердите действие через «Удалить». Это удаляет человека из команды developer-приложения, но не из проектов, в которых он состоит отдельно. Владельца приложения таким способом изменить или удалить нельзя.

Каталог и установки

текущий каталог показывает только готовые решения, доступные для установки;
интеграции на внешнем сайте не показываются в каталоге установки проекта;
доступность инструментов агентов и встроенных страниц зависит от версии продукта;
установка может запросить доступы к проекту и шаги настройки;
для готового решения доступ разработчика к связанным диалогам включён по умолчанию при установке, но владелец проекта может выключить его до установки или позже; доступ ограничен диалогами, где участвовали агенты этого решения;
установленное приложение можно удалить, если ему больше не нужен доступ к проекту;
если установка не проходит, проверьте опубликованную версию, обязательные шаги настройки и права пользователя в целевом проекте.

Где это в интерфейсе

Основные элементы раздела:

пункт «Приложения» в боковом меню проекта
OAuth-ключи приложения
список приложений разработчика
раздел разработчика
страница создания developer-приложения
кнопка создания developer-приложения
страница developer-приложения
страница настроек developer-приложения
страница версий готового решения
страница версии готового решения
страница шага настройки версии
страница webhooks developer-приложения
страница участников developer-приложения
страница редактирования участника developer-приложения
роль участника приложения
права выбранной роли
сохранение роли
удаление участника из приложения
приглашение участника developer-приложения