Кейс · Telegram-бот + Planfix CRM

Клиенты пишут сами.
Менеджеры отвечают из CRM.

WarmStudio — тёплая воронка в Telegram, которая не нарушает правила и не рискует баном. Клиент сам нажимает Start, смотрит продукты, задаёт вопрос — и бесшовно переключается на живой диалог, где менеджер отвечает прямо из Planfix, не открывая Telegram.

100%в рамках правил Telegram
1 окнодля менеджера — Planfix
Авто → живойдиалог без швов
Почему так, а не иначе

Главное решение принято до первой строчки кода

Большинство «телеграм-воронок» ломаются об одну и ту же стену: чтобы дотянуться до клиента, начинают писать первыми — и ловят бан. WarmStudio устроен наоборот.

⚠️ Ловушка, в которую все попадают
  • 🚫Рассылка по номерам через личный аккаунт (userbot) → блокировка за спам незнакомым.
  • 📉Барьер на входе («оставьте телефон, потом покажем») отпугивает тех, кто просто смотрит.
  • 🪟Менеджер жонглирует вкладками Telegram, теряет историю и забывает про клиента.
  • 🕳️Контакты нигде не копятся — каждый диалог как с чистого листа.
✅ Как сделано в WarmStudio
  • 🤝Клиент инициирует контакт сам — жмёт Start. Переписка в рамках правил Telegram и устойчива вдолгую.
  • 🎯Контакт спрашиваем мягко — в момент «Появились вопросы», когда клиент сам захотел ответа. Никого не теряем на входе.
  • 💬Менеджер отвечает из Planfix — одно окно, вся история, быстрые ответы. В Telegram заходить не нужно.
  • 🗂️База клиентов растёт сама — карточки и задачи создаёт Chat API автоматически.
Попробуйте сами

Один диалог — две стороны, синхронно

Слева — то, что видит клиент в Telegram. Справа — что происходит в Planfix у менеджера. Нажимайте кнопки в телефоне и смотрите, как оживает CRM.

👆 Начните с кнопки «ЗАПУСТИТЬ» в телефоне
9:41▮▮▮  100%
‹
🔥
WarmStudio
бот
Сегодня
Chat API⇄
Planfix · Чаты
ожидание
💬
Здесь появится карточка клиента, как только он напишет. Контакт и задачу заводит Chat API — без ручной работы.
Это симуляция реального сценария Chat API Planfix.
Путь клиента

Без барьеров на входе — контакт в естественный момент

Шесть шагов от первого касания до живого диалога. Мы не теряем тех, кто просто смотрит, и фиксируем тех, кто реально вовлёкся.

01
Start
Клиент находит бота и жмёт Start. Видит приветствие, строку о согласии на обработку данных и меню.
02
Продукты
Жмёт «Информация по продуктам» → получает альбомы: галереи фото и видео с описанием, мгновенно из кэша.
03
Вопрос
Появились вопросы — жмёт кнопку. Бот мягко запрашивает контакт и заводит чат в Planfix.
04
Срочно
Задача помечается срочной автосценарием Planfix, менеджер получает уведомление.
05
Ответ
Менеджер отвечает прямо из Planfix → ответ доставляется клиенту в бота через Chat API.
06
Диалог
Дальше — обычная двусторонняя переписка: клиент пишет в бота, менеджер отвечает из CRM.
Архитектура

Четыре части и одна база — каждая на своём месте

Наведите на любой блок, чтобы увидеть его роль. Принцип распределения: контент и работа менеджеров — в Planfix; интерфейс, логика и наблюдаемость — в боте и админке.

🙋Клиент
⇄
✈️Telegram
⇄
🤖Бот · Replit
⇄
🔌Chat API
⇄
🟢Planfix
⇄
🧑‍💼Менеджер
↑ бот опирается на ↑
🗄️Внешняя БД · Postgres
🎛️Админ-панель
🤖
Бот на Replit
Лицо системы для клиента: меню, кнопки, альбомы, сценарии. Работает в webhook-режиме на Replit (Autoscale). Наведите на остальные блоки, чтобы посмотреть их роль.
Решения под нагрузку

Сделано так, чтобы работало вдолгую

Не «лишь бы запустить», а с учётом того, как Telegram, Planfix и облако ведут себя в реальности.

🗄️
Внешняя БД обязательна
Autoscale-деплой эфемерен и поднимает несколько экземпляров. Всё состояние — маппинг, кэш, конфиг, флаги согласия — живёт в Postgres, а не в файлах.
🔗
Целостность маппинга
Связка chat_id ↔ чат Planfix — критическая. Порвётся — ответы менеджера уйдут в никуда. Делаем надёжной и видимой в админке.
♻️
Идемпотентность
Telegram и Planfix повторяют вебхуки при сбоях. Дедупликация по ID сообщения — клиент не получает дубли, что бы ни случилось с сетью.
🔐
Безопасность вебхуков
Два разных токена: своим подписываем запросы к Planfix, чужой проверяем на входящих от Planfix. Секреты — в Secrets, не в коде.
⚡
Альбомы из кэша
Контент-правда в Planfix, но бот отдаёт клиенту кэш file_id — мгновенно. Синхронизация по кнопке в админке, а не на каждый тап.
📋
152-ФЗ и лимиты
Строка о согласии на обработку данных при старте. Учтены лимиты Telegram (~1 сообщение/сек в чат), чтобы не словить флуд при альбомах и рассылках.
Что где живёт

Ничего не дублируем без необходимости

🟢 В Planfix источник правды
Контент и работа менеджеров
📝Текстовые заготовки ответов — механизм быстрых ответов
🖼️Продуктовые альбомы — источник контента
💬Живая переписка с менеджером
🔴Эскалация и срочность — автосценарии
🗂️База клиентов и карточки контактов — ведётся автоматически
🤖 В боте и админке интерфейс + логика
UI, сценарии и наблюдаемость
⌨️Кнопочные меню и inline-интерфейс
🧭Логика сценариев бота
⚡Кэш file_id и состояние диалогов — в БД
🎛️Управление контентом и конфиг меню — без передеплоя
📊Мониторинг диалогов, ошибок и доставок

Хотите такую же тёплую воронку?

Соберём связку Telegram-бот + CRM под ваш продукт: клиенты пишут сами, менеджеры отвечают из одного окна, база растёт автоматически. Без риска бана, с прицелом на годы.