Yclients
Интеграция с системой онлайн-записи и автоматизации сферы услуг
Интеграция с сервисом yclients работает как в Whatsapp (работает сразу после установки адреса для вебхуков), так и в Telegram, Viber (понадобится дополнительная настройка, работают они с записями, сделанными через них).
Она позволяет настраивать реакцию на следующие события внутри сервиса Yclients:
- создание записи на прием;
- редактирование времени записи на прием;
- удаление записи на прием;
- клиент пришел на прием;
- клиент не пришел на прием;
- клиенту добавили дату дня рождения (дата переносится в бот для установки напоминания)
Также клиент может записаться на прием прямо из бота (на ту же услугу, что и в прошлый раз, или на новую услугу).
На что можно настроить бота:
- полная запись на прием (Ватсап, Вайбер, Телеграм и пр. мессенджеры) с выбором услуги, мастера, даты и времени;
- запись на ту же услугу и к тому же мастеру, что в прошлый раз на ближайший сеанс;
- отправить СМС с кодом для подтверждения номера телефона перед оформлением заказа;
- вывести полное описание выбранной клиентом услуги;
- получить список всех категорий и услуг;
- получить основные сведения о клиенте из базы yclients (если он уже зарегистрирован в системе, но впервые в боте)
После настройки бота установите адрес для отправки вебхуков в сервисе 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 группового события
Мы разработали готового бота, которого вы легко можете настроить под себя.
Last modified 7mo ago