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