Инструкция по интеграции Битрикс24 с Restoplace
Restoplace передаёт бронирования в Битрикс24 и обновляет связанные записи при изменениях брони. В настройках вы выбираете, что создавать в Битрикс24: сделку или лид. Изменения полей и этапов в Битрикс24 не переносятся обратно в Restoplace.
Настройка действует для выбранного адреса заведения. Если адресов несколько, настройте интеграцию отдельно для каждого.
Как настроить интеграцию в Битрикс24
В Битрикс24 откройте «Разработчикам» → «Готовые сценарии» → «Другое» → «Входящий вебхук».
Если создание вебхука недоступно, проверьте права пользователя и условия подписки в справке Битрикс24.
В настройках входящего вебхука:
- В поле «Настройка прав» добавьте «CRM (crm)» и «Пользователи (user)».
- Скопируйте полную ссылку из поля «Вебхук для вызова REST API». Она понадобится в Restoplace.
- Нажмите «Сохранить».
Подключение интеграции в Restoplace
- В настройках адреса раскройте «Интеграции» и выберите «Битрикс24».
- В поле «Вебхук Rest api» вставьте полную ссылку, скопированную из Битрикс24.
- Включите «Отправлять заявки в Битрикс24» и нажмите «Сохранить».
На иллюстрациях ниже показан пример заполнения. Выберите свои поля, сотрудников и стадии.
После сохранения нажмите «Обновить статус». Статус «Активно» означает, что подключение установлено. Эта же кнопка загружает актуальный список полей из Битрикс24 — нажимайте её после создания или изменения полей в CRM.
Настройка передачи данных
1️⃣ Выберите, какие заявки передавать
В настройках интеграции выберите режим по тому, какие обращения вы хотите видеть в CRM. У варианта с исключением есть пояснение про столы iiko — прочитайте его перед выбором:
| Что нужно вашей команде | Какой режим выбрать |
|---|---|
| Видеть все заявки, включая столы, открытые в iiko без предварительной брони | Все заявки |
| Видеть брони гостей и сотрудников, но не создавать записи для столов, открытых в iiko без брони | Кроме столов, открытых в iiko без предварительной брони |
| Обрабатывать только онлайн-заявки | Только онлайн-заявки |
Если брони создаёт хостес и они нужны в CRM, не выбирайте «Только онлайн-заявки»: брони сотрудников в этом режиме не передаются.
Режим влияет и на проверку подключения: для онлайн-заявок тестовую бронь нужно создать через виджет.
2️⃣ Выберите сделку или лид, ответственного и стадии
Выберите тот тип записи, с которым работает ваша команда:
- Сделка — если бронирование должно сразу попадать в рабочую воронку сделок. Выберите нужную воронку.
- Лид — если ваша команда сначала обрабатывает обращения в лидах. Используйте этот вариант, когда процесс с лидами уже настроен в вашей CRM.
Назначьте ответственного сотрудника. Затем напротив каждого используемого статуса брони выберите подходящую стадию сделки или лида.
У сделок и лидов разные поля и стадии. Сначала выберите тип записи и только потом создавайте поля. Если переключили тип после настройки, проверьте все соответствия заново.
Если соответствие для статуса не задано, переход на этап CRM при этом статусе не выполняется. Для передачи заявок из листа ожидания также сопоставьте его статус.
Статусы бронирования и статус оплаты депозита настраиваются отдельно: поле оплаты само по себе не переключает этап сделки или лида.
3️⃣ Создайте и сопоставьте поля
Сопоставить поля — значит указать, куда в CRM записывать каждое значение из Restoplace. Например: «Количество гостей» → ваше поле «Гостей».
Необязательно заполнять все настройки. Для первой проверки начните с номера брони, количества гостей, начала и окончания бронирования. Затем добавьте нужные команде сведения об оплате, сотрудниках и кассовой системе.
- Создайте дополнительные поля у сделки или лида в Битрикс24 — именно у того типа, который выбрали на предыдущем шаге.
- Вернитесь в настройки интеграции Restoplace и нажмите «Обновить статус». При успешной проверке подключения обновится список доступных полей.
- Напротив нужных данных Restoplace выберите созданные поля CRM. Для разных значений используйте разные поля.
- Сохраните настройки.
После создания нового поля или изменения его типа снова нажмите «Обновить статус».
Какой тип поля выбрать
В таблице указаны рекомендуемые типы и другие варианты, которые можно использовать.
| Данные Restoplace | Рекомендуемый тип в Битрикс24 | Другие доступные варианты |
|---|---|---|
| Количество гостей | Целое число | Число, строка |
| Номер брони | Целое число | Число, строка |
| ID (уникальный) | Целое число или строка | Число |
| Сумма заказа из iiko | Число | Строка |
| Сумма заказа из R-Keeper | Число | Строка |
| Статус оплаты депозита | Строка | — |
| GUID банкета iiko | Строка | — |
| Начало и окончание брони, время действий | Дата и время | Дата |
Для бронирования выбирайте «Дата и время». Тип «Дата» подходит только тогда, когда часы и минуты не нужны.
Если количество гостей и суммы уже связаны со строковыми полями, обязательной перенастройки нет: такие связки продолжают работать. Для расчётов и отчётов удобнее числовые поля.
Для суммы заказа выбирайте «Число», чтобы сохранить дробную часть. Проверьте точность отображения этого поля в Битрикс24. Отдельное преобразование чисел не требуется. Тип «Деньги» для сопоставления сумм заказов не предлагается.
4️⃣ Настройте депозит и суммы заказов
Куда записывать депозит
В Битрикс24 депозит передаётся во встроенное поле суммы сделки или лида. Отдельное поле для него выбирать не нужно.
Передаётся только целая часть депозита: 3 000,50 → 3 000. Это отличается от суммы заказа из кассовой системы, которую можно хранить с дробной частью в отдельном числовом поле.
Как видеть, оплачен ли депозит
Создайте у сделки или лида поле типа «Строка» и сопоставьте его с «Статус оплаты депозита» в Restoplace. Список вариантов или переключатель «Да/Нет» создавать не нужно: Restoplace передаёт готовый текст, например «Оплачен».
Какие значения приходят в статусе оплаты
| Значение | Что означает |
|---|---|
| Без депозита | Депозит не задан или равен нулю; возвратов нет |
| Не оплачен | Депозит предусмотрен, но оплата ещё не отмечена; отмена или ошибка оплаты не зафиксированы |
| Оплачен | Депозит отмечен оплаченным в Restoplace, в том числе вручную |
| Частично возвращён | Зарегистрирован возврат части депозита |
| Возвращён | Зарегистрирован возврат всей суммы депозита |
| Оплата отменена | Зафиксирована отмена оплаты |
| Ошибка оплаты | Зафиксирована ошибка оплаты |
Для правил автоматизации используйте точные значения из таблицы, включая «ё». Они передаются на русском языке независимо от способа оплаты. Если зарегистрирован возврат, передаётся статус возврата.
Отмена брони сама по себе не означает возврат денег: депозит может оставаться оплаченным. «Оплата отменена» относится к оплате, а не к бронированию. Статус оплаты сам по себе не меняет стадию сделки или лида: переходы настраиваются через статусы брони.
Сумма заказа из кассовой системы
Депозит — предоплата по брони. Сумма заказа из iiko или R-Keeper — общая сумма заказа из кассовой системы. Например, депозит может быть 3 000, а весь заказ — 12 500,50. Это разные сведения, поэтому используйте отдельные поля.
Сумма заказа передаётся после получения данных от кассовой системы и только если она больше нуля. Пустое поле не означает бесплатный или неоплаченный заказ: данные могли ещё не поступить.
Если ранее переданная сумма заказа стала нулевой, ноль не отправляется. Поэтому прежнее значение в CRM может сохраниться.
5️⃣ Настройте сведения о сотрудниках и отмене
Эти данные передаются вместе со временем соответствующего действия. Сопоставьте поля парами:
| Что хотите видеть в CRM | Какие поля сопоставить в Restoplace |
|---|---|
| Кто открыл бронь | «Кто открыл» + «Время открытия» |
| Кто закрыл бронь | «Кто закрыл» + «Время закрытия» |
| Кто отменил бронь | «Кто отменил» + «Время отмены» |
| Почему отменили бронь | «Причина отмены» + «Время отмены» |
Если выбрать только автора или причину отмены, без соответствующего времени, эти данные не придут. После настройки выполните нужное действие на тестовой брони и проверьте результат. Пока действие не произошло, поля могут оставаться пустыми.
Для открытия, закрытия и отмены передаются значения вроде «Хостес: Анна» или «Автоматически». Действие интеграции может быть подписано её названием, например «Хостес: iiko». В поле «Кто создал» передаётся имя с префиксом «Хостес:» либо сообщение о создании брони гостем через виджет.
В «Причину отмены» приходит выбранная причина. Если сотрудник выбрал другую причину и написал пояснение, передаётся его текст.
6️⃣ При необходимости добавьте идентификаторы iiko
| Поле | Для чего нужно |
|---|---|
| Номер брони | Найти бронь по номеру Restoplace, который может назвать гость |
| ID (уникальный) | Сопоставить данные по уникальному идентификатору брони в Restoplace |
| GUID банкета iiko | Сопоставить запись CRM с бронью или банкетом в iiko |
GUID — отдельный идентификатор iiko. Он не совпадает с номером брони Restoplace, её уникальным ID или номером кассового заказа. Если вы не используете его для сверки с iiko, это сопоставление можно пропустить.
Сопоставьте «GUID банкета iiko» с полем типа «Строка». В настройках Restoplace этот выбор находится рядом с суммой заказа из iiko. Несмотря на название, оно также передаёт GUID обычной брони, если iiko его вернула.
GUID может появиться позже записи в CRM: сначала Restoplace должен получить его от iiko. После получения GUID добавится в связанную сделку или лид. Для столов, открытых непосредственно в iiko без предварительной брони, GUID не передаётся.
Проверка настройки
При создании сделки или лида передаются данные, доступные на этот момент. Остальные значения обновляются при соответствующих изменениях брони, оплаты или данных iiko.
Новые сопоставления не заполняют историю автоматически. Проверяйте их на новой тестовой брони. Повторное сохранение настроек или изменение постороннего поля старой брони не гарантирует заполнения пропусков. Если нужна передача данных за прошлый период, обсудите её с поддержкой Restoplace.
- Сохраните настройки и убедитесь, что подключение активно.
- Создайте тестовую бронь, которая подходит под режим отправки. Для онлайн-заявок используйте виджет.
- Найдите её в Битрикс24. Проверьте тип записи и, для сделки, воронку, ответственного, номер брони, количество гостей, дату и время.
- Измените статус тестовой брони в Restoplace и убедитесь, что в CRM изменился соответствующий этап.
- Если используете депозит, проверьте сумму и статус оплаты. Сумму заказа из кассовой системы проверяйте отдельно от депозита, после получения данных.
- Если настроены авторы действий или причина отмены, выполните эти действия на тестовой брони и проверьте заполнение вместе со временем.
- Если настроен GUID iiko, проверьте его после получения данных от iiko. Для стола без предварительной брони этот тест не подходит.
Если данные не появились
| Что произошло | Что проверить |
|---|---|
| Поля CRM нет в списке Restoplace | Создано ли поле у выбранного типа записи — сделки или лида, подходит ли его тип. Затем нажмите «Обновить статус» |
| Бронь не появилась в CRM | Активно ли подключение, сохранены ли настройки нужного адреса, соответствует ли новая бронь режиму отправки |
| Этап CRM не изменился | Есть ли соответствие для этого статуса брони. Изменение статуса оплаты не переключает этап само по себе |
| Нет автора действия или причины отмены | Выбрано ли соответствующее поле времени; произошло ли действие после настройки |
| Нет GUID или суммы заказа | Получил ли Restoplace данные от кассовой системы. GUID не передаётся для столов, открытых в iiko без предварительной брони |
| Сумма без копеек | Для встроенной суммы сделки или лида из депозита это ожидаемо. Для суммы заказа проверьте тип поля и точность отображения |
| Пусты поля у старых сделок или лидов | Новое сопоставление не запускает заполнение истории. Проверьте новую бронь |
| В CRM осталась сумма заказа после обнуления в кассе | Нулевая сумма заказа не отправляется, поэтому прежнее значение может остаться |
Если самостоятельно решить вопрос не удалось, напишите в поддержку Restoplace. Укажите адрес заведения, номер или ID брони, тип записи — сделка или лид, название поля, ожидаемое и фактическое значение. Приложите скриншот сопоставления полей.