Telegram-бота «Погода-Расписание»

📌 Шаг 1: Создание бота через BotFather

BotFather — официальный бот для создания ботов в Telegram.

1. 🔍 Найдите в Telegram @BotFather (синяя галочка).

2. ▶️ Запустите бота командой /start.

3. 🆕 Создайте нового бота командой /newbot.

4. 📝 Ответьте на вопросы:

   • Bot name: Погода в Доме | Расписание (это имя увидят пользователи).

   • Имя пользователя: PogodaVRaspisaniiBot (должен оканчиваться на bot и быть уникальным).

5. 🔑 Сохраните токен API!
   BotFather выдаст вам строку вида:
   6123456789:AAHdR8HrSfW3eMc9eBcD2qQpLmNoPSTuvwx
   → ЭТО ВАШ СЕКРЕТНЫЙ КЛЮЧ! Никому не показывайте.

📅 Шаг 2: Настройка доступа к Яндекс.Календарю

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

1. Убедитесь, что ваш календарь «Погода в Доме» публичный (Урок 2.1, Шаг 4).

2. Скопируйте ID календаря:

   • Откройте календарь в браузере.

   • Посмотрите на URL. ID будет в адресе:
     https://calendar.yandex.ru/calendar/**user_id**/ключ_календаря

   • Вам нужна часть user_id. Например: 1234567890.

💻 Шаг 3: Выбор платформы для кода бота

Вам не нужно быть программистом! Используем бесплатные конструкторы.

🥇 Рекомендация: Manybot (самый простой)

1. 🔍 Найдите в Telegram @Manybot.

2. ▶️ Запустите и нажмите «Создать бота».

3. 🔑 Введите токен API из Шага 1.

4. Перейдите в «Панель управления» → «Команды».

https://img.icons8.com/color/96/000000/settings-3.png Иконка: Панель управления

⚙️ Шаг 4: Настройка команды /расписание в Manybot

Теперь «оживим» команду.

1. Создайте новую команду:

   • Триггер: /расписание

   • Описание: Показать актуальные события Клуба

   • Тип ответа: HTTP-запрос (API)

2. Настройте HTTP-запрос для получения данных из Яндекс.Календаря:

   • Метод: GET

   • URL: Вставьте этот URL, заменив [USER_ID] на ваш ID из Шага 2:

     text

     https://calendar.yandex.ru/export/[USER_ID].ics

     Пример: https://calendar.yandex.ru/export/1234567890.ics

3. Обработка ответа (Важно!):

   • Manybot получит файл .ics — это текстовый формат календаря.

   • В разделе «Обработка ответа» выберите «Пользовательский обработчик».

   • Вставьте этот JavaScript-код, который преобразует сырые данные в красивое сообщение:

   javascript

   // Конвертер ICS в читаемый текст для Manybot
   function parseICS(data) {
     const events = [];
     const lines = data.split('\n');
     let currentEvent = {};
     
     for (let line of lines) {
       if (line.startsWith('BEGIN:VEVENT')) {
         currentEvent = {};
       } else if (line.startsWith('SUMMARY:')) {
         currentEvent.title = line.replace('SUMMARY:', '').trim();
       } else if (line.startsWith('DTSTART:')) {
         const dateStr = line.replace('DTSTART:', '').trim();
         currentEvent.date = formatDate(dateStr);
       } else if (line.startsWith('DESCRIPTION:')) {
         currentEvent.desc = line.replace('DESCRIPTION:', '').trim()
           .replace(/\\n/g, '\n')
           .substring(0, 100) + '...';
       } else if (line.startsWith('END:VEVENT')) {
         if (currentEvent.title) {
           events.push(currentEvent);
         }
       }
     }
     
     // Фильтруем только будущие события (первые 5)
     const now = new Date();
     const futureEvents = events
       .filter(e => new Date(e.date) > now)
       .slice(0, 5);
     
     if (futureEvents.length === 0) {
       return '📭 Ближайших событий пока нет. Следи за анонсами!';
     }
     
     // Форматируем сообщение
     let message = '🗓 *Расписание Клуба "Погода в Доме":*\n\n';
     futureEvents.forEach((event, index) => {
       message += `*${index + 1}. ${event.title}*\n`;
       message += `📅 *Когда:* ${event.date}\n`;
       if (event.desc) message += `📝 ${event.desc}\n`;
       message += `────────────\n`;
     });
     
     message += '\n👉 *Подробности и регистрация:* /регистрация';
     return message;
   }
   
   function formatDate(dateStr) {
     // Преобразуем YYYYMMDDTHHmmss в читаемую дату
     const year = dateStr.substring(0, 4);
     const month = dateStr.substring(4, 6);
     const day = dateStr.substring(6, 8);
     const hour = dateStr.substring(9, 11) || '00';
     const minute = dateStr.substring(11, 13) || '00';
     
     const months = ['янв', 'фев', 'мар', 'апр', 'мая', 'июн', 
                    'июл', 'авг', 'сен', 'окт', 'ноя', 'дек'];
     
     return `${day} ${months[parseInt(month)-1]} ${year}, ${hour}:${minute}`;
   }
   
   // Manybot передает данные в переменную 'response'
   const result = parseICS(response);
   result;

4. Настройте клавиатуру:

   • Добавьте кнопки под сообщением:

     • 🗓️ Полное расписание (ссылка на ваш публичный календарь)

     • 📝 Записаться на событие (команда /запись)

     • 🏠 В главное меню

https://img.icons8.com/color/96/000000/code.png Иконка: Написание кода

🎨 Шаг 5: Дополнительные команды для бота

Добавьте в Manybot другие полезные команды:

🔄 Шаг 6: Тестирование и публикация

1. 🔍 Найдите своего бота по юзернейму (@PogodaVRaspisaniiBot).

2. ▶️ Запустите командой /start.

3. 📅 Протестируйте /расписание — должны получить список событий.

4. 📢 Опубликуйте бота:

   • Добавьте аватар через BotFather (/setuserpic).

   • Добавьте описание (/setdescription): «Официальный бот Клуба «Погода в Доме». Узнай расписание, запишись на события, получи полезные ссылки».

   • Включите встроенный режим (/setinline), чтобы бота можно было вызывать в любом чате.

https://img.icons8.com/color/96/000000/test-tube.png Иконка: Тестирование

🚀 Продвинутые возможности (когда клуб вырастет)

1. 📊 База данных событий: Используйте Google Sheets + App Script для более сложной логики.

2. 🤖 Автозапись: Интегрируйте с Google Forms — бот отправляет форму регистрации.

3. 🔔 Уведомления: Настройте еженедельную рассылку расписания через Manybot.

4. 💎 Платный доступ: Через бота можно принимать оплату за закрытые мероприятия.

✅ Практическое задание:

1. Создайте бота через @BotFather (до шага получения токена).

2. Настройте команду /start в Manybot с приветственным сообщением:

   «Привет! Я бот Клуба «Погода в Доме» 🌿
   Я покажу расписание событий, помогу записаться и отвечу на вопросы.

   📅 Доступные команды:
   /расписание — Актуальные события
   /правила — Правила клуба
   /ссылки — Все важные ссылки
   /помощь — Помощь по боту»

3. Добавьте кнопки под сообщением: «Расписание», «Правила», «Ссылки».

4. Пришлите скриншот работающего бота с командой /start.

📦 Готовое решение (для технических)

Если вы знакомы с Python, вот минимальный код для самостоятельного хостинга на PythonAnywhere (бесплатно):

import telebot
import requests
from ics import Calendar

bot = telebot.TeleBot("ВАШ_ТОКЕН")

@bot.message_handler(commands=['расписание'])
def send_schedule(message):
    ics_url = "https://calendar.yandex.ru/export/USER_ID.ics"
    response = requests.get(ics_url)
    
    cal = Calendar(response.text)
    events = list(cal.timeline)
    
    text = "🗓 *Ближайшие события:*\\n\\n"
    for event in events[:5]:
        text += f"*{event.name}*\\n"
        text += f"📅 {event.begin.format('DD MMM YYYY, HH:mm')}\\n\\n"
    
    bot.send_message(message.chat.id, text, parse_mode='Markdown')

bot.polling()

🎯 Итог: Ваш Клуб теперь имеет профессионального цифрового ассистента. Участники в любой момент получат актуальное расписание, а вы сэкономите время на ответах на типовые вопросы. Бот — это лицо вашего Клуба в Telegram!