Новый провальный проект! TG бот записи с API YCLIENTS!

Новый провальный проект! TG бот записи с API YCLIENTS!

Привет, VC! Вряд ли кто-то скучал по мне, но все равно пишу эту статью. Напомню, что я обычный NPC, который в этот раз решил сделать полезный Telegram-бот для барбершопов, работающих через YCLIENTS.

Идея была простая: клиент записывается не через сайт, не через виджет, не через телефон, а прямо в Telegram. Бот показывает филиалы, услуги, мастеров, свободные даты, время, создаёт запись в YCLIENTS и в идеале дальше напоминает клиенту о визите.

Звучит вроде нормально. Даже логично. Изначально я предложил идею одному конкретному барбершопу, он заинтересовался, я начал делать, потом началась турбулентности с телегой и энтузиазм у клиента пропал. Тем не менее, бота я доделал.

Суть идеи

Началось все не с красивой стратегии, а с довольно простой мысли: у бизнеса есть CRM и они ей ограничены. Есть определенный набор инструментов и вполне определенное количество каналов записи:

  • Виджет YC на сайте (если у них есть сайт)
  • Виджет YC в Я.Картах (он обязательно есть)
  • Телефон (по которому можно терроризировать админа)
  • Приложение YPLACES (если вы знаете что оно существует)
  • Собственное приложение бизнеса (если салон отбашлял круглую сумму YCLIENTS за его разработку)
  • Сообщения в соцсетях (тот же самый админ на телефоне)

Например, барбершоп работает через YCLIENTS. Там есть расписание, мастера, услуги, записи, клиенты, администраторы. Все есть, работает. У них есть выстроенные сценарии записи. Но давайте посмотрим на путь, который клиент преодолевает каждый раз:

Целых 6 действий на самых популярных способах записи. Это еще не учитывая того, что клиент может чистить куки и ему каждый раз придется вводить свои данные «с нуля».
Целых 6 действий на самых популярных способах записи. Это еще не учитывая того, что клиент может чистить куки и ему каждый раз придется вводить свои данные «с нуля».

Я тут подумал: а что если сделать запись в Telegram?

Не отдельный “бот ради бота”, а именно нормальную оболочку поверх YCLIENTS. Чтобы бот не жил отдельно, не придумывал свое расписание, не хранил услуги отдельно, а брал всё напрямую из YCLIENTS.

То есть администратор меняет расписание в YCLIENTS — бот это видит. Мастер ушел в отпуск — бот не предлагает к нему записаться. У услуги поменялась длительность — время считается нормально. Все синхронизировано.

В первой версии я хотел сделать все довольно скромно:

  • выбор филиала
  • выбор услуги
  • выбор мастера
  • выбор даты
  • выбор времени
  • создание записи в YCLIENTS
  • отмена записи
  • просмотр моих записей
  • кнопка “Контакты”

Но довольно быстро стало понятно, что “просто запись” — это только верхушка, бизнесу нужны бесплатные надстройки чтобы не платить сторонним официальным расширениям на маркетплейсе YС.

Новый провальный проект! TG бот записи с API YCLIENTS!

Появились дополнительные функции:

  • отправлять клиенту уведомление о новой записи
  • напоминать за 24, 2 часа и за 1 час, плюс чтобы клиент сам мог настраивать когда ему напоминать
  • дать возможность делать маркетинговые рассылки
  • после визита отправлять благодарность

И еще парочка бонусов для закрытия всех потребностей:

  • показывать отзывы о барберах
  • корректно и «бесшовно» собирать согласие на обработку персональных данных
Новый провальный проект! TG бот записи с API YCLIENTS!

Вот тут я и понял одну неприятную вещь. Когда ты говоришь “Telegram-бот для записи”, люди слышат игрушку. Когда ты начинаешь делать, оказывается, что это маленькая интеграционная система с CRM, клиентскими данными, логикой расписания, юридическими согласиями, сервером, базой, уведомлениями и кучей пограничных случаев. А я ведь просто хотел красиво нажимать кнопки в Telegram.

Практический совет: на этапе идеи сразу разделяйте “что выглядит как одна кнопка” и “что стоит за этой кнопкой”. Иногда кнопка “Записаться” — это неделя работы.

Как я собирал бота: FastAPI, Docker и немного боли

Итак, запись выглядит примерно так:

  • Клиент нажимает "Записаться"
  • Сервер спрашивает филиал
  • Сервер получает услуги из YCLIENTS
  • Возвращает кнопки в Telegram
  • Клиент выбирает услугу
  • Сервер получает мастеров
  • Потом даты
  • Потом время
  • Потом создает запись

Звучит просто. На деле, конечно, началась классика: “почему оно не отвечает”, “почему телефон не так нормализуется”, “почему запись создаётся, но отмена по hash не работает”, “почему Telegram API опять отвалился”.

В какой-то момент у меня появились рабочие эндроинты:

/companies /services /staff /book-dates /book-times /pb2/services /pb2/dates /pb2/times /pb2/book3 /pb2/cancel /pb2/client/lookup

Самый приятный момент был, когда тестовая запись реально создалась в YCLIENTS.

Практический совет: если делаете MVP-интеграцию, сначала добейтесь одного настоящего сквозного действия. Не "кнопки работают", не "API отвечает", а именно полного сценария: клиент нажал — запись появилась в CRM.

Почему YCLIENTS оказался не просто "подключим API и все"

Когда я думал про интеграцию с YCLIENTS, мне казалось: ну что там сложного? Забрать услуги, мастеров, свободные слоты, создать запись. На практике нюансов больше.

Например, важно не просто показать список мастеров. Надо учитывать:

  • филиал
  • услуги
  • длительность услуги
  • расписание мастера
  • отпуска
  • больничные
  • доступные даты
  • свободное время
  • существующие записи
  • ограничения самой CRM

То есть бот не может просто показать "Иван, завтра в 15:00". Он должен быть уверен, что Иван реально работает завтра, оказывает эту услугу, в этом филиале, в это время свободен, а услуга помещается по длительности.

Отдельная история — телефон клиента

Telegram может отдать телефон в одном формате, клиент в YCLIENTS может быть записан в другом, администратор мог когда-то внести номер через 8, через +7, с пробелами, скобками, дефисами или ошибкой в одной цифре. В итоге пришлось отдельно думать про нормализацию телефона: приводить номер к виду, который можно сравнивать с тем, что есть в YCLIENTS. Вот это, кстати, одна из слепых зон.

Когда я презентовал идею, я говорил, что "бот узнает клиента по телефону". И при этом вспоминал как воевал с форматами...

Практический совет: любые данные, которые вводят люди (телефон, имя, дата рождения, email) — всё будет в разных форматах. Лучше заложить это сразу, чем потом фиксить.

Как я пытался продавать и почему "бот работает" не значит "бот купят"

Самое смешное началось после того, как у меня появилась рабочая версия.

Я думал примерно так:

!Ну вот же, барбершопы уже сидят в YCLIENTS. У них есть клиенты. Telegram у всех есть. Я делаю им новый канал записи. Что может пойти не так?"

Ответ: всё, что связано с продажами и внезапными блокировками.

Тот потенциальный клиент, для которого я делал бот отвалился. Я стал искать другие барбершопы. Не просто рандомно, а именно те, где потенциально есть смысл: с нормальным чеком за услугу, которые работают через YCLIENTS, несколько мастеров, адекватные сайты и карточки на картах, не совсем микробизнес из одного кресла — в общем такие места, где видно, что барбершоп работает ради клиентов, а не загибается.

Писал сообщения. Звонил. По телефону отдельная магия.

Ты звонишь в барбершоп, трубку берёт администратор. И ты понимаешь, что разговариваешь не с человеком, который принимает решение, а с фильтром. От того, как ты объяснишь идею за 20 секунд, зависит, пойдёт ли это дальше владельцу или умрёт прямо сейчас между "алло" и "нам ничего не надо". Откуда админке вообще знать что нужно владельцу?

Я пробовал разные заходы.

Например:

"Здравствуйте, я честно скажу, звоню не для того, чтобы записаться. Я хочу предложить владельцу барбершопа новый канал записи в Telegram через бота, который синхронизирован с YCLIENTS. Можно как-то с ним связаться?"

Это было честнее, чем изображать клиента, а потом резко доставать ноутбук с презентацией.

Но продаж всё равно не было.

Где-то не отвечали. Где-то просили прислать. Где-то вежливо молчали. Где-то интерес был, но не доходило до денег. Один раз вроде даже удалось хорошо поговорить, показать MVP, получить интерес, но сделка не закрылась.

И тут я поймал важный инсайт.

Малому бизнесу мало показать "технически работает". Нужно попасть в боль, в момент и в деньги.

Если у владельца сейчас не болит запись, если администратор справляется, если клиентов хватает, если Telegram кажется риском, если "давайте потом" — ты можешь хоть на голове стоять со своим FastAPI. Момент для телеграмма тоже не благоприятный, мягко говоря.

Практический совет: не путайте интерес и покупку. “Прикольно, скиньте” — это не сделка. “Давайте созвонимся в четверг и обсудим условия теста” — уже лучше.

Почему Telegram одновременно аргумент и возражение

Я думал, что Telegram будет главным плюсом.

Ну правда. Люди и так там сидят. Записаться через Telegram проще, чем искать сайт. Можно отправлять уведомления. Можно сделать повторные касания. Можно собрать лояльную базу клиентов. Но оказалось, что Telegram — это ещё и возражение.

У бизнеса могут быть вопросы:

  • а если Telegram признают экстремисским?
  • а если он будет тормозить?
  • а если клиент не пользуется Telegram?
  • а если бот не сможет написать клиенту?
  • а если это выглядит несерьёзно?

И часть этих вопросов нормальная.

Например, Telegram-бот действительно не может написать человеку первым, если человек не запускал бота. Это важное ограничение. Поэтому для уведомлений нужно, чтобы клиент хотя бы один раз нажал /start и связал свой телефон с профилем.

То есть нельзя просто взять всех клиентов из YCLIENTS и начать им писать в Telegram от имени бота. И слава богу, иначе Telegram окончательно превратился бы в помойку.

Отдельно я думал про уведомления для клиентов, которые записались не через бота, а через администратора или виджет. Тут уже появляется более сложная архитектура: YCLIENTS событие → webhook → поиск связанного Telegram-пользователя → сообщение в бот.

Если клиент бота запускал — можно уведомить. Если нет — нельзя.

И вот это надо объяснять бизнесу простыми словами, без технической каши.

Новый провальный проект! TG бот записи с API YCLIENTS!

Где я сам ошибся

Ошибок было несколько.

Ошибка №1. Я слишком рано ушёл в разработку

Я делал продукт, потому что видел логику. Но логика в голове разработчика и реальная готовность бизнеса платить — разные вещи.

Надо было раньше провести больше нормальных разговоров с владельцами и администраторами:

  • как сейчас клиенты записываются
  • сколько записей теряется
  • какие каналы работают
  • раздражают ли звонки
  • пользуются ли рассылками
  • сколько стоит один новый клиент
  • какие функции реально нужны для покупки

Я частично это делал, но недостаточно системно.

Ошибка №2. Я продавал несуществующий результат.

У меня нет реального рейса. Все что говорю звучит как выдумка:

  • новый канал записи;
  • снижение нагрузки на администратора
  • возврат клиентов через напоминания
  • база клиентов в Telegram
  • меньше потерянных записей
  • быстрый повторный контакт после визита

Кейса нет, нет метрик, нет никаких данных. И это отпугивает.

Ошибка №3. Я недооценил роль доверия

Для владельца барбершопа я человек со стороны. Даже если бот работает, ему нужно понять:

  • не сломаю ли я запись
  • не утекут ли данные клиентов
  • смогу ли я поддерживать систему
  • что будет, если я пропаду
  • как это перенести на другой сервер
  • где договорённости
  • кто отвечает за ошибки

И это нормальные вопросы.

Поэтому теперь я думаю, что нужна не только демо-ссылка, а нормальная упаковка: презентация, лендинг, понятная схема работы, безопасность, ограничения, стоимость, условия теста.

Что сейчас с проектом?

Сейчас рабочая версия бота есть, но лицензия YCLIENTS закончилась. Поэтому я не могу вживую демонстрировать полную работоспособность так, как хотелось бы: нажал кнопку, выбрал мастера, создал запись, она появилась в CRM.

Это неприятно. Но не катастрофа.

Проект все равно дал мне несколько вещей:

  • готовую техническую базу
  • понимание API YCLIENTS
  • сценарии записи через Telegram
  • понимание ограничений Telegram
  • заготовку под юридически более аккуратную обработку персональных данных
  • понимание, как адаптировать продукт под другие бизнесы

Теперь я думаю сделать презентацию или лендинг, подключить бесплатно какой-нибудь салон и на его примере демонстрировать потенциальным клиентам рабочий бот. Ну, как минимум до конца 2026, потому что заявления ФАС (неожиданно!) напрягают. Если телегу признают экстремистским мессенджером, то ни о какой обработке персональных данных не может идти и речи. До сих пор риски минимальные, но они сохраняются.

Что я бы сделал иначе, если бы начинал заново

Если бы я сейчас начинал этот проект с нуля, я бы пошел не от разработки, а от проверки спроса.

Сначала сделал бы короткий лендинг или презентацию:

  • “Запись клиентов в барбершоп через Telegram, синхронизация с YCLIENTS”
  • 5 экранов интерфейса
  • схема работы
  • список функций
  • ограничения
  • цена MVP

Потом пошёл бы к владельцам с конкретным предложением:

"Я подключаю вам Telegram-бота к YCLIENTS на 2 недели. Клиенты могут записываться через Telegram. Если видите пользу — оставляем. Если нет — отключаем".

И уже под это доделывал бы продукт.

Потому что когда ты сначала строишь, а потом ищешь покупателя, есть риск построить очень красивую штуку для своего внутреннего инженера.

А бизнесу может быть вообще нужна одна кнопка:

"Напомнить клиенту за день, чтобы он не забыл прийти".

И всё. Остальное он не просил.

Кстати, если у вас есть опыт продажи таких решений малому бизнесу — интересно, как вы заходили? Через владельца? Через администратора? Через знакомых? Через холодные сообщения? Потому что у меня пока главный результат холодных касаний — прокачка смирения.

Если коротко, я сделал Telegram-бота для записи в барбершоп через YCLIENTS. Продаж нет. Но я не считаю это провалом. Провал — это когда ты полгода делаешь стартап, но у тебя нет ни продукта, ни понимания, ни следующего шага. У меня есть продуктовая база, рабочий опыт, список ошибок и понимание, что дальше нужна не ещё одна функция, а нормальная упаковка и более точное предложение рынку.

Спасибо, что дочитали!

Может у вас был подобный опыт? Поделитесь в комментариях. Также если у вас есть бизнес, давайте подключим туда моего бота? Как идея?

1
Начать дискуссию