[{"data":1,"prerenderedAt":358},["ShallowReactive",2],{"help-article-invoice-534":3,"help-view-invoice":37},{"data":4},{"help":5},{"id":6,"name":7,"article":8},"20","Інвойс",{"id":9,"catalog":10,"category":11,"keywords":14,"title":25,"description":26,"body":27,"legacy":28,"created_by":29,"created_at":33,"updated_at":34,"edge_associated_articles":35},"534",{"id":6,"name":7},{"id":12,"name":13},"95","Інтеграції та API",[15,16,17,18,19,20,21,22,23,24],"Telegram-бот","підключити бота","токен бота","BotFather","сповіщення в Telegram","надіслати документ у Telegram","кабінет клієнта Telegram","клієнт заблокував бота","прив’язка Telegram","нагадування в Telegram","Telegram-бот для клієнтів","До кабінету клієнта можна підключити **власного Telegram-бота**. Після цього ваші клієнти отримують у Telegram дубль повідомлень, які ви й так надсилаєте їм поштою — «вам надіслали документ» і «нагадування про оплату» — і відкривають документ прямо з чату. Бот належить вам: ви створюєте його в BotFather, він виступає п","До кабінету клієнта можна підключити **власного Telegram-бота**. Після цього ваші клієнти отримують у Telegram дубль повідомлень, які ви й так надсилаєте їм поштою — «вам надіслали документ» і «нагадування про оплату» — і відкривають документ прямо з чату. Бот належить вам: ви створюєте його в BotFather, він виступає під вашою назвою та іконкою. Ця стаття написана з точки зору **власника**, який його підключає.\n\n**Де це в застосунку:** Налаштування → **Кабінет клієнта** → вкладка **Telegram**.\n\n## Що дає бот і чого він не дає\n\nБот — це **додатковий канал доставки, а не заміна пошти**. Лист клієнту йде завжди; повідомлення в Telegram — зверху, якщо клієнт прив'язав свій Telegram. Якщо доставка в Telegram не спрацює, на лист це ніяк не вплине.\n\nБот не веде діалогів, не приймає команд і не відповідає на питання. Усе, що він робить, — надсилає два типи коротких повідомлень із кнопкою, що відкриває документ у кабінеті клієнта прямо всередині Telegram.\n\nБот один на робочий простір. Якщо у вас кілька компаній в одному просторі, бот у них спільний.\n\n## Як підключити бота\n\n1. У Telegram відкрийте **@BotFather**, створіть нового бота (команда `/newbot`), задайте йому назву та імʼя користувача і скопіюйте виданий **токен**.\n2. У застосунку відкрийте **Налаштування → Кабінет клієнта**. Спершу має бути ввімкнено сам перемикач **«Кабінет увімкнено»** — без кабінету боту нема куди вести клієнта.\n3. Перейдіть на вкладку **Telegram**, вставте токен у поле **«Токен бота з BotFather»** і натисніть **«Підключити»**.\n\nЯкщо все гаразд, стан бота зміниться на **«Активний»**. Можливі повідомлення про помилку:\n\n* **«Токен недійсний. Скопіюйте токен бота з BotFather і спробуйте ще раз»** — токен скопійовано не повністю або бот видалений.\n\n* **«Цей бот уже підключений до іншого workspace»** — один бот не можна використовувати у двох робочих просторах. Створіть окремого бота.\n\n* **«Не вдалося налаштувати бота в Telegram»** — тимчасова помилка звʼязку з Telegram, спробуйте ще раз.\n\nКнопка **«Відключити»** вимикає бота, але **не стирає прив'язки клієнтів**: якщо потім підключити того самого бота знову, усі прив'язки повернуться. А от заміна на **іншого** бота стирає всі прив'язки — клієнтам доведеться підключатися заново.\n\nНижче на цій самій вкладці є таблиця **«Клієнти в Telegram»** — хто саме з клієнтів прив'язав бота, коли востаннє була активність і хто бота заблокував. Поки ніхто не підключився, там напис «Ще ніхто з клієнтів не підключив бота».\n\n## Як клієнт прив'язується до бота\n\nПрив'язка йде **за e-mail**: Telegram-акаунт клієнта звʼязується з тією адресою, на яку ви надсилаєте йому документи.\n\nКлієнт отримує посилання-запрошення одним із двох шляхів:\n\n* **З кабінету.** У своєму профілі в кабінеті він бачить блок «Telegram» із кнопкою **«Підключити Telegram»**. Кнопка відкриває чат із вашим ботом, клієнт тисне «Start» — і готово.\n\n* **З листа про вхід у кабінет.** У листі є окрема кнопка «відкрити в Telegram» — вона веде туди ж.\n\nПосилання-запрошення **одноразове й діє 7 днів**. Якщо клієнт відкриє його пізніше, бот відповість, що посилання недійсне або протерміноване, і попросить взяти свіже — з листа або з профілю кабінету.\n\nДіє правило **«один Telegram — один e-mail»**: якщо клієнт прив'яже до свого Telegram іншу адресу, попередня прив'язка зникне. Тому клієнт, який отримує від вас документи на дві різні пошти, у Telegram отримуватиме тільки ті, що йдуть на останню прив'язану.\n\nПро сам кабінет — [Кабінет клієнта: що це і як увімкнути](https://wiki.oneb.app/help/invoice/articles/519) і [Вхід клієнта в кабінет: посилання, код і Telegram](https://wiki.oneb.app/help/invoice/articles/522); про роботу кабінету всередині Telegram — [Кабінет у Telegram Mini App](https://wiki.oneb.app/help/invoice/articles/528).\n\n## Що бот надсилає клієнту\n\nРівно два типи повідомлень — обидва дублюють пошту:\n\n1. **Документ надіслано** — «{ваша компанія} надіслала вам документ «{назва} № {номер}» на суму {сума}». Іде тоді ж, коли ви надсилаєте документ клієнту листом ([Надсилання документа клієнту](https://wiki.oneb.app/help/invoice/articles/429)).\n2. **Нагадування про оплату** — «Нагадування про оплату: {документ} № {номер} від {компанія} на суму {сума}, сплатити до {дата}». Іде тоді ж, коли й автоматичне нагадування на пошту, якщо ви ввімкнули його в документі ([Автоматичні нагадування про оплату](https://wiki.oneb.app/help/invoice/articles/326)).\n\nДо кожного повідомлення додається кнопка, що відкриває цей документ у кабінеті всередині Telegram. Мова повідомлення — мова документа.\n\nБільше бот не надсилає **нічого**: ні про оплату, ні про підпис, ні про статуси, ні про заявки з вітрини.\n\n## Ручна відправка документа в Telegram\n\nІноді треба «підштовхнути» клієнта окремо. У вікні **«Поширити»** на картці документа ([Картка рахунку: що можна зробити після створення](https://wiki.oneb.app/help/invoice/articles/517)) під плитками поширення зʼявляється синя смуга **«Клієнт підключив Telegram — можна надіслати документ прямо в бот»** з кнопкою **«Надіслати в Telegram»**. Смуга показується лише тоді, коли e-mail у полі отримувача справді має прив'язаний Telegram.\n\nЯкщо натиснути кнопку і побачити **«Не вдалося надіслати в Telegram»**, причина буде однією з чотирьох:\n\n1. **Документ не поширений** — він у чернетці або публічного посилання ще немає. Спершу натисніть «Поширити» ([Публічне посилання на документ](https://wiki.oneb.app/help/invoice/articles/508)).\n2. **Бот не підключений або вимкнений** — перевірте стан на вкладці Telegram у налаштуваннях кабінету.\n3. **Цей e-mail не прив'язав Telegram** — або прив'язка є, але клієнт заблокував бота.\n4. **У цього e-mail немає доступу до кабінету** — кабінет вимкнено, або адреса не належить жодному вашому клієнту в цьому робочому просторі. Часта причина: ви вписали в поле відправки разову адресу, якої немає в картці клієнта.\n\n## Якщо клієнт заблокував бота\n\nКлієнт може будь-коли натиснути «Заблокувати» в чаті. Тоді:\n\n* повідомлення йому більше не надсилаються — тихо, без помилок у вашому інтерфейсі;\n\n* у таблиці **«Клієнти в Telegram»** навпроти нього зʼявляється мітка **«Заблокував бота»**;\n\n* пошта продовжує ходити як зазвичай — блокування бота на листи не впливає;\n\n* ручна відправка в Telegram для нього перестане спрацьовувати.\n\nЩоб повернути доступ, клієнту достатньо розблокувати бота і натиснути в чаті **Start** — мітка зніметься сама, повторно прив'язуватись не треба.\n\nОкремо: якщо ви відкликали токен бота в BotFather, стан бота зміниться на **«Токен недійсний — вставте новий»** і розсилка зупиниться до того, як ви вставите свіжий токен.\n\n## Для власників Telegram-сповіщень немає\n\nЦе найчастіше непорозуміння. Бот працює **тільки для ваших клієнтів**. Ви й ваші колеги жодних сповіщень у Telegram не отримуєте.\n\nУ власних налаштуваннях сповіщень (дзвіночок у шапці застосунку) є блок «Telegram» — він **неактивний** і підписаний **«В розробці»**. Це не помилка і не наслідок того, що бота не підключено: каналу для власників поки просто не існує. Доступні канали для команди — стрічка в застосунку та e-mail ([Сповіщення](https://wiki.oneb.app/help/invoice/articles/373)).\n\n## Обмеження й нюанси\n\nПідключити або відключити бота може лише користувач із правами адміністратора робочого простору ([Користувачі й ролі](https://wiki.oneb.app/help/invoice/articles/419)). Решта користувачів вкладку Telegram побачить, але змінити нічого не зможе.\n\nКабінет клієнта позначений як попередній доступ — угорі сторінки висить інформер «Інструмент у розробці — можливі зміни в роботі та вигляді».\n\nБот один на робочий простір, і один і той самий бот не можна підключити до двох робочих просторів — для другого простору створіть окремого бота в BotFather.\n\nПрив'язка йде за e-mail, а не за номером телефона чи імʼям у Telegram. Якщо ви надсилаєте документи на адресу, якої немає в картці клієнта, повідомлення в Telegram не піде.\n\nTelegram — додатковий канал: він ніколи не замінює лист і не скасовує його.\n\n## Що відбувається автоматично\n\n* Коли ви надсилаєте документ клієнту поштою, повідомлення в Telegram іде **саме собою** — окремо нічого натискати не треба.\n\n* Автоматичне нагадування про оплату дублюється в Telegram у той самий момент, що й лист.\n\n* У листі про вхід у кабінет клієнту автоматично підставляється кнопка підключення Telegram — але лише якщо бот активний і ця адреса справді має доступ до кабінету.\n\n* Якщо клієнт заблокував бота, застосунок сам це помічає і припиняє спроби писати йому.\n\n* Старі невикористані посилання-запрошення застосунок прибирає сам.\n\n## Часті питання\n\n**Клієнт каже, що не отримує нічого в Telegram.**\nПеревірте по черзі: чи бот у стані «Активний»; чи є цей клієнт у таблиці «Клієнти в Telegram»; чи немає навпроти нього мітки «Заблокував бота»; чи збігається адреса, на яку ви надсилаєте документ, з адресою в картці клієнта.\n\n**Чи можна надіслати клієнту документ тільки в Telegram, без листа?**\nНі. Telegram завжди дублює пошту. Окрема кнопка «Надіслати в Telegram» у вікні поширення додає повідомлення, а не замінює лист.\n\n**Клієнт відкрив запрошення, а бот пише, що посилання недійсне.**\nПосилання діє 7 днів і лише один раз. Попросіть клієнта взяти свіже в профілі кабінету — або надішліть новий лист про вхід у кабінет.\n\n**Я змінив бота. Чому клієнти перестали отримувати повідомлення?**\nЗаміна на іншого бота стирає всі прив'язки. Клієнтам треба підключитися заново — через профіль у кабінеті.\n\n**Чому я не отримую сповіщень у Telegram про нові документи чи оплати?**\nTelegram для власників не реалізовано — у налаштуваннях сповіщень цей блок підписаний «В розробці». Бот працює тільки в бік клієнтів.\n\n**Бот відповідає на повідомлення клієнтів?**\nНі. Він реагує лише на команду Start і розсилає два типи повідомлень. Діалог із ним вести не можна.\n\n## Дивіться також\n\n* [Сповіщення](https://wiki.oneb.app/help/invoice/articles/373) — які канали є для вас і вашої команди\n\n* [Надсилання документа клієнту: email, посилання, QR](https://wiki.oneb.app/help/invoice/articles/429) — коли спрацьовує дубль у Telegram\n\n* [Автоматичні нагадування про оплату](https://wiki.oneb.app/help/invoice/articles/326) — друге з двох повідомлень бота\n\n* [Публічне посилання на документ: як працює і як захистити](https://wiki.oneb.app/help/invoice/articles/508) — чому непоширений документ не піде в Telegram\n\n* [Картка клієнта](https://wiki.oneb.app/help/invoice/articles/316) — де видно позначку «Telegram підключено»\n\n* [Публічна картка компанії](https://wiki.oneb.app/help/invoice/articles/530) — сусідня публічна поверхня застосунку\n\n",false,{"id":30,"name":31,"photo_url":32},"37","Ярослав Плакида","https://account.oneb.app/uploads/usr/photo/1/JMQPpCmTUtL2j8Mecr5W3TbY5ZbyK4fw.jpeg?w=300&h=300&fit=crop&s=7712ff4ac866b4965be19403505c01c8",1787998571,1788959110,{"edges":36},[],{"data":38},{"help":39},{"id":6,"name":7,"language":40,"edge_categories":43,"edge_translations":356},{"id":41,"name":42},"uk","Українська",{"page_info":44,"edges":46},{"has_next_page":28,"end_cursor":45},"W1s0XSxbMiw1NV1d",[47,79,111,143,175,207,238,270,301,329,341],{"node":48},{"id":49,"name":50,"created_at":51,"articles_count":52,"edge_preview_articles":53},"54","Початок роботи",1698401262,14,{"edges":54},[55,59,63,67,71,75],{"node":56},{"id":57,"title":58},"548","Що відбувається з даними при видаленні",{"node":60},{"id":61,"title":62},"524","Історія змін документа і відновлення версії",{"node":64},{"id":65,"title":66},"509","Що OneB Invoice робить сам",{"node":68},{"id":69,"title":70},"506","Вхід у застосунок, зміна пошти й перемикання просторів",{"node":72},{"id":73,"title":74},"505","Робочий простір: що це, аліас і кілька просторів",{"node":76},{"id":77,"title":78},"455","Головна сторінка: швидкі дії, статистика і контроль оплат",{"node":80},{"id":81,"name":82,"created_at":83,"articles_count":84,"edge_preview_articles":85},"71","Документи",1730719366,7,{"edges":86},[87,91,95,99,103,107],{"node":88},{"id":89,"title":90},"529","Документ за QR-кодом",{"node":92},{"id":93,"title":94},"526","Редагування й копіювання рахунку",{"node":96},{"id":97,"title":98},"521","Додатки до договору",{"node":100},{"id":101,"title":102},"520","Зв'язки між документами: «в рамках», батьківський документ і копія",{"node":104},{"id":105,"title":106},"518","Публічна сторінка документа очима клієнта",{"node":108},{"id":109,"title":110},"517","Картка рахунку: що можна зробити після створення",{"node":112},{"id":113,"name":114,"created_at":115,"articles_count":116,"edge_preview_articles":117},"84","Покрокові інструкції",1783639591,52,{"edges":118},[119,123,127,131,135,139],{"node":120},{"id":121,"title":122},"560","Як додати печатку компанії на документи",{"node":124},{"id":125,"title":126},"556","Як імпортувати договір із Word (.docx) у шаблон",{"node":128},{"id":129,"title":130},"531","Публічний звіт для бухгалтера чи партнера",{"node":132},{"id":133,"title":134},"514","Сторони договору й заповнення даних контрагентом",{"node":136},{"id":137,"title":138},"513","Підпис «від руки» і «на папері»",{"node":140},{"id":141,"title":142},"512","Картка договору: вкладки Огляд, Специфікація, Повʼязані, Додатки, Історія",{"node":144},{"id":145,"name":146,"created_at":147,"articles_count":148,"edge_preview_articles":149},"85","Поняття й терміни",1783640071,8,{"edges":150},[151,155,159,163,167,171],{"node":152},{"id":153,"title":154},"545","SWIFT і SEPA реквізити",{"node":156},{"id":157,"title":158},"544","Бюджет проєкту (бета)",{"node":160},{"id":161,"title":162},"541","Учасники проєкту, задачі та ставки",{"node":164},{"id":165,"title":166},"511","Що означають сторінки помилок",{"node":168},{"id":169,"title":170},"508","Публічне посилання на документ: як працює і як захистити",{"node":172},{"id":173,"title":174},"417","Типи документів у OneB Invoice: що є що",{"node":176},{"id":177,"name":178,"created_at":179,"articles_count":180,"edge_preview_articles":181},"86","Огляди можливостей",1783640913,12,{"edges":182},[183,187,191,195,199,203],{"node":184},{"id":185,"title":186},"549","Журнали дня і тижня, звіт з обліку часу",{"node":188},{"id":189,"title":190},"547","Імпорт записів часу",{"node":192},{"id":193,"title":194},"540","Штрихкоди: сканування й пошук товару",{"node":196},{"id":197,"title":198},"536","Архів проєктів: куди подівся проєкт",{"node":200},{"id":201,"title":202},"523","Вибіркова аналітика: як побудувати власний звіт",{"node":204},{"id":205,"title":206},"454","Платежі: вхідні, вихідні та контроль оплат",{"node":208},{"id":209,"name":210,"created_at":211,"articles_count":148,"edge_preview_articles":212},"87","Сценарії використання",1783724309,{"edges":213},[214,218,222,226,230,234],{"node":215},{"id":216,"title":217},"546","Бухгалтер обслуговує кількох ФОП",{"node":219},{"id":220,"title":221},"542","Робота з іноземним замовником від А до Я",{"node":223},{"id":224,"title":225},"538","Файли проєкту",{"node":227},{"id":228,"title":229},"462","Погодинна робота: від обліку годин до рахунку й акта",{"node":231},{"id":232,"title":233},"461","Продаж товарів: від замовлення до видаткової накладної",{"node":235},{"id":236,"title":237},"460","Проєктна робота: кошторис, аванс, етапні акти і контроль бюджету",{"node":239},{"id":240,"name":241,"created_at":242,"articles_count":243,"edge_preview_articles":244},"93","Налаштування",1787996248,9,{"edges":245},[246,250,254,258,262,266],{"node":247},{"id":248,"title":249},"553","Доступ для служби підтримки: як дати боту тимчасовий доступ до свого простору",{"node":251},{"id":252,"title":253},"537","Додаткові поля у специфікації (колонки кошторису)",{"node":255},{"id":256,"title":257},"535","Категорії товарів",{"node":259},{"id":260,"title":261},"533","Валюти й курси",{"node":263},{"id":264,"title":265},"532","Загальні налаштування робочого простору",{"node":267},{"id":268,"title":269},"515","Формати дати, часу, чисел і валюти",{"node":271},{"id":272,"name":273,"created_at":274,"articles_count":84,"edge_preview_articles":275},"94","Кабінет клієнта та публічні сторінки",1787996251,{"edges":276},[277,281,285,289,293,297],{"node":278},{"id":279,"title":280},"543","Вітрина очима покупця",{"node":282},{"id":283,"title":284},"528","Кабінет у Telegram Mini App",{"node":286},{"id":287,"title":288},"527","Клієнт подає заявку з кабінету",{"node":290},{"id":291,"title":292},"525","Кабінет очима клієнта: головна, документи, деталі, профіль",{"node":294},{"id":295,"title":296},"522","Вхід клієнта в кабінет: посилання, код і Telegram",{"node":298},{"id":299,"title":300},"519","Кабінет клієнта: що це і як увімкнути",{"node":302},{"id":12,"name":13,"created_at":303,"articles_count":304,"edge_preview_articles":305},1787996254,6,{"edges":306},[307,309,313,317,321,325],{"node":308},{"id":9,"title":25},{"node":310},{"id":311,"title":312},"448","Інтеграція зі School Today: рахунки за харчування учнів",{"node":314},{"id":315,"title":316},"447","Інтеграція з Prom.ua: рахунки із замовлень магазину",{"node":318},{"id":319,"title":320},"440","Webhooks: миттєві сповіщення ваших систем про події (бета)",{"node":322},{"id":323,"title":324},"439","Публічне API та API-ключі (бета)",{"node":326},{"id":327,"title":328},"281","Інтеграція OneB Invoice та OneB Finance",{"node":330},{"id":331,"name":332,"created_at":333,"articles_count":334,"edge_preview_articles":335},"58","Функціонал ",1707816481,1,{"edges":336},[337],{"node":338},{"id":339,"title":340},"402","Кабінет клієнта: що це, як увімкнути та як ним користуватися",{"node":342},{"id":343,"name":344,"created_at":345,"articles_count":346,"edge_preview_articles":347},"55","Зворотний зв'язок",1698401315,2,{"edges":348},[349,353],{"node":350},{"id":351,"title":352},"423","Часті питання: швидкі відповіді підтримки",{"node":354},{"id":355,"title":344},"133",{"edges":357},[],1791429733990]