Подключение Telegram к Elido

Что вы настроите

Бота 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 включён «медленный режим» или публиковать могут только администраторы. Сделайте бота администратором с разрешением «Публикация сообщений».

Это было полезно?

Нужно больше? Напишите команде - ответ в течение одного рабочего дня.Связаться с поддержкой