Exely PMS — Интеграция с Битрикс24

Объекты Exely

Подключение нескольких объектов Exely PMS к одному порталу Битрикс24. Каждый объект синхронизирует бронирования, тарифы и доступность в свою воронку CRM.

Объектов

—

Новые сегодня

по всем объектам

Номерной фонд

по всем объектам

Последняя синх.

—

авто каждые 5 мин

Подключённые объекты

Всего: 0

Объект	Номеров	Новых сегодня	Воронка CRM	Ключи	Синхронизация	Статус

Один портал поддерживает неограниченное число объектов Exely. Для сети отелей каждый объект пишет в собственную воронку CRM либо в общую с тегом источника заявки.

Функции CRM

Полный набор возможностей Exely API для работы с CRM Битрикс24. Каждую функцию можно включить отдельно и назначить уровень доступа.

Брони → Сделки

Новое бронирование создаёт сделку. Сумма, даты, тип номера, тариф и источник OTA переносятся в карточку.

Заказчик → Контакты

ФИО, телефон, e-mail, страна создают или обновляют контакт. Дедупликация по телефону и e-mail.

Оплаты → Сделки

Предоплата и оплата при заселении пишутся в стадии и поля суммы. Поддержка money-формата с валютой.

Изменения и отмены

Изменение дат, отмена или no-show двигают сделку по воронке. Отмена → стадия «Проиграно» с причиной.

Заезды → Дела

Предстоящие заезды создают дела в CRM или задачи ресепшену. Напоминание за N дней до прибытия.

Аналитика → BI

ADR, RevPAR, загрузка и источники броней выгружаются в BI Конструктор. Дашборды по объектам и периодам.

Переключатели функций

Уровни доступа модели iGrade AI Office

Green автоYellow 1 кликRed подтверждение

Создавать сделки из новых броней Green

Каждая бронь Exely → новая сделка в назначенной воронке

Создавать и обновлять контакты заказчиков Green

Дедупликация по телефону и e-mail

Двигать сделки по стадиям при изменении брони Yellow

Авто-переход стадий: оплата, заселение, выезд, отмена

Записывать оплаты в поля суммы Yellow

Предоплата и оплата при заселении в money-поля

Создавать задачи на заезд для ресепшена Yellow

Задача за N дней до прибытия гостя — в разработке, переключатель пока ни на что не влияет

Удалять сделки при отмене брони Red

Вместо перевода в «Проиграно» — полное удаление. Требует подтверждения

Обратная запись: Битрикс24 → Exely Red

Менеджер создаёт бронь из CRM, она уходит в Exely PMS — в разработке, переключатель пока ни на что не влияет

Маппинг полей

Сопоставление полей бронирования Exely с полями сделки и контакта Битрикс24. Пользовательские поля (UF) выделены синим.

Сделка

Контакт

Компания

Вкл	Поле Exely		Поле Битрикс24	Тип

Не забудьте нажать «Сохранить» вверху

ufCrmBookingNumber — ключ привязки (🔑): повторная синхронизация той же брони обновляет существующую сделку, а не создаёт дубль. Ключевые строки нельзя выключить или перенаправить. «— не переносить —» отключает поле.

События

События бронирования Exely, запускающие обновление в Битрикс24. Доставка через polling Black Hole — без открытых вебхуков в интернет.

Exely PMS

событие брони

Black Hole

polling / очередь

VibeCode API

/v1/deals · /v1/contacts

Битрикс24

CRM обновлён

Триггеры событий

Параметры доставки

Интервал polling

Частота опроса Exely на изменения броней (инкрементально)

Полное обновление

Перечитать все брони за 60 дней (сверка на пропуски)

Повтор при ошибке (retry)

Экспоненциальный бэкофф при 429 / 502

Лог доставки

Запись каждой синхронизации в журнал

Уведомлять об ошибках в чат

Сообщение в Битрикс24 при сбое доставки

Профили гостей

Локальный справочник гостей: собирается фоновым импортом (при первом запуске — до 2 лет, затем инкремент раз в сутки). UI читает из БД, не дёргает Exely на каждом клике.

ФИО	Гражданство	Пол	Дата рождения	Телефоны	E-mail	Броней	Exely ID	Bitrix ID	Статус
Загружаю справочник…

Справочник компаний

Компании-контрагенты всех подключённых объектов Exely. Дедуп по companyId, показан статус синка в Битрикс.

Название	Тип	ИНН / ПИНФЛ	Объект(ы)	Exely ID	Bitrix ID	Статус
Загружаю…

Доступ

Кто из сотрудников портала может пользоваться этим приложением. Пусто = доступ у всех пользователей портала.

Разрешено сотрудникам

Отмеченные ниже увидят приложение в меню Битрикс24 и смогут менять его настройки.

Если список пуст — доступ открыт всем пользователям портала.

Подключение

Приложение развёрнуто на Black Hole — невидимо из интернета, доступ только внутри Битрикс24 через прокси-туннель.

Black Hole сервер

Доменapp-exely-b24.vibecode.bitrix24.tech

Тарифbc-small

Рантаймnode20

Регионru-central1-b

Статусrunning · CONNECTED

Авто-сончерез 60 мин простоя

Доступ и ключ

accessPolicyPORTAL

Доступтолько пользователи портала

Из интернетазакрыт

Тип ключаvibe_app_••••

Скоупы

crmtaskimbizproc

vibe:infraактивен

API-ключи Exely хранятся зашифрованными на стороне Black Hole и не передаются в браузер. Встраивание в карточку сделки — через placement-обработчик с передачей токена в POST-body.

Виджет доступности

Проверка наличия свободных номеров по всем объектам на выбранные даты через Exely Search API. Ответ по каждому объекту: доступно / недоступно.

Дата и время заезда *

Дата и время выезда *

Ночей

Номеров

Выберите даты и количество номеров, затем нажмите «Проверить доступность».

Доступность на весь период считается по фонду Exely (Search API). Выберите заезд и число ночей — выезд подставится сам. Ранний заезд / поздний выезд считаются по времени из существующих броней PMS: «свободно N номеров» к указанному времени = всего номеров минус занятые в этот момент. Разверните список, чтобы увидеть, кто и во сколько выезжает/заезжает. Проверка по времени работает на уровне типа номера (конкретная комната присваивается при заселении).

Метрики отеля

Занятость, ADR, средний чек и топ каналов продаж. Считается напрямую из Exely PMS, обновляется по кнопке (кэш 5 мин).

Нажмите «Пересчитать» для загрузки метрик.

Сверка целостности

Сравнивает список броней в Exely со сделками в CRM. Показывает пропуски (нет в CRM) и лишние сделки (нет в Exely).

Выберите период и нажмите «Проверить».

Дедуп-помощник

Ищет контакты с одинаковыми ФИО без телефона и e-mail. При «слиянии» все сделки перевязываются на выбранный контакт, остальные удаляются.

Нажмите «Обновить», чтобы найти дубли.

Журнал интеграции

История синхронизации событий Exely с CRM Битрикс24.

Время	Объект	Событие	Действие в CRM	Статус