Интеграция Bnovo с CRM или сайтом
Интеграция Bnovo с CRM или сайтом связывает систему управления отелем с рабочим местом продаж и обслуживания гостя. У Bnovo есть две версии публичного API. Версия v1 «Старт» позволяет получать список бронирований за период и конкретную бронь. Версия v2 «Профессионал» поддерживает расширенное чтение гостей, номеров, доступности, цен, отчётов и платежей, обновление статуса и гостя, создание отдельных сущностей, а также вебхуки о создании, изменении и отмене бронирования и изменении цен.
Доступ выдаётся владельцу аккаунта в Bnovo Octopus, а запросы выполняются с bearer JWT, который действует одни сутки. Мы проверяем доступную версию, выбираем основной сценарий и составляем карту полей. Номер бронирования и внутренние идентификаторы Bnovo сохраняются в CRM, поэтому изменение обновляет связанную сделку, а повтор события сохраняет одну карточку.
Для сайта можно вывести выбранные данные о доступности, ценах или состоянии брони через методы, открытые конкретному аккаунту. Очередь учитывает лимиты API, при ответе 401 обновляет токен, при 429 выдерживает паузу, а журнал показывает время, метод, объект и итог. Менеджер видит гостя, даты, номер, сумму, платежи и актуальный статус в привычной системе.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- Новое бронирование появляется в Bnovo, а менеджер вручную переносит гостя, даты, номер и сумму в CRM.
- Изменение или отмена брони остаётся только в PMS, поэтому отдел продаж продолжает работу по устаревшей карточке.
- Сайт или внутренний кабинет должен показывать доступность, цену, оплату или статус бронирования из Bnovo.
- Руководитель собирает отчёт по броням и платежам выгрузками, а у записей отсутствует единый идентификатор между системами.
Что именно мы сделаем
Разбираем путь гостя от бронирования в Bnovo до сделки CRM, кабинета на сайте или внутреннего отчёта.
Проверяем версию API, тариф, ключ, доступные методы и данные контрольных бронирований в аккаунте клиента.
Сопоставляем гостей, бронирования, номера, даты, суммы, платежи, источники и рабочие статусы двух систем.
Настраиваем JWT-авторизацию, вебхуки или чтение по расписанию, очередь, повторы, журнал и защиту от дублей.
Проводим сценарии создания, изменения, отмены и ошибки, затем передаём карту полей и инструкцию поддержки.
Что входит в стоимость
69 900 ₽ за всю работу
Проверяем тариф и версию Bnovo API, выбираем один законченный сценарий для CRM, сайта или внутренней системы и настраиваем официальный обмен. Получаем JWT, сопоставляем бронирования, гостей, номера, цены, платежи и статусы, добавляем вебхуки или периодическое чтение, очередь, защиту от дублей, журнал и контрольные сценарии. Небольшие связанные уточнения карточек включаем в общий результат после согласования.
Что будет готово
Передадим вам
- Рабочая интеграция Bnovo с выбранной CRM, сайтом или внутренним интерфейсом компании.
- Карта бронирований, гостей, номеров, цен, платежей, статусов и идентификаторов между системами.
- Очередь и журнал обмена с методом, объектом, временем, попыткой и понятным результатом обработки.
- Протокол контрольных сценариев и инструкция по ключу, JWT, вебхукам, повторам и дальнейшей поддержке.
Перед сдачей проверим
- Контрольное бронирование появляется во второй системе с правильным гостем, датами, номером, суммой, статусом и ID Bnovo.
- Изменение и отмена обновляют связанную карточку, сохраняют историю и запускают выбранное действие менеджера.
- Истечение JWT, ответ 429 и временная ошибка проходят предусмотренный повтор, а журнал показывает ход и конечный результат.
- Повтор одного события сохраняет единственную запись, а выбранный экран сайта показывает актуальные данные без раскрытия API-ключа.
Как это выглядит на практике
Новая бронь Bnovo становится готовой сделкой менеджера
- 01
Гость оформляет бронирование в подключённом канале, а Bnovo сохраняет бронь, гостя, даты, номер, сумму и статус.
- 02
Интеграция получает вебхук либо очередную порцию данных и запрашивает актуальные детали официальным методом.
- 03
CRM находит запись по ID Bnovo, создаёт или обновляет контакт и сделку и назначает менеджера по правилам объекта.
- 04
Изменение дат обновляет ту же карточку, а журнал показывает исходное событие, время обработки и результат.
Что понадобится для работы
От вас
- Доступ владельца к Bnovo Octopus, API-ключ, ID аккаунта и подключённая версия API с нужными правами.
- Доступ к тестовой CRM, сайту или внутренней системе и описание используемых полей, статусов и ролей.
- Примеры новых, изменённых и отменённых бронирований, гостей, номеров, цен и платежей для проверки.
- Ответственный сотрудник, который подтвердит правила сделок, назначения менеджеров, оплат и обработки исключений.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 66 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Чем отличаются API v1 и API v2 Bnovo?
Версия v1 предоставляет чтение списка бронирований и отдельной брони. Версия v2 добавляет расширенные данные, обновления, создание отдельных сущностей и вебхуки. Доступ зависит от типа аккаунта и тарифа.
Где получить ключ для интеграции Bnovo?
Владелец аккаунта открывает Bnovo Octopus, переходит в раздел API-доступа, выбирает версию, заполняет анкету и генерирует ключ. Фактические права проверяем контрольными запросами.
Как интеграция обновляет токен доступа?
Сервер получает JWT через метод авторизации по ID аккаунта и API-ключу. Токен действует одни сутки; после окончания срока или ответа 401 очередь выполняет авторизацию и повторяет операцию.
Какие события можно получать через вебхуки Bnovo?
Официальное описание v2 предусматривает события создания, изменения и отмены бронирования, а также уведомления об изменении цен в тарифе. Используем только события, доступные подключённому аккаунту.
Можно передавать бронирования в CRM автоматически?
Да. Сохраняем ID Bnovo, сопоставляем гостя, даты, номер, сумму и статус и создаём либо обновляем связанную сделку. Правила назначения менеджера и задач согласуем до запуска.
Можно вывести данные Bnovo на собственном сайте?
Да, если требуемые данные доступны в версии API клиента. Сервер получает выбранные сведения о бронировании, доступности, цене или платеже и отдаёт сайту безопасное представление с контролем актуальности.
Как учитываются ограничения количества запросов?
Запросы проходят через очередь, которая считает темп, объединяет повторные операции и выдерживает паузу после ответа 429. Журнал сохраняет попытки и помогает найти систематическую причину задержки.
Как принимается готовая интеграция Bnovo?
Проверяем новую бронь, изменение, отмену, платёж, повтор события, обновление JWT и временную ошибку. Затем сверяем ключевые поля двух систем и передаём протокол и карту данных.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
Это уже включённый в цену запас времени на небольшие связанные уточнения заказчика, которые появляются после старта: например, добавить поле, изменить формат уведомления или учесть ещё одно условие обработки.
Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.
Связанные шаги
- 01Принимать прямые бронирования без агрегатора
Настроить прямые бронирования на собственном сайте
- 02Интеграция Bnovo с CRM или сайтом
Связать Bnovo с CRM, сайтом или внутренней системой
- 03Автоматизация туристического налога в PMS, 1С и модуле бронирования
Автоматизировать туристический налог в PMS и модуле бронирования