Підключення Telegram до Elido

Elido надсилає сповіщення Telegram через бота, якого ви створюєте. Бот надсилає повідомлення в конкретний чат — або в особисті повідомлення (DM) з вами, або в групу. Ви володієте токеном бота; Elido зберігає його лише в зашифрованому вигляді.

Крок 1 — Створіть бота за допомогою BotFather#

1. Відкрийте Telegram і знайдіть @BotFather, або відкрийте https://t.me/BotFather.
2. Надішліть /newbot.
3. Дотримуйтесь підказок: виберіть відображуване ім'я, потім ім'я користувача (має закінчуватися на bot, наприклад AcmeElidoBot).
4. BotFather відповість вашим API-токеном. Він виглядає як 123456789:AABBccDD.... Скопіюйте його зараз — ви зможете отримати його пізніше за допомогою /mybots, але швидше скопіювати його одразу.

Крок 2 — Знайдіть свій ID чату#

Вам потрібен числовий ID чату, куди ви хочете надсилати повідомлення.

Для особистих повідомлень (тільки ви):

1. Надішліть будь-яке повідомлення своєму новому боту.

2. Відкрийте цю URL-адресу в браузері, замінивши TOKEN на ваш токен:

   https://api.telegram.org/botTOKEN/getUpdates
   

3. Знайдіть "chat":{"id":...} у відповіді. Це число — ваш ID чату. Зазвичай це додатне 9-значне ціле число для особистих чатів.

Для групи:

1. Додайте бота в групу.
2. Надішліть повідомлення в групі, згадавши бота через @ (наприклад, @AcmeElidoBot hello).
3. Відкрийте ту саму URL-адресу getUpdates, вказану вище. ID групових чатів — це від'ємні числа (наприклад, -1001234567890).

Крок 3 — Налаштуйте Elido#

1. Перейдіть у Settings → Notifications → Telegram → Add channel.
2. Вставте токен бота та ID чату.
3. Натисніть Save. Elido надішле тестове повідомлення. Очікуйте його в Telegram протягом 2 секунд.

Виберіть події#

Після підключення натисніть Configure events, щоб вибрати, які події активують повідомлення:

• threshold.exceeded — рекомендована початкова точка.
• scan.failed — відразу корисно для будь-якого посилання, пункт призначення якого ви не контролюєте.
• link.created — корисно для спільних робочих просторів, де ви хочете бачити нові посилання.

Видалення інтеграції#

Перейдіть у Settings → Notifications → Telegram → Remove. Це видалить токен бота з бази даних Elido. Опціонально відкличте самого бота в BotFather за допомогою /revoke.

Усунення несправностей#

"Unauthorized" у журналі доставки — Токен неправильний. Перевірте ще раз, вставивши цю URL-адресу в браузер:

https://api.telegram.org/botTOKEN/getMe

Якщо повертається {"ok":false,...}, токен недійсний.

"Chat not found" — ID чату неправильний, або бот не був доданий до групи. Для груп переконайтеся, що бот є учасником, і надішліть повідомлення зі згадкою бота перед викликом getUpdates.

Немає повідомлення після натискання Test — Перевірте getUpdates, щоб підтвердити, що бот отримав будь-яку взаємодію. Якщо відповідь порожня, Telegram ще не зафіксував жодного контакту між користувачем/групою та ботом.

Повідомлення в групі невидимі — У деяких групах Telegram увімкнено "повільний режим" або публікація дозволена лише адміністраторам. Зробіть бота адміністратором із дозволом "Post messages".