Настройка Telegram
Workflows Moira могут отправлять Telegram-уведомления на определённых шагах с помощью нод telegram-notification. Для этого нужен Telegram-бот и ваш chat ID.
Настройка
Заголовок раздела «Настройка»1. Создание бота через @BotFather
Заголовок раздела «1. Создание бота через @BotFather»- Откройте Telegram и найдите
@BotFather - Отправьте
/newbot - Выберите отображаемое имя (например, “My Moira Notifications”)
- Выберите username, оканчивающийся на
bot(например,my_moira_bot) - BotFather ответит токеном бота — скопируйте его (формат:
123456789:ABCdefGHIjklMNOpqrsTUVwxyz)
2. Получение Chat ID
Заголовок раздела «2. Получение Chat ID»Способ A — @userinfobot:
- Найдите
@userinfobotв Telegram - Отправьте любое сообщение
- Бот ответит вашим user ID — это и есть ваш chat ID
Способ B — Bot API:
- Отправьте любое сообщение вашему новому боту
- Откройте
https://api.telegram.org/bot<TOKEN>/getUpdatesв браузере - Найдите
"chat":{"id":XXXXXXX}— это число и есть ваш chat ID
3. Сохранение настроек
Заголовок раздела «3. Сохранение настроек»- Откройте Moira и перейдите в Settings
- Нажмите на вкладку Telegram
- Введите Bot Token в соответствующее поле
- Введите Chat ID в соответствующее поле
- Убедитесь что Enabled включён
- Нажмите Save для каждой настройки
4. Отправка тестового уведомления
Заголовок раздела «4. Отправка тестового уведомления»На той же вкладке Telegram в Settings нажмите Test Notification. Вы должны получить сообщение от бота в Telegram.
Настройка через агента
Заголовок раздела «Настройка через агента»При использовании Moira через MCP-клиент (Claude Code, Claude Desktop) можно запустить пошаговый workflow настройки:
start({ workflowId: "moira/telegram-setup", parentExecutionId: "none" })Workflow проведёт через создание бота, получение chat ID, сохранение настроек и отправку тестового уведомления.
Решение проблем
Заголовок раздела «Решение проблем»Ошибка “Chat not found”
Заголовок раздела «Ошибка “Chat not found”»Бот не может отправлять сообщения пока вы не напишете ему первым. Откройте Telegram, найдите бота, отправьте любой текст (например, “hello”), затем повторите попытку.
Ошибка “Invalid token”
Заголовок раздела «Ошибка “Invalid token”»Токен бота неверный или истёк. Перейдите к @BotFather, отправьте /mybots, выберите бота и проверьте токен. При необходимости сгенерируйте новый.
”Network error” или “Timeout”
Заголовок раздела «”Network error” или “Timeout”»Временная проблема с подключением. Подождите и повторите. Если проблема сохраняется, проверьте что сервер Moira может обращаться к api.telegram.org.
Бот не отвечает
Заголовок раздела «Бот не отвечает»Боты, созданные через @BotFather, по умолчанию не отвечают на сообщения. Они отправляют уведомления только когда Moira запускает ноду telegram-notification. Это ожидаемое поведение.
Уведомление не получено
Заголовок раздела «Уведомление не получено»- Убедитесь что вы отправили сообщение боту (требование Telegram API)
- Проверьте правильность chat ID (используйте @userinfobot для подтверждения)
- Проверьте что Telegram включён в Settings > вкладка Telegram
- Проверьте что токен бота не был отозван