Salebot.pro
Search…
Yclients
Интеграция с системой онлайн-записи и автоматизации сферы услуг
Интеграция с сервисом 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

Событие: Клиенту добавлена дата дня рождения

Условие: record 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
Last modified 23d ago