← Проєкти

Автоматизація процесів · Кейс з відкритим кодом

Бот прийому звернень

Система прийому в Telegram: безладні повідомлення клієнтів стають керованими сценаріями, структурними записами про звернення та негайною дією адміністратора.

Дивитись репозиторій на GitHub
  • Python
  • Telegram
  • SQLite
  • Google Sheets
2026

Прийом, відтворений

Три двері всередину. Один запис назовні

Клієнт пише в юридичну фірму так, як писав би другові — половина речення, без дат, без документів. Кожен із трьох маршрутів нижче питає рівно те, чого не вистачає, у чіткому порядку, і кожен приводить до того самого запису на дванадцять колонок. Виберіть маршрут і подивіться, як запис заповнюється.

Виберіть маршрут

Той, у кого є проблема, яку він ще не зумів сформулювати.

Бот прийому зверненьонлайнМеню → Коротке питання
  1. Якої сфери це стосується?

    • Кримінальна
    • Господарська
    • Цивільна
    • Інше
  2. Опишіть ситуацію до 500 символів — хто причетний, що сталося, який строк тисне. Можна додати до двох PDF.

  3. Сьогодні зранку в офіс прийшли слідчі й забрали два ноутбуки. Нічого не підписували. Треба знати, що я можу зробити сьогодні.

    • seizure-report.pdf
    • equipment-list.pdf
  4. Наскільки це терміново?

    • Сьогодні
    • 1–2 дні
    • Не терміново
  5. Тут потрібна повноцінна відповідь, а не реплика в чаті. Виберіть тривалість консультації.

    • 30 хв
    • 60 хв
    • Пропустити
  6. Як вас звати?

  7. Андрій Коваленко

  8. Телефон у форматі +380 або @username у Telegram — або дозвольте Telegram надіслати ваш контакт.

    • Надіслати мій контакт
  9. Пошта, якщо хочете отримати відповідь ще й письмово.

    • Пропустити
  10. Дякую — це вже в юриста. Відповідь чекайте в особистих повідомленнях.

Що отримує юрист

Запис про зверненняЗбирається012колонок заповнює цей маршрут
Звернення
Створено
Статус
Джерело
Імʼя
Контакт
Пошта
Категорія
Терміновість
Формат
Тривалість
Суть
Звідки взялося кожне значення
  • запитали
  • уже відомо
  • лишили порожнім

Робочий бот працює саме так — українською, для київської практики. Імена, номери й назви файлів тут умовні.

Той бік кнопки «надіслати»

Юрист знає ще до того, як клієнт відклав телефон

Збереження звернення — це один запис, що розходиться в три боки: сповіщення, з яким юрист може працювати прямо з екрана блокування, рядок у таблиці, якою практика вже користується, і база, що тримає вкладення. Чотири кнопки нижче — саме ті, які надсилає бот. Натисніть.

Що прилітає юристові на телефон

Нове звернення №1042Бот прийому зверненьНове
Джерело
Коротке питання
Імʼя
Андрій Коваленко
Контакт
+380 50 ••• ••27
Суть
Сьогодні зранку в офіс прийшли слідчі й забрали два ноутбуки…

Натисніть кнопку

Сповіщення тут же перетворюється на повний запис — усі поля, які заповнив маршрут, не виходячи з Telegram.

Куди потрапляє те саме звернення

  • SQLiteЗапис
    • Чотири таблиці: звернення, їхні документи, люди, які написали, і кожне повідомлення.
    • Вкладення зберігаються як посилання на файли Telegram, тому жоден файл не лежить двічі.
    • Видалення звернення забирає його файли з собою — це гарантує база, а не чиясь памʼять.
  • Google SheetsРядок
    • Дванадцять колонок дописано, шапку закріплено, дати відформатовано, ширину підігнано.
    • Пишеться у фоновому потоці, тому бот тим часом відповідає наступному клієнтові.
    • Якщо таблиця недоступна, звернення вже збережене — збій логують, він ніколи не фатальний.
  • Експорт у CSVВигрузка
    • Одна кнопка в панелі віддає всі звернення файлом.
    • Чисто відкривається в Excel: UTF-8 із BOM, розділювач — крапка з комою, кожне поле в лапках.
    • Телефони записані як текст, тому +380 не приходить числом.
На якому етапі звернення
  1. НовеЙого ще ніхто не дивився
  2. У роботіХтось його веде
  3. ЗапланованоЧас погоджено
  4. ЗакритоВідповіли або відмовили

«Заплановано» ставлять із панелі. Сповіщення несе лише ті два натискання, які мають значення, поки клієнт ще тримає телефон.

Чому це не соромно показати клієнтові
  • У кожного кроку є шлях назад, а натискання кнопки меню чисто виходить із недозаповненого сценарію.
  • Контакти перевіряють на вході: номер у форматі +380, @username або контакт, який Telegram надсилає сам.
  • Суть обмежена 500 символами, тому до юриста доходить стислий опис, а не стіна тексту.
  • Швидкий маршрут приймає тільки PDF, максимум два файли, і відмовляє в решті з поясненням.
  • Перше повідомлення прямо каже, що відповідь бота не є юридичним висновком.
  • Кожне вхідне повідомлення логують проти його відправника, тому розмову можна відтворити згодом.

За сповіщенням стоїть повна панель: звернення за статусом, джерелом і періодом, по десять на сторінку, з експортом унизу. У тому самому меню лежать статті практики й картка юриста — тож бот не лише воронка, а місце, куди можна відправити людину.

Що змінилося

Те саме звернення: у скриньці й у системі

Клієнт в обох випадках надсилає те саме перше повідомлення. Змінюється те, скільки в ньому лишається питання на момент, коли воно доходить до юриста.

Те саме звернення клієнта, оброблене в скриньці й через бота
Що змінюєтьсяУ скриньціПо одному повідомленню, рукамиЧерез ботаТі самі дванадцять колонок, щоразу
Перше повідомленняУ скриньці«Добрий день, потрібна допомога» — і більше нічого, з чим працюватиЧерез ботаСфера, терміновість і суть на 500 символів, ще до першої відповіді
Дійти до сутіУ скриньціТри-чотири кола уточнень, розтягнуті на деньЧерез ботаБот питає у чіткому порядку й не йде далі, поки не отримає відповідь
Контактні даніУ скриньціПитають у кінці, іноді забувають, часом записують з помилкоюЧерез ботаПеревіряють на вході — номер +380, @username або надісланий контакт
ДокументиУ скриньціПричеплені до якогось повідомлення десь у переписці, яку ніхто не хоче гортатиЧерез ботаПричеплені до звернення й повертаються в чат одним натисканням
Дізнатися, що воно прийшлоУ скриньціХто перший відкриє Telegram, якщо взагалі відкриєЧерез ботаСповіщення зі зверненням і кнопками, щоб узяти його в роботу
На якому етапі зверненняУ скриньціУ списку чатів, за тим, хто написав останнімЧерез ботаНове, у роботі, заплановано чи закрито — з фільтром за джерелом і періодом
Поза робочим часомУ скриньціПовідомлення о 2:00 чекає до ранку, щоб хоч стати питаннямЧерез ботаПрийом завершується о 2:00. Чекає тільки відповідь
Якщо ваша перша відповідь новому клієнтові досі «розкажіть детальніше», давайте поговоримо.