Связать YCLIENTS с Битрикс24 можно тремя способами: поставить готовое приложение из Маркета, подключить сервис-посредник или написать обмен самостоятельно через REST API обеих систем. YCLIENTS остаётся журналом записи, а Битрикс24 ведёт продажи, возврат клиентов и претензии, поэтому главный вопрос формулируется так: какие данные должны ехать между системами и в каком направлении.
Ниже разобраны варианты по карточкам Маркета и документации YCLIENTS, шаги настройки, проверка результата и типичные ошибки.
Какие варианты связки существуют
Универсального решения на все салоны не существует.
Выбор зависит от того, сколько у салона филиалов, нужна ли запись клиента прямо из сделки и готов ли бизнес платить за сервис или содержать разработчика. Ниже четыре варианта, которые описаны в публичных источниках на 10 ноября 2026 года. Цены сторонних решений в таблице не указаны: их смотрят в карточках приложений и на сайтах сервисов.
| Вариант | Что обменивается по описанию | Что проверить до запуска |
|---|---|---|
| Приложение «Интеграция с YCLIENTS» (разработчик X3Group) | Контакты в обе стороны, включая скидку и баланс; сделка при новой записи или продаже абонемента; импорт услуг; запись клиента из сделки; статусы визитов | В карточке стоит метка «Доступно в подписке»; приложение запрашивает полный доступ к CRM, открытым линиям, бизнес-процессам и торговому каталогу |
| AVECME (разработчик Simple Digital) | Двусторонняя синхронизация контактов; сделка в воронке по типу клиента: новый, регулярный, потерянный; синхронизация статусов; виджет записи в сделке | Платный внешний сервис с отдельной регистрацией и 7 днями тестового периода; работает и с другими системами записи |
| Конструктор интеграций | Сценарии из триггеров и действий, которые вы собираете сами | Набор триггеров и действий у каждого конструктора свой, поэтому нужный сценарий проверяют на пробной версии |
| Своя интеграция по API | Любые поля и правила, которые вы опишете | Нужны разработчик, токены обеих систем, сервер для приёма запросов и поддержка после запуска |
Для салона с одним-двумя филиалами обычно хватает готового приложения. Свою интеграцию имеет смысл заказывать, когда нужны нестандартные правила: например, отдельная воронка для абонементов, передача рекламной метки из виджета записи или разные права для управляющих разных точек. Сервис-посредник занимает середину: настройка идёт в его интерфейсе без разработчика, но набор полей и сценариев задаёт сам сервис, и менять его под себя получится только в рамках тарифа, условия которого читают на сайте сервиса. Какой путь ни выберете, решение стоит принимать после ответа на три вопроса: кто в салоне работает в Битрикс24 каждый день, какие события отдел продаж реально обрабатывает и сколько данных готова вести команда в двух системах одновременно.
Что синхронизировать, а что оставить в YCLIENTS
Журнал записи, расписание мастеров, склад расходников и кассу визита сильнее держать в YCLIENTS. Битрикс24 нужен там, где начинаются продажи и работа с клиентской базой: напоминание о возврате, претензия, продажа абонемента, корпоративный заказ. Универсальная таблица соответствия выглядит так.
| Данные в YCLIENTS | Где живут в Битрикс24 | Комментарий |
|---|---|---|
| Клиент: имя, телефон, email, скидка, баланс | Контакт | Телефон приводят к одному формату до первого обмена, иначе появятся дубли |
| Запись | Сделка в отдельной воронке или задача | Ссылка на запись в журнале и дата визита лежат в полях карточки |
| Статус визита (0 ожидание, 1 пришёл, 2 подтвердил) | Стадия сделки через триггер или робот | Статус меняют в журнале, а CRM его только читает |
| Неявка | Задача «перезаписать» с причиной | Причину берут из короткого списка |
| Продажа абонемента | Сделка | Остаток визитов списывается в журнале |
| Услуги и цены | Каталог товаров | Импорт делают один раз, дальше обновляют по изменению |
| Расписание мастеров, склад | Остаются в YCLIENTS | В CRM их переносить нет причин |
Бонусы и баланс клиента сохраняют в одной системе. Приложение X3Group, по описанию, передаёт скидку и баланс в карточку контакта как данные, а начислять и списывать их продолжает журнал. Менеджеру по продажам эти цифры нужны для сегментов и звонков, а кассе визита нужна единая правда, поэтому правку баланса в карточке CRM лучше закрыть по правам или хотя бы запретить правилами работы.
Как установить приложение из Маркета
Порядок установки одинаков для большинства приложений и совпадает с инструкцией в карточке «Интеграция с YCLIENTS».
- В меню слева откройте «Приложения», затем «Битрикс24 Маркетплейс».
- В поиске введите название приложения и откройте его карточку.
- Нажмите «Установить», прочитайте документацию, примите соглашения и подтвердите установку.
- Дождитесь сообщения об установке: через несколько секунд приложение откроется само.
- Настройте обмен по инструкции в окне приложения.
Устанавливать приложение лучше администратору портала, потому что оно запрашивает права на CRM и другие разделы. Перед установкой подготовьте в Битрикс24 воронку для записей, стадии под статусы визита и поля сделки, в которые приложение положит дату, услугу и ссылку на запись. Когда воронки нет, сделки лягут в общий поток вместе с обычными продажами, и отдел продаж потеряет картину.
После установки приложение X3Group предлагает импортировать базу: контакты, товары и услуги. Первый запуск делают на тестовых данных или в тестовой воронке, а полный импорт включают после проверки.
Как устроен сервис AVECME
Схема подключения отличается: сначала приложение ставится в Битрикс24, затем регистрация идёт на сайте сервиса, потом в нём подключают доступы к Битрикс24 и к системе записи и настраивают нужную интеграцию по инструкции сервиса. При установке в справочнике товаров появляется раздел «Услуги».
Сделка создаётся в воронке, которая соответствует типу клиента: новый, регулярный или потерянный. Такое разделение удобно для сквозной аналитики, потому что для каждой группы можно строить свои стадии. В карточку сделки при привязке записи приходят услуги и стоимость, дата и время посещения, ссылка на запись в журнале, ФИО исполнителя, название и ID филиала.
Подтвердить или отменить запись можно из Битрикс24, а виджет записи позволяет выбрать филиал, услугу, специалиста и свободное время из карточки сделки. Все перечисленные поля можно использовать в роботах и правах доступа по филиалам.
Своя интеграция через API YCLIENTS и Битрикс24
Когда готовые приложения не покрывают задачу, обмен строят на API. У YCLIENTS адрес API https://api.yclients.ru, лимит составляет 200 запросов в минуту или 5 запросов в секунду на один IP-адрес, а ответы приходят в формате версии 2.0 при заголовке Accept: application/vnd.yclients.v2+json.
Авторизация и методы YCLIENTS
Каждый запрос подписывается ключом партнёра в заголовке Authorization: Bearer и ключом пользователя через слово User. Ключ партнёра выдаётся после регистрации в маркетплейсе интеграций YCLIENTS и копируется в разделе «Настройки аккаунта», а ключ пользователя возвращает метод auth.
Для обмена обычно хватает нескольких методов: список записей GET /api/v1/records/{company_id}, создание клиента POST /api/v1/clients/{company_id}, создание записи POST /api/v1/records/{company_id} и изменение записи PUT /api/v1/record/{company_id}/{record_id}. В списке записей есть фильтры по клиенту, сотруднику, датам сеанса и датам создания, а также параметры changed_after и changed_before для записей, созданных или изменённых с заданного момента. Статус посещения хранится в поле attendance: значение -1 означает, что клиент не пришёл, 0 ожидание, 1 клиент пришёл, 2 клиент подтвердил запись.
Вебхуки из YCLIENTS в публичной справке описаны только для жизненного цикла приложения: события uninstall при отключении и freeze при заморозке интеграции. Событий по созданию и изменению записей в разделе REST API нет, поэтому для обмена надёжнее опрашивать список записей по changed_after раз в несколько минут, а наличие вебхуков на записи уточнить у поддержки YCLIENTS перед проектированием.
Вебхуки и методы Битрикс24
В Битрикс24 входящий вебхук создают в разделе «Разработчикам» на вкладке «Готовые сценарии», пункт «Другое», затем «Входящий вебхук». Если пункта нет у сотрудника, право на создание открывает администратор в настройках безопасности в поле «Кому разрешить создавать входящие вебхуки». Секретный код в адресе даёт доступ к методам в рамках прав вебхука, поэтому его не публикуют в клиентском коде, а рабочие вызовы отправляют методом POST.
Контакт и сделку создаёт универсальный метод crm.item.add: для сделки передают entityTypeId равный 2, для контакта 3. Старый метод crm.contact.add в справке помечен как устаревший. Поля originatorId и originId предназначены для внешней системы и её идентификатора, поэтому в них удобно записывать ID записи или клиента из YCLIENTS и по ним находить карточку при повторном обмене.
Обратное направление, от Битрикс24 к вашему обработчику, закрывает исходящий вебхук: он отправляет POST-запрос при выбранном событии, а обработчик сверяет токен в поле auth[application_token] и обычно отдельно запрашивает полные данные объекта. Адрес обработчика должен быть публичным, без localhost и самоподписанного сертификата.
Проверка после подключения
Пробный прогон занимает меньше часа.
Проверку делают на 5 тестовых записях в течение одного рабочего утра, пока клиенты не заметили сбоев.
- Создайте в YCLIENTS клиента с телефоном в произвольном формате и убедитесь, что в Битрикс24 появился один контакт.
- Оформите запись и проверьте, что сделка легла в нужную воронку с датой, услугой и ссылкой на журнал.
- Отметьте в журнале статус «клиент пришёл», затем «не пришёл», и посмотрите, меняется ли стадия или создаётся задача.
- Продайте тестовый абонемент и проверьте, что сделка появилась один раз.
- Измените скидку клиента в журнале и убедитесь, что значение дошло до контакта.
- Сверьте число контактов в обеих системах после импорта базы.
Типичные ошибки
Таблица ниже помогает разобрать симптомы по причинам.
| Что видно | Вероятная причина | Что сделать |
|---|---|---|
| В CRM два контакта с одним телефоном | Разный формат номера в журнале и в карточке | Привести номера к единому формату и объединить дубли до включения обмена |
| Сделка появляется на каждый визит | Воронка записей не отделена от продаж | Вести записи в отдельной воронке и закрывать сделки автоматически после визита |
| Стадия сделки не меняется после визита | Не сопоставлены статусы или не настроены триггеры | Составить таблицу «статус журнала — стадия сделки» и проверить роботы |
| Баланс или бонусы расходятся | Значения правят в двух системах | Оставить источником YCLIENTS, в CRM только показывать |
| Выгрузка базы обрывается | Превышен лимит 200 запросов в минуту на IP | Разбить выгрузку на страницы и добавить паузы между запросами |
| Приложение получило больше прав, чем нужно | Права запрашиваются на весь набор разделов | Прочитать перечень прав в карточке до установки и назначить ответственного за приложение |
Вопросы и ответы про интеграцию YCLIENTS и Битрикс24
Есть ли готовое приложение для связки YCLIENTS и Битрикс24?
Да, в Маркете Битрикс24 есть «Интеграция с YCLIENTS» от разработчика X3Group и сервис AVECME от Simple Digital. Оба сделаны сторонними разработчиками, поэтому условия, поддержку и права доступа читают в карточке каждого приложения.
Можно ли записать клиента в YCLIENTS прямо из сделки Битрикс24?
По описаниям в Маркете можно: приложение X3Group записывает клиента из сделки, а виджет AVECME предлагает выбрать филиал, услугу, специалиста и свободное время. Возможность стоит проверить на тестовой записи до запуска.
Нужно ли платить за интеграцию?
У приложения X3Group в карточке указано «Доступно в подписке», AVECME назван платным сервисом с 7 днями тестового периода. Размер оплаты назначают разработчики, поэтому актуальные условия смотрят на их страницах. Своя интеграция по API требует работы разработчика и поддержки.
Приходят ли в Битрикс24 события о неявке клиента?
Оба приложения, по описанию, передают статусы визитов или синхронизируют статусы записи и сделки. В API YCLIENTS неявка хранится в поле attendance со значением -1, и при своей интеграции это значение читают при опросе списка записей.
Где вести бонусы и баланс клиента?
В YCLIENTS, где проходит касса визита. В Битрикс24 скидка и баланс нужны для сегментов и звонков менеджеров, и вторую валюту в CRM заводить не нужно.
С чего начать и сколько это стоит
Начать можно с одного филиала и одной воронки.
Самый короткий путь: выбрать вариант из таблицы в начале статьи, подготовить воронку записей в Битрикс24 и прогнать 5 тестовых записей по списку проверки. Когда обмен ведёт себя предсказуемо, подключают остальные филиалы и импортируют базу.
Если вместе со связкой нужно настроить воронки, поля, роботы и права доступа, начните с пакета «Старт» за 49 000 ₽. Состав работ и условия описаны на странице стоимости внедрения Битрикс24, а выбор между приложением, сервисом и своей интеграцией мы разбираем на консультации в разделе услуг.
Об авторе: Иван Остривной, NAVIPOINT, партнёр Битрикс24. Как выстроить воронки и отдел продаж вокруг такой связки, описано в статье про отдел продаж в Битрикс24, а общий принцип совместной работы CRM и отраслевой кассы разобран на примере связки iiko и Битрикс24.
Хотите внедрить Битрикс24 в вашей компании?
Напишите нам в мессенджер — ответим быстро и бесплатно проконсультируем
