Що ви налаштуєте
- Бота Telegram, створеного через BotFather: токен належить вам, Elido зберігає його в зашифрованому вигляді.
- Числовий ID вашого чату, чи то особисті повідомлення, чи група (включно із супергрупами з префіксом
-100). - Налаштування за подіями для сповіщень про посилання, домени та ліміти використання.
Elido надсилає сповіщення в Telegram через бота, якого створюєте ви. Бот надсилає повідомлення в конкретний чат: особисту розмову з вами або групу. Токен бота належить вам; Elido лише зберігає його в зашифрованому вигляді.
Крок 1. Створіть бота через BotFather
- Відкрийте Telegram і знайдіть
@BotFatherабо відкрийтеhttps://t.me/BotFather. - Надішліть
/newbot. - Дотримуйтеся підказок: виберіть відображуване ім'я, потім ім'я користувача (має закінчуватися на
bot, наприкладAcmeElidoBot). - BotFather відповість вашим API-токеном. Він виглядає як
123456789:AABBccDD.... Скопіюйте його одразу: пізніше його можна отримати через/mybots, але простіше скопіювати заздалегідь.
Крок 2. Знайдіть ID чату
Вам потрібен числовий ID чату, у який мають надходити повідомлення.
Для особистих повідомлень (лише вам):
-
Надішліть будь-яке повідомлення вашому новому боту.
-
Відкрийте цей URL у браузері, замінивши
TOKENсвоїм токеном:https://api.telegram.org/botTOKEN/getUpdates -
Знайдіть у відповіді
"chat":{"id":...}. Це число і є ID вашого чату. Для особистих чатів це зазвичай додатне 9-значне ціле число.
Для групи:
- Додайте бота до групи.
- Надішліть у групі повідомлення зі згадкою бота (наприклад,
@AcmeElidoBot hello). - Відкрийте той самий URL
getUpdates. ID групових чатів - від'ємні числа (наприклад,-1001234567890).
Крок 3. Налаштуйте Elido
- Відкрийте Налаштування → Сповіщення → Telegram → Додати канал.
- Вставте токен бота та ID чату.
- Натисніть Зберегти. Elido надішле тестове повідомлення. Воно має надійти в Telegram протягом 2 секунд.
Виберіть події
Після підключення натисніть Налаштувати події, щоб вибрати, які події надсилають повідомлення:
link.broken- рекомендована відправна точка: монітор зламаних посилань виявив призначення, що перестало працювати.usage.threshold_80таusage.threshold_100- робочий простір використав 80% або 100% квоти тарифу.link.expiredтаlink.cap_reached- посилання прострочилося або досягло ліміту кліків.link.created- корисно для спільних робочих просторів, де потрібно бачити нові посилання.domain.verifiedтаdomain.ssl_failed- статус користувацького домену.
Повний перелік типів подій наведено в посібнику з вебхуків.
Видалення інтеграції
Відкрийте Налаштування → Сповіщення → Telegram → Видалити. Токен бота буде видалено з бази даних Elido. За бажанням відкличте самого бота в BotFather командою /revoke.
Усунення несправностей
«Unauthorized» у журналі доставки - Токен неправильний. Перевірте ще раз, вставивши в браузер:
https://api.telegram.org/botTOKEN/getMe
Якщо відповідь {"ok":false,...}, токен недійсний.
«Chat not found» - ID чату неправильний, або бота так і не додали до групи. Для груп переконайтеся, що бот є її учасником, і надішліть повідомлення з його згадкою перед викликом getUpdates.
Після натискання «Тест» повідомлення немає - Перевірте getUpdates, щоб переконатися, що бот отримав бодай якусь взаємодію. Якщо відповідь порожня, Telegram ще не зафіксував контакту між користувачем/групою та ботом.
Повідомлення в групі не видно - У деяких групах Telegram увімкнено «повільний режим» або публікувати можуть лише адміністратори. Зробіть бота адміністратором із дозволом «Публікація повідомлень».