Yclients

Search…
Yclients
Интеграция с системой онлайн-записи и автоматизации сферы услуг
​Как установить webhook​
​Как настроить визит​
​Как установить дополнительные поля​
​Как настроить реакции на события​
​Как пользоваться переменными из вебхуков​
​Разбор готового бота​
Интеграция с сервисом yclients работает как в Whatsapp (работает сразу после установки адреса для вебхуков), так и в Telegram, Viber (понадобится дополнительная настройка, работают они с записями, сделанными через них).
Она позволяет настраивать реакцию на следующие события внутри сервиса Yclients:
создание записи на прием;
редактирование времени записи на прием;
удаление записи на прием;
клиент пришел на прием;
клиент не пришел на прием;
клиенту добавили дату дня рождения (дата переносится в бот для установки напоминания)
Также клиент может записаться на прием прямо из бота (на ту же услугу, что и в прошлый раз, или на новую услугу).
На что можно настроить бота:
полная запись на прием (Ватсап, Вайбер, Телеграм и пр. мессенджеры) с выбором услуги, мастера, даты и времени;
запись на ту же услугу и к тому же мастеру, что в прошлый раз на ближайший сеанс;
отправить СМС с кодом для подтверждения номера телефона перед оформлением заказа;
вывести полное описание выбранной клиентом услуги;
получить список всех категорий и услуг;
получить основные сведения о клиенте из базы yclients (если он уже зарегистрирован в системе, но впервые в боте)
Как установить webhook
После настройки бота установите адрес для отправки вебхуков в сервисе yclients. Пройдите в Настройки – WebHook. Выставьте «Отправлять» и адрес для уведомлений: 
https://chatter.salebot.pro/yclients_webhook/<api-ключ>
api-ключ необходимо взять из настроек проекта.
Поставьте галочку в поле «Событие по записям». Если хотите, чтобы бот получал даты дней рождения, то выставьте галочку и для поля «Событие по клиентам».
Подключайте вебхуки только после настройки бота!
Как настроить визит
В Yclients есть Визиты и есть записи. Несколько записей могут объединяться в визиты. Интервал этого объединения задается в настройках. 
Для работы чат-бота необходимо, чтобы записи в визиты не объединялись. Иначе будет приходить несколько вебхуков за раз и бот будет работать некорректно. 
Настройки производятся в Yclients Настройки - Журнал записи. Здесь в поле Интервал между уникальными визитами выставьте Каждая запись - Отдельный визит.
Рисунок 1
Как установить дополнительные поля
Для начала создадим дополнительные поля в Yclients. Это нужно для определения колбеков, если мессенджер не Whatsapp. Нужно добавить два поля — одно клиенту, второе - записи.
Как сделать дополнительный параметр клиенту
Перейдите в сеть (нажмите на название филиала, слева над календарем), в разделе Настройки - Дополнительные поля – Доп. Данные клиента. Созданные дополнительные поля можно настроить в филиалах, отражаются они в карточке визита, во вкладке Детали записи - Все параметры.  Настройки указаны на рисунках ниже:
Рисунок 2
​
Рисунок 3
Рисунок 4
Рисунок 5
Ключ-значение для API должен называться именно client_id!
Как сделать дополнительный параметр записи
Так как номер телефона всегда указан только в whatsapp, то для остальных мессенджеров, нужно отмечать каждый заказ специальной переменной, чтобы получать колбэки о том, что клиент посетил / не посетил услугу. Для этого сначала надо создать дополнительное поле в карточке заказа Yclients.
Рисунок 6
Ключ-значение для API должно называться именно order_id_field !
​
Рисунок 7
Схема описана в разделе «Получаем дату дня рождения из Yclients» и на рисунках 2, 6, 7
Сам запрос мы с вами уже рассматривали в разделе «Запись на прием» и на Рисунке 11.
Как настроить реакции на события
Обратите внимание, что необходимо заполнять не только поле Условие, но и поле Строки, на которые не надо отвечать. Если это поле не заполнено, то клиенту будут приходить по нескольку сообщений.
Все блоки должны быть типа Первостепенная проверка условий.
Событие: Создана новая запись
На рисунке 8 представлены настройки для ветки с ответом на создание записи клиентом.
Условие: record create
Рисунок 8
В нашем примере клиенту отправляются разные сообщения в зависимости от того записался клиент через сайт или через бота, поэтому была сделана такая «вилка» (рисунок 9-10). Больше про заполнение блоков в вилке на рис. 29-30:

Рисунок 9
​
Рисунок 10
Событие: клиент пришел на прием
Условие: record update attendance_success_visit
​
Рисунок 11
В нашем случае это сообщение должно прийти через полчаса после визита, поэтому сначала идет пустое сообщение, а через 30 мин - сообщение с соответствующим текстом.
​
Рисунок 12
Событие: Клиент не пришел на прием
Условие: record update attendance_fail_visit
Рисунок 13
Событие: Клиент изменил время записи на прием
Условие: record update date
​
Рисунок 14
Событие: Клиент удалил запись на прием
Условие: record delete
Рисунок 15
Событие: Клиенту добавлена дата дня рождения
Условие: client update
Строки, на которые не надо отвечать: record update attendance_fail_visit;record update attendance_success_visit;record update date;record delete

Рисунок 16
Как пользоваться переменными из вебхуков
Из вебхуков бот получает следующие переменные (их все можно увидеть в разделе Клиенты при нажатии Подробно возле ссылки на клиента Рисунок 17):
Рисунок 17
name - в Ватсапе заполняется Именем из Yclients
yclients_birth_day - и yclients_birth_month день и месяц даты рождения. Нужна для спецпредложений ко Дню рождения
yclients_client_id - id клиента в Yclients
yclients_email – email клиента в Yclients
yclients_date – дата записи на прием
yclients_time – время записи на прием
yclients_service_name – название услуги, на которую записан (для показа клиенту)
yclients_service_id – id услуги, на которую записан (для апи вызовов)
yclients_staff_name – имя сотрудника, к которому записан (для показа клиенту)
yclients_staff_id - id сотрудника, к которому записан (для апи вызовов)
yclients_record_id – id записи в Yclients (нужна для формирования ссылки на редактирование)
yclients_attendance – пришел ли клиент на прием
yclients_sms_before – за сколько часов до приема клиент попросил ему напомнить
yclients_raw - массив актуальных записей клиента. Он обновляется с каждым вебхуком.
yclients_activity_id - id группового события
Разбор готового бота
Мы разработали готового бота, которого вы легко можете настроить под себя.
Шаблон Yclients
Salebot.pro
Битрикс24
RetailCRM
Last modified 3mo ago
Copy link
On this page
Как установить webhook
Как настроить визит
Как установить дополнительные поля
Как сделать дополнительный параметр клиенту
Как сделать дополнительный параметр записи
Как настроить реакции на события
Событие: Создана новая запись
Событие: клиент пришел на прием
Событие: Клиент не пришел на прием
Событие: Клиент изменил время записи на прием
Событие: Клиент удалил запись на прием
Событие: Клиенту добавлена дата дня рождения
Как пользоваться переменными из вебхуков
Разбор готового бота