Подключённые приложения
Список сторонних приложений, которым владелец аккаунта разрешил работать с данными вашего бизнеса, — например, сервиса, который принимает заказы или готовит отчёты о продажах. Здесь видно, к чему у каждого приложения есть доступ, и этот доступ можно отозвать. Стороннее приложение подключают из самого приложения, а на этой странице владелец может создать свою интеграцию — ключ для собственных скриптов и сервисов.
Как открыть
Настройки → раздел Интеграции → Подключённые приложения (/settings/connected-apps).
Если пункта нет в меню, подключение приложений в вашем личном кабинете пока недоступно.
Как приложение получает доступ
- Вы начинаете подключение в самом приложении.
- Приложение открывает экран подтверждения на нашем сервере (Paloma365 или PalomaPOS — в зависимости от рынка). Если в этом браузере вы не вошли в личный кабинет под учётной записью владельца, экран попросит войти и нажать Продолжить.
- На экране видно, какое приложение и какой разработчик запрашивает доступ, что именно приложение сможет делать и на какой сайт оно вернёт вас после ответа. Если приложение разработчик зарегистрировал сам и команда Paloma365 его не проверяла, экран об этом предупреждает — подключайте такое приложение, только если знаете разработчика. Владелец нажимает Разрешить или Отмена.
- После согласия приложение появляется в списке на этой странице.
Дать согласие может только владелец аккаунта — тот, кто входит в личный кабинет под учётной записью аккаунта, а не под учётной записью сотрудника. Сотрудник на экране подтверждения увидит просьбу обратиться к владельцу. Специалист поддержки, который работает в вашем кабинете, подключить приложение не может.
Что видно по каждому приложению
| Поле | Что показывает |
|---|---|
| Название и разработчик | Что это за приложение и кто его сделал |
| Подключено | Когда владелец дал согласие и, если известно, кто именно |
| Последнее обращение | Когда приложение последний раз пользовалось доступом, или «Ещё не пользовалось доступом» |
| Доступ | Что приложение может видеть или делать (см. ниже). Доступ, который меняет данные, выделен цветом |
| Политика конфиденциальности, Условия использования | Документы разработчика; открываются в новой вкладке |
У своих интеграций вместо разработчика и документов стоит отметка Своя интеграция, а вместо «Подключено» — когда и кем интеграция создана.
Какой доступ может получить приложение
Приложение получает только то, на что владелец согласился на экране подтверждения. Тот же список показан в поле Доступ:
| Доступ | Что открывает |
|---|---|
| Профиль бизнеса, точки, часы работы, налоги и типы оплат | Данные о бизнесе и торговых точках |
| Каталог: товары, модификаторы, меню, стоп-лист | Категории, товары, модификаторы, меню и стоп-лист |
| Все заказы: позиции, оплаты, статусы | Все заказы — позиции, скидки, налоги, оплаты и статусы. Данные гостей в заказах — только вместе с доступом к базе клиентов |
| Создание заказов и отмена своих заказов | Создавать заказы; отменять приложение может только заказы, которые создало само |
| Отметка оплаты своих заказов вне кассы | Отмечать оплаченными только заказы, которые создало само приложение |
| Отчёты о продажах | Итоги продаж по дням и позициям |
| База клиентов и персональные данные гостей | Клиенты и данные гостей: имя, телефон, адрес |
| Сотрудники и смены | Сотрудники и смены, без паролей |
| Работает без вашего участия | Приложение продолжает работать, пока вы не отзовёте доступ. Если приложение 90 дней не обновляет доступ, он истекает. Без этого пункта доступ действует около часа после согласия |
Как отозвать доступ
- Рядом с приложением нажмите Отозвать доступ.
- Подтвердите в окне.
Приложение сразу теряет доступ к данным вашего бизнеса и пропадает из списка. Чтобы снова им пользоваться, подключите его заново из самого приложения и ещё раз дайте согласие.
Отозвать доступ может только владелец аккаунта: сотрудники видят список без кнопки Отозвать доступ. Специалист поддержки, который работает в вашем кабинете, отозвать доступ тоже не может.
Своя интеграция
Если вы хотите сами подключить к данным бизнеса свой скрипт, таблицу или сервис, регистрироваться как разработчик не нужно — создайте свою интеграцию. Она работает через тот же API, что и подключённые приложения, но вместо экрана подтверждения вы сразу получаете ключ.
- Ключ даёт доступ только к данным этого аккаунта и только к тому, что вы отметили при создании.
- Срока действия у ключа нет: он работает, пока вы не удалите интеграцию.
- Ключ показывается один раз. Посмотреть его снова нельзя — если ключ потерян, удалите интеграцию и создайте новую.
- Можно создать до 20 интеграций.
Как создать
- Нажмите Создать интеграцию (кнопка есть только у владельца аккаунта).
- Введите название — например, «Отчёты в Google Таблицах».
- Отметьте, что интеграция сможет делать. По умолчанию отмечены профиль бизнеса, каталог и заказы — только чтение. Доступ, который меняет данные, подписан «меняет данные».
- Нажмите Создать.
- Скопируйте ключ и сохраните его в надёжном месте. В том же окне есть готовый пример запроса и ссылка на документацию API.
- Нажмите Готово, ключ сохранён. Интеграция появится в списке с отметкой Своя интеграция.
Ключ передаётся в заголовке запроса: Authorization: Bearer <ключ>. Подробнее — в статье «API для разработчиков».
Как удалить
- Рядом с интеграцией нажмите Удалить.
- Подтвердите в окне.
Ключ перестаёт работать сразу, восстановить его нельзя. Чтобы продолжить работу, создайте новую интеграцию и замените ключ везде, где он используется.
Создавать и удалять свои интеграции может только владелец аккаунта. Специалист поддержки, который работает в вашем кабинете, сделать это не может.
Для разработчиков
Внизу страницы — ссылки для разработчиков приложений: документация API, файл, с которого может начать AI-инструмент, и раздел Разработчикам, где разработчик сам регистрирует своё приложение и сразу получает ключи.
Советы
- Время от времени просматривайте список и отзывайте доступ у приложений, которыми больше не пользуетесь.
- Храните ключ своей интеграции как пароль: не пересылайте его в чатах и не публикуйте в открытом коде. Если ключ мог попасть к посторонним, удалите интеграцию и создайте новую.
- Отмечайте для своей интеграции только тот доступ, который ей действительно нужен.
- Перед тем как нажать Разрешить, проверьте на экране подтверждения, что приложению действительно нужен каждый запрошенный доступ, — особенно тот, что меняет данные или открывает персональные данные гостей.
FAQ
Q: Как подключить приложение к моему бизнесу?
A: Из самого приложения: оно откроет экран подтверждения, где владелец аккаунта входит в личный кабинет и соглашается на доступ, который просит приложение. После этого приложение появится в этом списке.
Q: На странице написано «Подключение приложений пока недоступно»
A: Подключение сторонних приложений ещё не включено на сервере вашего аккаунта. С вашей стороны ничего делать не нужно.
Q: Я случайно отозвал доступ приложения
A: Подключите приложение заново из самого приложения — вас ещё раз попросят дать согласие.
Q: Приложение пропало из списка, хотя я не отзывал доступ
A: Отключиться может и само приложение. Кроме того, сервер сам отзывает доступ, если замечает, что одним и тем же ключом доступа воспользовались повторно, — это признак утечки ключа. Чтобы продолжить работу, подключите приложение заново из самого приложения.
Q: Сотрудник не видит кнопку «Отозвать доступ»
A: Так и должно быть: отзывать доступ может только владелец аккаунта. Сотрудник видит список, но изменить его не может.
Q: Я закрыл окно и не сохранил ключ своей интеграции
A: Посмотреть ключ повторно нельзя — он хранится только у вас. Удалите интеграцию и создайте новую: вы получите новый ключ.
Q: Кнопки «Создать интеграцию» нет
A: Её видит только владелец аккаунта и только там, где подключение приложений уже включено. Если создано 20 интеграций, кнопка неактивна — удалите ненужную.
Q: Чем это отличается от AI-коннектора (MCP)?
A: Страница AI-коннектор (MCP) (если она есть в вашем кабинете) — это токены, которые вы сами создаёте для своего ИИ-ассистента. Подключённые приложения — сторонние сервисы, получившие доступ через экран подтверждения, и ваши собственные интеграции, работающие через Platform API. Это независимые механизмы: отзыв доступа на этой странице не затрагивает токены AI-коннектора, и наоборот.