Кабінет у Telegram Mini App

Кабінет клієнта можна відкривати прямо в Telegram — як міні-застосунок усередині вашого бота. Для клієнта це найзручніший вхід: не треба щоразу шукати лист, кабінет відкривається з чату в один дотик, а бот сам надсилає повідомлення про нові документи й нагадування про оплату. Бот — ваш власний, ви створюєте його самі та підключаєте у налаштуваннях кабінету.

Де це в застосунку: Налаштування → Client Hub → вкладка «Telegram»

Як підключити бота

Створіть бота у @BotFather у Telegram і скопіюйте його токен.
Відкрийте Налаштування → Client Hub → Telegram, вставте токен у поле й натисніть «Підключити».
Стан бота показується тут же: «Активний», «Відключено» або «Токен недійсний — вставте новий».

Нижче — таблиця «Клієнти в Telegram»: хто з клієнтів уже підключив бота, їхня пошта, остання активність і мітка «Заблокував бота».

Як клієнт потрапляє в кабінет через Telegram

Є два шляхи:

З кабінету. У розділі «Мій профіль» зʼявляється блок Telegram із кнопкою «Підключити Telegram» — вона веде на персональне посилання вашого бота. Клієнт натискає «Старт», і привʼязка готова. Персональне посилання дійсне 7 днів.
З листа для входу. Якщо бот підключений, у листі з посиланням для входу додається кнопка «Відкрити в Telegram».

Після привʼязки клієнт відкриває кабінет із самого чату — і потрапляє туди без введення пошти: вхід відбувається автоматично.

Чим Telegram відрізняється від браузера

Сесія коротша — 24 години. Але вона поновлюється щоразу, коли клієнт відкриває міні-застосунок, тож на практиці він цього не помічає. У звичайному браузері сесія кабінету тримається 30 днів.
Вхід кодом, а не посиланням. Якщо клієнт ще не привʼязаний, у Telegram йому запропонують ввести пошту й шестизначний код із листа: посилання відкрило б зовнішній браузер, і вхід «сів» би не туди.
Навігація. Бічне меню сховане під бургер, а на екрані документа працює нативна кнопка «Назад» самого Telegram. Список документів завжди показується картками, без табличного вигляду.
Застаріла сесія. Якщо клієнт довго не заходив, він побачить «Сесія Telegram застаріла» і кнопку «Увійти за посиланням на email» — це запасний шлях, коли код уже не допомагає.
Відключення Telegram у профілі всередині міні-застосунку одразу викидає клієнта на екран входу.

Що надсилає бот

Бот надсилає клієнту лише два типи повідомлень — обидва дублюють лист: «компанія надіслала вам документ» і нагадування про оплату. У кожному є кнопка, яка відкриває цей документ прямо в кабінеті. Надіслати документ у Telegram можна й вручну — з картки документа, у вікні «Поділитися».

Обмеження й нюанси

Якщо клієнт заблокував бота, повідомлення до нього перестають доходити, а в таблиці «Клієнти в Telegram» навпроти нього зʼявляється мітка «Заблокував бота». Виправляє це лише сам клієнт: розблокувати бота в Telegram і натиснути «Старт» — після цього мітка знімається і повідомлення знову доходять. Вхід у кабінет при цьому працює навіть із заблокованим ботом.

Якщо токен бота став недійсним (наприклад, ви перевипустили його в BotFather), бот вимикається і повідомлення не надсилаються, доки ви не вставите новий токен.

Блок Telegram у профілі клієнта видно лише тоді, коли бот підключений. Поки бота немає, у кабінеті про Telegram немає жодної згадки.

Один бот — на один робочий простір. Якщо клієнт працює з кількома вашими компаніями в різних просторах, у кожної буде свій бот і своя окрема привʼязка.

Часті питання

Клієнт натиснув «Підключити Telegram», а нічого не відкрилося. Найчастіше браузер заблокував нове вікно. Хай спробує ще раз або відкриє бота вручну — його імʼя показане поруч із кнопкою.

Чи можна відправляти клієнтам у Telegram довільні повідомлення? Ні. Бот надсилає лише документи й нагадування про оплату.

Чи отримають повідомлення клієнти, які не підключили бота? Ні, тільки листи на пошту.