Что делать, если подключение к внешней системе не работает

Что делать, если подключение к внешней системе не работает

Зачем это нужно? Подключение к внешней системе позволяет передавать данные вашей гостиницы в сторонние сервисы: ресторан, CRM, чат-бот, партнёрскую программу и другие. Пока подключение активно — данные передаются автоматически.

Иногда подключение перестаёт работать: данные перестают поступать, сторонняя система не отвечает, или вы просто хотите убедиться что всё в порядке. Hotel OS2 умеет сам проверить состояние подключения и показать где именно возникла проблема.

---

Шаг 1. Откройте раздел «Подключения»

Перейдите в Настройки (боковое меню → раздел «Администрирование» → «Настройки»), затем откройте вкладку «Подключения».

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

---

Шаг 2. Откройте карточку подключения и найдите раздел «Состояние интеграции»

В карточке подключения пролистайте вниз — там появится раздел «Состояние интеграции». Рядом с заголовком находится кнопка «Проверить состояние».

Этот раздел показывает, когда в последний раз проводилась проверка и каков был её результат.

---

Шаг 3. Нажмите «Проверить состояние»

Нажмите кнопку «Проверить состояние» — система проверит несколько параметров по очереди и покажет результат. Каждый пункт помечается зелёной галочкой (всё хорошо) или красным значком (нужно исправить).

Если все пункты зелёные — подключение работает нормально. Если один или несколько красных — прочитайте подсказку под каждым: там написано что именно нужно исправить.

---

Что проверяет система

Проверка включает три пункта:

1. Подключение включено Доступ к подключению должен быть открыт. Если тумблер в карточке подключения выключен — данные не передаются. Переключите его в положение «Доступ открыт».

2. Права доступа настроены В подключении должно быть выбрано хотя бы одно право (например, «Чтение бронирований» или «Информация об объекте»). Если прав нет — внешняя система не сможет получить нужные данные. Откройте редактирование подключения и отметьте нужные права.

3. Webhook-адрес доступен (только если настроен webhook) Если подключение использует webhook-уведомления, система попытается отправить тестовый запрос по указанному адресу. Если адрес недоступен — проверьте, что сторонний сервис работает и адрес указан верно.

---

Подсказки

Подключение включено, права настроены — но данные всё равно не поступают? Попробуйте переключить доступ: выключите и снова включите тумблер в карточке подключения. Иногда это помогает восстановить передачу данных.

Webhook возвращает ошибку 5xx? Проблема на стороне сторонней системы. Обратитесь к разработчику или администратору сервиса, который получает данные.

Хочу создать новое подключение вместо сломанного? Нажмите «Создать подключение» — новый идентификатор и секретный ключ будут сгенерированы автоматически. Старое подключение можно удалить.

---

Частые вопросы

Как часто нужно проверять состояние подключения? Проверяйте при смене настроек, после обновления сторонней системы или если партнёр сообщил об остановке данных. В остальное время Hotel OS2 работает в штатном режиме без ручных проверок.

Можно ли, чтобы проверка показала ошибку, а данные при этом всё равно передавались? Да. Например, если webhook не настроен, но данные передаются через другой способ — это нормальная ситуация. Ориентируйтесь на реальные данные в сторонней системе.

Что значит «права доступа не настроены»? Это значит, что в подключении не выбрано ни одного раздела данных. Откройте редактирование подключения и поставьте галочку напротив нужных разделов (бронирования, гости, отзывы и т.д.).

Изменится ли что-то в сторонней системе, когда я нажимаю «Проверить состояние»? Нет. Проверка только читает настройки и при наличии webhook отправляет один тестовый запрос с пометкой «тест». Это не повлияет на рабочие данные.

Что делать, если ни один пункт не помог? Обратитесь в службу поддержки Hotel OS2 — специалисты помогут разобраться.