Бот для записи клиентов: у меня записывала форма, а не бот
Короткий ответ: бот для записи клиентов не нужен для самой записи. Разберём мою: записывала форма из четырёх экранов, которая сама подбирала ребёнку подходящее время, а я её собрал за два дня. Но бот там был, и ниже объясню зачем.
Система стояла у детской онлайн-школы программирования и долго работала на живом трафике. Родитель приходил по ссылке из CRM, за минуту проходил квиз, выбирал одно из свободных мест и видел подтверждение. CRM при этом узнавала о нём пять раз: после каждого экрана отдельным событием, а не одним фактом в самом конце.
Сейчас квиз выключен, и не потому, что сломался: записывать стало не на что. Сколько он успел записать сам и почему его выключили, ниже отдельным разделом.
Дальше разбор того, как это устроено: код запроса, которым подбираются слоты, дословные тексты ошибок и четыре места, где всё это ломается. Проект заказной, поэтому адреса функций, ключи, имя бота и название школы из текста убраны, а механика показана целиком.
Бот для записи клиентов: что он правда должен делать
Запись на услугу распадается на три работы, и бот хорошо умеет только одну.
Подобрать то, что человеку подходит. В детской школе это возраст и направление: семилетнего не записать на Python, а одиннадцатилетнему нечего делать в «Информатике Junior». То есть сначала спрашиваем возраст, и только потом показываем свободное время.
Занять место. Мест конечное число, и двое не могут сесть на одно.
Довести до занятия. Самая дорогая часть и самая недооценённая. Записаться легко, прийти сложно.
Теперь честно про переписку в боте. Диалог в стиле «напишите имя ребёнка, теперь возраст, теперь выберите направление» выглядит современно, но у него нет ни полоски прогресса, ни кнопки «Назад», ни нормальной проверки ответов. Человек пишет «восемь с половиной», и вы разбираете это регулярками, а потом ещё объясняете ему, что надо было числом.
В форме этой проблемы нет вообще. На каждом экране написано «Шаг 2 из 4» и висит полоска на 50%, назад возвращает кнопка, а возраст выбирается из списка от 7 до 18, где неправильного значения физически нет.
Бот хорош там, где надо написать человеку первым. Всё остальное форма делает лучше, и дешевле.
Поэтому бот в этой системе стоял не в начале, а в конце. На экране успеха, если родитель пришёл из CRM с опознанным контактом, появляется синий блок, и текст в нём такой: пожалуйста, перейдите в наш Telegram-бот и нажмите кнопку «Старт». Это позволит нам отправлять вам напоминания об уроке и не беспокоить звонками. Ссылка ведёт в бота с идентификатором контакта внутри, и школа после этого могла писать родителю в чат, а не названивать.
Квиз из четырёх экранов: что спрашивается и зачем
Экранов ровно четыре, и каждый отвечает за свой кусок работы.
Экран 1 - кто вы. Имя родителя, имя ребёнка, возраст. Возраст выбирается списком, и школьные границы зашиты прямо тут: на попытку выйти за них человек получает «Извините, мы школа для детей до 18 лет» или «Минимальный возраст для обучения - 7 лет».
Экран 2 - техника. Шесть галочек, из них две обязательные: компьютер и интернет. Без них дальше не пускает, и текст отказа прямой: «Для занятий необходимы компьютер и интернет». Остальные четыре - камера, микрофон, Zoom и «ребёнок уже пробовал программировать» - собираются для педагога и ни на что не влияют.
Экран 3 - направление. Список собирается из возраста, который человек назвал на первом экране. Семь-восемь лет видят «Информатику Junior», восемь-одиннадцать получают «Дизайн» и Scratch, с одиннадцати открываются Python и веб. Причём границы диапазонов перекрываются: ровно в восемь и ровно в одиннадцать показываются оба набора сразу, и выбор на этих двух годах остаётся за родителем. Если подходящее направление одно, оно выбирается само.
Экран 4 - время. Здесь уже никакого календаря, только список реально свободных мест, и о том, как он собирается, ниже отдельный раздел.
Ответы лежат в sessionStorage, поэтому перезагрузка страницы не стирает
квиз: человек возвращается туда же, где был. А идентификаторы лида и контакта
берутся из адреса страницы один раз, при первом открытии, и живут с человеком
до самого конца.
Подбор слота: шесть условий вместо календаря
Вот запрос, который собирает список времени на четвёртом экране. Это вся механика подбора целиком, здесь нечего прятать:
const { data } = await supabase
.from('slots')
.select('*')
.eq('status', 'available')
.eq('discipline', quizData.selectedDiscipline)
.lte('min_age', childAge)
.gte('max_age', childAge)
.gt('timestamp', now)
.gt('vacant', 0)
.order('timestamp', { ascending: true })
.limit(10);
Шесть условий: место открыто, направление совпало, возраст ребёнка попал в вилку слота с двух сторон, время ещё не прошло и места не кончились. Сверху сортировка по времени и ограничение в десять строк.
Десять - не от лени. Человек на четвёртом экране уже устал, и тридцать вариантов он не выберет, а закроет вкладку. Ближайшие десять по времени - это примерно неделя расписания, и этого хватает.
Возраст тут числами, и это переделка. В первой версии у слота лежала строка
age_range со значениями вида 7-8, 11+ или просто 7. Выглядело удобно
ровно до момента, когда понадобилось спросить базу «что подходит ребёнку девяти
лет»: строку для этого надо сначала разобрать, и разбирать её приходится в коде,
на каждый запрос.
Миграция превратила строку в два числа и запретила базе принимать чушь:
ALTER TABLE slots
ADD CONSTRAINT slots_min_age_range CHECK (min_age >= 0 AND min_age <= 18),
ADD CONSTRAINT slots_max_age_range CHECK (max_age >= 0 AND max_age <= 18),
ADD CONSTRAINT slots_age_order CHECK (min_age <= max_age);
Старые значения она перевела сама: 7-8 стало парой 7 и 8, 11+ превратилось в
11 и 18, одиночное 7 в 7 и 7. Плюс три индекса на новые колонки, после чего
фильтр по возрасту стал делом базы, а не JavaScript.
Любое поле, по которому вы будете искать, должно лежать в базе числом, а не строкой, которую надо разбирать.
Откуда берутся слоты: расписание приезжает одним запросом
Школа вела расписание у себя, и дублировать его руками никто бы не стал. Поэтому у системы есть отдельный вход: функция импорта принимает массив слотов и раскладывает их по базе.
Каждый слот - это направление, вилка возраста, время в миллисекундах, число
свободных мест и external_id из системы школы. Последнее поле важнее, чем
кажется: запись идёт апсертом по нему, поэтому расписание можно присылать
хоть каждый час, и дубликатов не появится, а изменившееся число мест просто
перезапишется.
Отдельно стоит ответ на частичную ошибку. Если из сорока слотов не прошли два,
функция не роняет весь запрос, а возвращает 207 Multi-Status: сколько
импортировано, сколько не прошло и что именно не так с каждым, с номером строки
в присланном массиве. Тексты ошибок дословно такие:
Missing required fields: discipline, timestamp
Invalid timestamp: must be a number (Unix timestamp in milliseconds)
Age must be between 0 and 18 (children school)
min_age must be less than or equal to max_age
Invalid request: 'slots' array is required
Это не педантизм. Расписание на неделю не должно отваливаться целиком из-за одной кривой строки, а человек на той стороне должен увидеть, какая именно строка кривая, и починить её за минуту.
Что уезжает в CRM: пять событий вместо одной записи
Самая недооценённая часть всей затеи. Обычная форма записи сообщает в CRM один факт: человек записался. А человек, который не записался, не сообщает ничего, и выглядит это как будто его и не было.
У меня в CRM уходило пять событий:
| событие | когда |
|---|---|
screen_1_completed | назвал себя и возраст ребёнка |
screen_2_completed | ответил про технику |
screen_3_completed | выбрал направление |
booking_completed | занял место |
telegram_button_clicked | перешёл в бота |
И каждое несёт с собой идентификатор лида и контакта, поэтому склеивается со сделкой, которая уже есть в CRM. То есть менеджер видел не «заявка не пришла», а «дошёл до выбора времени и закрыл вкладку», и это два совершенно разных разговора при следующем звонке.
Отдельно замечу про четвёртый экран: события screen_4_completed нет, его роль
играет сама бронь. Промежуточного состояния там нет: либо место занято, либо
человек ушёл.
Как такие события собирать и разбирать дальше, у меня разобрано в статье про автоматизацию отчётов, а про сервер, на котором живут все мои вебхуки, в разборе n8n.
Записаться мало, надо ещё дойти
Вот ради чего всё это считается. Кадр ниже из моего разбора про автоматизацию отчётов: сколько человек записалось на каждые полчаса и сколько из них потом реально пришло.
Четыреста четыре записи, дошли двести тридцать. Пятьдесят семь процентов, и хорошо это или плохо, зависит от школы. А вот вторая половина работы видна здесь отчётливо: человека мало записать, его надо ещё довести.
Отсюда же и главный довод за то, чтобы время выбирал родитель, а не менеджер при обзвоне. Вечерние слоты в будни держат доходимость, дневные проваливаются, потому что родитель на работе. Менеджер при обзвоне ставит удобное себе, а родитель, выбирающий сам, ставит то, в которое правда придёт.
Напоминание в телеграме - второй рычаг на той же цифре, и ровно поэтому бот в системе всё-таки был. Просто он занимался не записью.
Сколько записывал сам квиз
На квиз долго лили трафик, и всё это время он работал. Сам, без менеджера, записывался примерно каждый седьмой, около 15%. Точнее сейчас не скажу: отдельно эту цифру я не вёл.
Остальных доводили менеджеры первой линии, и всё равно квиз заметно снял с них нагрузку. А записи, которые он делал сам, потом неплохо доходили, если с ними ещё поработать.
Квиз не заменил менеджера, а забрал у него часть работы, и это нормальный результат.
Выключили его не за плохую работу. Школу поглотила другая, новых клиентов туда больше не привлекают, а текущих учеников доводят до конца обучения. Открытых уроков, на которые он записывал, не осталось, и квиз стал не нужен.
Где это ломается
Четыре места, и все четыре видно прямо в коде. Я их не чинил, и объясню почему.
Два родителя на последнее место. Создание брони устроено в три шага: читаем
слот, вставляем запись, уменьшаем счётчик свободных мест. Шаги не в одной
транзакции, поэтому двое, нажавшие «Записаться» в одну и ту же секунду, оба
пройдут проверку slot.vacant <= 0, пока она ещё верна, и место уйдёт дважды.
Второй увидит Slot is no longer available только если нажмёт позже на долю
секунды.
Лечится это условным обновлением на стороне базы: сначала уменьшаем счётчик запросом, который сам проверяет, что он больше нуля, и только если строка обновилась, создаём бронь. Я этого не сделал, и вот честная формулировка: жалоб на двойную запись до меня не доходило, но специально я их и не искал, а в логах такое столкновение выглядит как две обычные брони. В школе, где мест впритык, это первое, что надо закрыть.
Вебхук уходит без повтора. Событие в CRM отправляется и забывается: если
та сторона не ответила, в логе функции появится Webhook failed, а родитель
увидит успешную запись. База при этом права: бронь создана. А CRM о ней не
знает, и менеджер узнаёт о госте в момент, когда тот приходит на занятие.
Правильно здесь - очередь с повторами, и это уже не вечер работы.
Направление, которого нет в расписании. На экране выбора у детей от одиннадцати лет есть «WEB программирование», а в списке направлений, по которым школа присылает слоты, этого направления нет. Родитель выбирает его и попадает в тупик: «К сожалению, нет доступных слотов». Экран при этом честно предлагает выбрать другое направление, но осадок остаётся, а менеджер в CRM видит брошенный третий шаг и не понимает, почему.
Это цена того, что направление - строка, и совпадение строгое. Написали в
расписании Python вместо Python программирование - слот не найдётся никогда,
молча.
Документация разошлась с кодом. В руководстве по API написано, что адрес вебхука CRM передаётся параметром в ссылке на квиз. В коде он зашит константой в двух функциях, и параметр из адреса не читается вообще. Документацию писали под замысел, а реализовали проще, и это классика: правду надо проверять в коде, а не в файле рядом с ним.
Что я отверг и почему
Готовый сервис записи. Их десятки, они дешёвые и настраиваются быстро. Не подошло одно: в них нет правила «что показывать зависит от того, кто спрашивает». Школе было надо, чтобы девятилетнему не показывали Python, а семнадцатилетнему «Информатику Junior», и чтобы запись приклеилась к уже открытой сделке в CRM по идентификатору лида. Первое там делается костылями, второе не делается вообще.
Переписку в боте вместо формы. Разобрал выше: без прогресса и возврата конверсия на четырёх шагах падает, а разбор свободного ответа стоит дороже всей формы.
Свой календарь занятости педагогов. Соблазн был: раз есть база, давайте вести расписание в ней. Отказался сразу. Расписание уже велось в системе школы, и вторая копия разъедется в первую же неделю, причём узнают об этом не админы, а родитель, приехавший на отменённое занятие.
Оплату прямо в квизе. Пробное занятие бесплатное, платить не за что. Для платной услуги этот шаг добавляется, но тогда и гонка за последнее место перестаёт быть теоретической, и начинать надо с неё.
Сколько это заняло и сколько стоит содержать
Часов я по этой работе не замерял, но даты файлов говорят сами за себя: миграции базы от 24 января, экраны и функции от 26-го, последняя сборка от 11 февраля. То есть от пустой папки до работающей записи - два дня, а дальше две недели мелких правок.
Размер всей системы: около тысячи строк на фронте, три серверные функции на 431 строку и две миграции на 112. Это немного, и именно поэтому такое имеет смысл собирать своё, а не брать платформу.
Содержание стоило ноль рублей в месяц: хватало бесплатного плана базы, а статика лежала на обычном хостинге. Нагрузка тут копеечная: это форма на входе в школу, а не магазин.
Моя ставка - от 3000 ₽ в час, и считается она под сложность в обе стороны. Час того, кто такое уже собирал, и час того, кто делает это впервые, стоят по-разному: у первого лежат готовые куски, вторую такую миграцию возрастов он пишет не думая, а грабли с гонкой за место называет до того, как они случатся.
Кому не подойдёт
Тем, у кого услуга одна и всем подходит любое время. Берите готовый сервис записи, он дешевле и настраивается за вечер. Своё начинает окупаться там, где подходящее время зависит от самого человека.
Тем, у кого нет CRM. Половина ценности этой системы в том, что события приклеиваются к сделке. Без CRM остаётся просто форма, а форму вы соберёте и на конструкторе.
Тем, кому мест хватает впритык. Пока не сделан атомарный захват места, система отдаст последнее место дважды. Это чинится, но это работа, и её надо заложить сразу.
Тем, кто ждёт, что запись заменит менеджера. Она его не заменяет. Она снимает с него обзвон ради выбора времени и приносит ему знание, на каком шаге человек передумал.
С чего начать, если собираете сами
Начните не с формы, а с двух вещей: откуда к вам приедет расписание и куда вы вернёте событие. Форму нарисовать легко, и она же самая заметная часть, поэтому с неё и начинают. А ломается всегда стык: расписание, которое надо тянуть руками, и запись, которая никуда не уехала.
И проверяйте оба стыка на боевых данных, а не на тестовых. Расписание ломается не тогда, когда в нём сорок аккуратных слотов, а тогда, когда в одном из них направление написано с опечаткой.
Пишу про свои автоматизации в телеграм-канале: короткие заметки по ходу работы, без расписания и без рекламы.
Читать каналЕсли нужна не инструкция, а готовое решение под ваш бизнес - напишите мне, обсудим задачу.