🔧 Подключение ручки к сети и боту
1
Включение и подключение к WiFi ручки
Включите дверную ручку KeyURL. На ее дисплее появится QR-код с подписью "WiFi".
Действие: Отсканируйте этот QR-код в своем телефоне для подключения к точке доступа
ручки.
💡 Важно: Эта WiFi сеть будет использоваться в качестве Секретной сети
WiFi при отсутствии доступа в интернет или к домашнему WiFi.
2
Выбор локальной WiFi сети
После подключения к ручке вам будет предоставлен список доступных WiFi сетей.
Действие:
- Выберите вашу домашнюю (локальную) WiFi сеть из списка
- Введите пароль для подключения
- Подтвердите выбор
Ручка перезагрузится и попытается подключиться к интернету через выбранную сеть.
3
Подключение к боту Макс или Телеграм
При успешном подключении ручки к интернету на экране появится новый QR-код с подписью "scan
management".
Действие:
- Отсканируйте этот QR-код
- Выберите мессенджер: Макс или Телеграм
- Откроется интерфейс управления ручкой в выбранном боте
✅ Готово! Ручка успешно подключена и готова к управлению через мессенджер.
💡 Индикация состояния наружной ручки двери
На наружной ручке дверь расположена кнопка с индикатором (LED). Цвет и характер мигания указывают на
текущее состояние ручки:
Белый мигающий свет (примерно раз в 5 секунд)
✅ Нормальная работа. Ручка подключена и готова к использованию.
Зеленый постоянный свет
🔓 Дверь открыта. Ручка находится в режиме разблокировки.
Красный постоянный свет
⚠️ Отсутствует подключение к WiFi сети. Проверьте подключение
роутера.
Красный мигающий свет
⚠️ Отсутствует подключение к сети Интернет через выбранную
WiFi. Ручка не может достичь облачную платформу.
Синий постоянный свет
🔐 Активирована Секретная сеть WiFi. Ручка
работает в режиме без интернета. Автоматическая перезагрузка происходит каждые 10 минут.
Справка по цветам:
- Белый = нормально ✅
- Зеленый = открыто 🔓
- Красный = проблема с сетью ⚠️
- Синий = режим без интернета 🔐
🔑 Создание и управление ключами через бот
После подключения ручки к боту Макс или Телеграм вы получите доступ к полному управлению. Вот основные
функции:
📋 Основные функции управления
⚙️ Настройка ручки
Привяжите локацию, установите время работы, переверните изображение
🔓 Открыть дверь
Мгновенное открытие двери прямо из бота
🔑 Создать гостевой ключ
Установите даты и поделитесь с гостем
👥 Доверить управление
Дайте другому пользователю доступ к управлению
🔑 Создание гостевого ключа
- Откройте управление ручкой в боте
- Нажмите кнопку "Создать гостевой ключ"
- Выберите даты начала и окончания действия ключа
- Установите дополнительные параметры (время суток, количество использований и т.д.)
- Сгенерируется ссылка на ключ - поделитесь ей с гостем
📝 Важно: Гостю не нужно устанавливать никаких приложений. Он просто открывает
полученную ссылку в браузере или мессенджере, и может открыть дверь.
🔗 Передача ключа гостю
Ключ-ссылка может быть передана следующими способами:
- 📱 СМС или WhatsApp
- 💬 Макс или Телеграм
- ✉️ Электронная почта
- 📲 QR-код
- 🔗 Прямая ссылка
🚨 Работа при аварийных ситуациях
KeyURL разработана с учетом различных сбоев. Вот как ручка работает в экстремальных ситуациях:
1
Отсутствие мобильного интернета на телефоне гостя
Если гость находится без мобильного интернета, но в пределах домашной WiFi сети:
- 📱 Телефон подключается к домашной WiFi
- 🔗 Гостевой ключ-ссылка работает штатным образом
- 🔓 Гость может открыть дверь
2
Сбой питания / потеря связи с платформой
Если ручка потеряла связь с облачной платформой:
- 🔘 На ручке расположена кнопка ручного сброса
- 🔄 Нажмите на кнопку снаружи ручки
- ⚡ Ручка перезагрузится
- 🔗 После перезагрузки попытается переподключиться
3
Выход из строя домашного роутера / потеря интернета
Когда нет доступа к интернету, ручка активирует Секретную WiFi сеть:
- 📡 Ручка становится точкой доступа WiFi
- 🔵 LED-индикатор светится синим (см. индикацию)
- 📱 Гость подключается к этой Секретной сети
- 🔓 Открывает дверь через интерфейс локальной сети
- 🔄 Ручка автоматически перезагружается раз в 10 минут
SSID Секретной сети: передается при подключении ручки (шаг 1 инструкции
"Подключение ручки")
4
Полное отсутствие электропитания
Если ручка полностью обесточена:
- 🔑 Дверь остается заперта обычным замком
- 🗝️ Может быть открыта обычным физическим ключом
- ⚠️ Убедитесь, что у вас есть резервный ключ от замка
💡 Рекомендация: Ручка питается от USB, подключите ее к розетке с ИБП
(бесперебойным питанием) для защиты от сбоев.
✅ Вывод: KeyURL спроектирована так, чтобы вы никогда не были
заперты. Всегда есть способ открыть дверь в любой ситуации.
🔗 API интеграция для гостиничного ПО
KeyURL предоставляет API для интеграции с гостиничными системами управления и другим ПО. Автоматизируйте
создание гостевых ключей при заселении гостей.
📋 Получение API токена
- Откройте управление ручкой в боте (Макс или Телеграм)
- Перейдите в раздел "Настройки" → "API"
- Нажмите "Создать новый токен"
- Скопируйте полученный токен
- Сохраните в безопасном месте
🔐 Безопасность API
- Токены: Хранятся зашифрованными на серверах KeyURL
- HTTPS: Все запросы должны идти по защищенному протоколу
- Ротация: Рекомендуется менять токены каждые 90 дней
- Лимиты: Каждый токен имеет суточный лимит запросов
🚀 Пример использования
POST /api/v1/keys/create
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json
{
"guest_name": "Иван Петров",
"check_in": "2026-05-20",
"check_out": "2026-05-25",
"property_id": "apt-501",
"guest_email": "ivan@example.com"
}
Ответ:
{
"key_url": "https://key.url/k/abc123xyz",
"qr_code": "...",
"expires_at": "2026-05-25T11:00:00Z"
}
📞 Поддержка интеграции
- 📖 Полная документация API: docs.keyurl.com
- 💬 Поддержка: support@keyurl.com
- 🔧 Техническая консультация доступна
- 🧪 Sandbox-окружение для тестирования
💡 Преимущества API интеграции:
- ✅ Автоматическое создание ключей при заселении
- ✅ Отправка ключей в Email при регистрации
- ✅ Синхронизация с системой управления гостиницей
- ✅ Отчеты об использовании ключей
- ✅ Управление доступом через ваше ПО