remo · документация
AI EN

Установить приложение и выключить его

Поставить приложение в организацию, открыть панель, проверить действие и убрать поверхность.

Статус: доступно обновлено 2026-11-16

Когда нужно

Команде нужна кнопка или короткая панель в комнате, а писать расширение не требуется.

Предусловия

  • Вы администратор организации.
  • Комната принадлежит этой организации: панель показывает приложения её организации.

Шаги

  1. Установите приложение:
curl -X POST https://boards.example.com/api/orgs/$ORG/apps \
  -H "Content-Type: application/json" --cookie "$SESSION" \
  -d '{"appId":"app.hello"}'
  1. Откройте комнату, затем Ещё (⋯) → Приложения.
  2. Ожидаемый результат: в панели есть приложение и его кнопка.

Проверка действия

  1. Нажмите Поздороваться.
  2. Ожидаемый результат: панель показывает «Привет, {ваше имя}!».
  3. В аудите организации появится app.invoked, в очередь событий — событие app.invoked.

Выключение

  1. Выключите приложение:
curl -X PATCH https://boards.example.com/api/orgs/$ORG/apps/app.hello \
  -H "Content-Type: application/json" --cookie "$SESSION" \
  -d '{"enabled":false}'
  1. Обновите панель.
  2. Ожидаемый результат: приложения в панели нет, его действие отвечает 404. Включение возвращает всё обратно.

Частые ошибки

Симптом Причина
404 RESOURCE_NOT_AVAILABLE при установке такого id нет в реестре продукта
403 FORBIDDEN вы не администратор организации
Панель пуста приложение выключено или комната без организации

Куда дальше

Приложения — что именно рисует панель и чего она не делает.