Як додати інтеграцію з Telegram у KSeFGPT?
Введіть токен бота й ID чату, надішліть тестове повідомлення та збережіть активне з'єднання для вибраної компанії.
- Модуль
- Інтеграції
- Час читання
- 4 хв
- Рівень складності
- Ви зробите це із заплющеними очима :)
- Опубліковано
- 26 серпня 2026
- Автор
- Rafał Zeidler
- Формат
- Текстова інструкція та відео
Письмова процедура
Що ви зробите
Ви додасте з'єднання Telegram до вибраної компанії у KSeFGPT. Перед збереженням перевірите бота й надішлете одне тестове повідомлення. Наприкінці картка інтеграції матиме статус Активна.
Токен дає змогу керувати ботом, тому поводьтеся з ним як із паролем. Не показуйте його на знімках екрана, у документах або зверненнях до служби підтримки.
Вимоги
Перш ніж почати
Підготуйте бота, створеного через @BotFather, і цільовий чат. Додайте бота до цього чату перед тестом, оскільки KSeFGPT надішле туди справжнє повідомлення.
| Елемент | Опис |
|---|---|
| Доступ | Власник компанії або учасник організації з дозволом integrations:manage. |
| Тариф | Тариф KSeFGPT з увімкненим модулем Автоматизація та Інтеграції. |
| Дані Telegram | Токен бота від @BotFather та ID групи, каналу або користувача, наприклад -1001234567890. |
| Початкова точка | Після входу відкрийте Автоматизація, а потім Інтеграції. |
| Час виконання | Близько 3 хвилин. |
| Результат тесту | Натискання Перевірити з'єднання одразу надсилає одне повідомлення до вказаного чату Telegram. |
Відео процесу
Запис показує вибір Telegram, введення токена бота й ID чату, тестове повідомлення та збереження активної інтеграції.
Відкрийте інтеграції
У бічному меню виберіть Автоматизація, а потім Інтеграції. Натисніть Додати інтеграцію. Цей напис також використовується, коли список ще порожній.
Має відкритися вікно з доступними типами інтеграцій.
Виберіть Telegram
У вікні Додати інтеграцію виберіть Telegram. Картка описує з'єднання для надсилання сповіщень через Telegram-бота.
Після вибору з'явиться форма Налаштувати Telegram.
Введіть дані бота й чату
У полі Назва введіть зрозумілу назву інтеграції. У поле Токен бота вставте значення від @BotFather, а в полі ID чату вкажіть ідентифікатор одержувача повідомлення.
Токен має вигляд `123456:ABC-DEF...`. Ідентифікатор групи або каналу зазвичай починається зі знака мінус.
Перевірте з'єднання
Натисніть Перевірити з'єднання. KSeFGPT спочатку перевірить токен, а потім надішле тестове повідомлення до вказаного чату.
Дочекайтеся зелених підтверджень Підключено до бота та Тестове повідомлення надіслано в чат. Також перевірте, чи повідомлення надійшло правильному одержувачу в Telegram.
Збережіть інтеграцію
Натисніть Зберегти. Після збереження вікно закриється, а список інтеграцій оновиться автоматично.
Нова картка має показувати введену назву, тип Telegram і статус Активна. З картки можна знову виконати тест, змінити дані або видалити з'єднання.
Кінцевий стан
Перевірте результат
Інтеграція готова, коли тестове повідомлення є у вказаному чаті Telegram, а картка з'єднання у KSeFGPT має статус Активна.
Якщо токен став відомий стороннім особам, скасуйте його через @BotFather і збережіть новий токен у редакторі інтеграції.
Діагностика
Якщо щось не працює
Порівняйте видимий симптом із таблицею нижче.
| Симптом | Імовірна причина | Що зробити |
|---|---|---|
| Перевірити з'єднання неактивна | Поле Токен бота порожнє. | Вставте повний токен, отриманий від @BotFather. |
| Зберегти неактивна | Не вказано назву інтеграції, токен бота або ID чату. | Заповніть усі три обов'язкові поля. |
| Неправильний формат токена бота | Токен не містить числової частини, двокрапки й секретного рядка. | Скопіюйте токен із розмови з @BotFather ще раз. |
| Не вдалося перевірити бота | Токен неправильний, прострочений або скасований. | Перевірте токен або створіть новий через @BotFather і повторіть тест. |
| Бот існує, але не може надіслати повідомлення | ID чату неправильний або бота не додано до вказаного чату. | Перевірте ID чату, додайте бота й повторіть тест. |
| Не вдається зберегти інтеграцію | Немає дозволу integrations:manage або запит збереження завершився помилкою. | Попросіть власника організації надати потрібний дозвіл і спробуйте ще раз. |
Що далі
У редакторі автоматизації додайте блок сповіщення Telegram і виберіть збережену інтеграцію.
Після зміни токена або ID чату знову перевірте з'єднання перед запуском робочого процесу у виробничому середовищі.
Додайте інтеграцію з Telegram
Увійдіть, перевірте бота й збережіть з'єднання для вибраної компанії.
Пов’язані інструкції
Як додати інтеграцію зі Slack у KSeFGPT?
Введіть URL incoming webhook та необов'язковий канал, надішліть тестове повідомлення і збережіть активне з'єднання для вибраної компанії.
Як отримати рахунки з Fakturownia.pl і надіслати їх безпосередньо до KSeF?
Отримайте рахунки продажу через збережену інтеграцію, виберіть потрібні документи та надішліть їх до KSeF без завантаження й ручного додавання XML-файлів.
Як додати інтеграцію з Fakturownia.pl?
Підключіть обліковий запис Fakturownia.pl до вибраної компанії у KSeFGPT, перевірте дані доступу та збережіть активну інтеграцію. Вам знадобляться субдомен облікового запису й токен API з Fakturownia.