Поширені питання та зрозумілі відповіді

Ні. Один Telegram-акаунт може керувати одним каналом зі СвітлоБотом.

Щоб зареєструвати інший канал у цьому ж акаунті, спочатку видаліть попередню систему через кнопку «Видалити» в меню @SvitloUkraineBot. Якщо обидва канали мають працювати одночасно, для другого потрібен інший Telegram-акаунт.

Орієнтовний час спрацювання:

• поява світла: 1–5 хвилин;
• зникнення світла через роутер: близько 5 хвилин;
• зникнення світла через смартфон або ESP: близько 4 хвилин.

Користувач не може змінити цей інтервал. Затримка допомагає системі не реагувати на дуже короткі перебої зв’язку або живлення.

Відкрийте меню @SvitloUkraineBot і натисніть кнопку «Видалити». Для підтвердження бот попросить вручну ввести слово «видалити».

1. У старому акаунті видаліть систему кнопкою «Видалити» в меню @SvitloUkraineBot.
2. З нового акаунта пройдіть реєстрацію в тому самому каналі.

Створювати новий канал не потрібно, тому всі підписники збережуться. Після повторної реєстрації канал знову потрапить у чергу на модерацію для відображення на мапі.

Так. Для одного каналу можна використовувати будь-яку комбінацію: до двох роутерів і до двох телефонів.

• якщо хоча б один пристрій відповідає — система вважає, що світло є 🟢;
• якщо не відповідає жоден — система вважає, що світла немає 🔴.

Зазвичай систему деактивують через порушення умов користування або некоректну роботу каналу. Серед можливих причин:

• змінено назву, логотип або канал зроблено приватним;
• з опису видалено посилання на сайт, мапу чи власника;
• змінено права бота;
• публікується реклама, комерційний, грубий або неприпустимий контент;
• канал довго неактивний або передає некоректні дані;
• IP заблоковано через надто часті запити.

Перед деактивацією власнику зазвичай надходить повідомлення з причиною. Після усунення проблеми систему можна видалити й зареєструвати в тому самому каналі повторно — підписники збережуться.

СвітлоБот має залишатися адміністратором каналу та мати права, які система запитує під час реєстрації. Зокрема, боту потрібна можливість:

• надсилати й редагувати повідомлення про стан світла;
• закріплювати та оновлювати графік;
• редагувати опис каналу, якщо це передбачено поточним налаштуванням системи.

Якщо бота вже видалили або канал деактивовано, перевірте меню чат-бота. За потреби видаліть систему через меню й зареєструйте її повторно в тому самому каналі.

Увімкніть тихий режим у @SvitloUkraineBot. У цьому режимі бот не публікує повідомлення 🔴/🟢, але:

• продовжує записувати стани в базу;
• оновлює тижневий графік;
• відображає актуальний стан на мапі.

Команди:

• /mutebot — переглянути поточний режим;
• /mutebot 1 — увімкнути тихий режим;
• /mutebot 0 — вимкнути тихий режим.

Це налаштування також доступне кнопкою в меню й відображається в тексті статусу каналу.

У Telegram можна увімкнути Direct Messages для каналу та використати посилання на Direct замість особистого профілю власника.

1. У налаштуваннях каналу увімкніть Direct Messages.
2. Встановіть вартість повідомлення 0 зірок.
3. В описі каналу вкажіть посилання на кшталт https://telegram.me/НАЗВА_КАНАЛУ?direct.

Якщо від імені каналу з’явилося нетипове повідомлення з кнопкою, зовнішнім посиланням, рекламою або збором коштів:

1. не натискайте кнопку й не відкривайте посилання;
2. видаліть підозрілий допис;
3. перевірте список адміністраторів і активні сесії Telegram;
4. переконайтеся, що права @SvitloUkraineBot не змінені;
5. повідомте @SvitloBotAdmin та попередьте підписників.

СвітлоБот — безкоштовний волонтерський проєкт. За бажанням його можна підтримати добровільним внеском на офіційну банку:

Підтримати СвітлоБот через monobank ↗

Допомогти також можна інформаційно: розповісти про проєкт сусідам, повідомляти про помилки та ділитися корисними інструкціями у спільноті.

Поточну зовнішню IP-адресу можна переглянути на 2ip.ua.

• Перевірка IP або DDNS через ping/traceroute;
• перевірка доступності порту, якщо використовується перенаправлення портів.

Перевірте найпоширеніші причини:

1. роутер вимкнений або пристрій переходить у режим сну;
2. вказана локальна, а не зовнішня IP-адреса;
3. провайдер блокує вхідні запити або використовує CGNAT;
4. на WAN-інтерфейсі роутера заборонено відповідати на ping;
5. використано непідтримуваний формат адреси.

Підтримуються формати DDNS, IP та IP:порт. Формат DDNS:порт не підтримується.

Система продовжує отримувати відповідь від адреси або пристрою, який ви налаштували. Перевірте:

1. чи справді вказані IP або DDNS належать вашому підключенню;
2. чи не відповідає за цією адресою інше обладнання;
3. чи не живиться контрольований пристрій від генератора, акумулятора, павербанка або ДБЖ.

За потреби додайте конкретний порт, наприклад ВАША_IP:80. Для тесту вимкніть роутер з розетки та перевірте адресу з мобільного інтернету: коли роутер вимкнений, має бути втрата пакетів.

Запити надходять від хоста ping.svitlobot.in.ua.

Постійну числову IP-адресу сервіс не публікує з міркувань безпеки. Якщо ви створюєте правило доступу, орієнтуйтеся на доменне ім’я, якщо ваше обладнання це підтримує.

СвітлоБот має перевіряти саме той пристрій, який вимикається разом із мережевим живленням: другий роутер, розумну розетку або інший доступний вузол.

• якщо пристрій доступний з інтернету, вкажіть його окрему IP-адресу або IP:порт;
• якщо обидва пристрої знаходяться за однією зовнішньою IP-адресою, налаштуйте перенаправлення окремого порту на пристрій без ДБЖ;
• на OpenWrt, MikroTik та інших програмованих роутерах можна самостійно надсилати API-запит до СвітлоБота.

Для конфігурацій без білої IP-адреси також є окрема практична інструкція від користувача спільноти ↗.

Якщо інтернет працює нормально, найімовірніше, провайдер змінив вашу зовнішню IP-адресу. Дізнайтеся поточну адресу й оновіть її в меню @SvitloUkraineBot.

Вбудований DDNS від TP-Link іноді тимчасово не відповідає на запити. СвітлоБот сприймає це як зникнення зв’язку, тому можуть виникати хибні повідомлення.

За можливості використайте інший DDNS-сервіс або перейдіть на варіант зі смартфоном, ESP-пристроєм чи самостійним API-запитом.

У спільноті є окрема покрокова інструкція для зв’язки MikroTik + розумна розетка. Вона пояснює, як використовувати пристрій без резервного живлення як індикатор наявності електрики.

Відкрити інструкцію для MikroTik ↗

На смартфон, який постійно підключений до енергозалежної розетки, потрібно встановити застосунок «Світлобот 2.0», надати потрібні дозволи та ввести унікальний ключ каналу.

Ключ можна переглянути кнопкою «Статус» у меню @SvitloUkraineBot.

Спочатку встановіть актуальний застосунок «Світлобот 2.0». Потім перевірте:

1. чи є інтернет на смартфоні;
2. чи має застосунок дозвіл на використання мережі;
3. чи правильно введено ключ каналу та чи немає зайвих пробілів;
4. чи завершено технічну перевірку каналу в @SvitloUkraineBot.

Причиною найчастіше є системне енергозбереження Android. Для застосунку «Світлобот 2.0»:

1. дозвольте роботу у фоні та використання мережі;
2. вимкніть оптимізацію батареї або встановіть режим «Без обмежень»;
3. увімкніть автозапуск, якщо така опція є;
4. закріпіть застосунок у списку останніх програм;
5. дозвольте Wi-Fi працювати під час сну.

Послідовно перевірте такі варіанти:

1. перенесіть телефон ближче до роутера;
2. вимкніть для застосунку всі обмеження фонової роботи та енергозбереження;
3. залиште телефон на зарядці з увімкненим екраном для тесту — якщо пінги стабілізуються, причина саме в системних обмеженнях;
4. якщо провайдер короткочасно втрачає інтернет, додайте SIM-картку з мінімальним пакетом мобільних даних;
5. за можливості протестуйте інший смартфон.

На Xiaomi/MIUI та нових версіях Android фонова задача може фактично запускатися раз на кілька хвилин, навіть якщо застосунок налаштований на одну хвилину.

Приклади команд, наведених у Telegram-інструкції:

adb shell dumpsys deviceidle disable
adb shell dumpsys battery unplug
adb shell dumpsys deviceidle whitelist +ІМʼЯ_ПАКЕТА
adb shell settings put global wifi_sleep_policy 2
adb shell cmd appops set ІМʼЯ_ПАКЕТА android:get_usage_stats allow

• «Світлобот 2.0» для Android у Google Play — основний варіант;
• попередня версія для дуже старих Android-пристроїв;
• APK-файли для встановлення без Google Play;
• застосунок для iOS.

Досвідчені користувачі також можуть надсилати API-запити через:

• Automate із готовим файлом налаштувань;
• MacroDroid у Google Play.

Пристрій має приблизно раз на хвилину викликати:

https://api.svitlobot.in.ua/channelPing?channel_key=ВАШ_КЛЮЧ

Статистику каналу у форматі HTML можна отримати за адресою:

https://api.svitlobot.in.ua/status?channel_key=ВАШ_КЛЮЧ

Унікальний ключ каналу доступний кнопкою «Статус» у @SvitloUkraineBot. Не публікуйте його у відкритому доступі.

Так. ESP32 може підключатися до Wi-Fi та регулярно надсилати channelPing із ключем вашого каналу. Пристрій потрібно живити від розетки, стан якої ви хочете контролювати.

Покрокова стаття про прошивку ESP32 ↗

Для власних пристроїв та автоматизацій доступний окремий endpoint:

https://api.svitlobot.in.ua/channelPingOff?channel_key=ВАШ_КЛЮЧ

Він одразу переводить систему в офлайн, не чекаючи стандартні 4–5 хвилин, і запускає надсилання повідомлення в канал.

Для повернення в онлайн продовжуйте надсилати звичайний channelPing із ключем каналу.

У меню @SvitloUkraineBot натисніть «Налаштувати розклад». Бот відкриє редактор, прив’язаний до вашого каналу.

Скористайтеся сумісним ботом @DtekSchedulePowerOutSenderBot (DSP-бот).

Він може:

• публікувати актуальний графік постачальника для багатьох регіонів України;
• оновлювати рядок СвітлоБота «Очікуємо о…» на сьогодні та завтра.

Для інтеграції потрібен ключ СвітлоБота, який можна переглянути кнопкою «Статус».

Це автоматичний обов’язковий графік фактичної роботи каналу — він допомагає оцінити якість і правдивість даних. Вимкнути його не можна.

• для нового каналу зображення зазвичай з’являється протягом двох годин;
• новий тижневий графік створюється в першу годину ночі понеділка й протягом тижня оновлюється без сповіщень;
• після завершення тижня графік перестає змінюватися;
• видалене повідомлення з графіком створюється повторно автоматично;
• планові періоди відображаються жовто-сірими зонами, а технічна перерва — блідо-синім кольором;
• у підсумках враховуються лише інтервали, для яких система отримувала фактичний сигнал.

Перед завершенням тижня власник сам вирішує, залишити чи видалити планові зони минулого тижня — для цього в меню є окрема кнопка.

Налаштування показу планових зон також доступне в меню як команда /chartwithplan; його поточне значення відображається у статусі каналу.

Відкрийте @SvitloUkraineBot і виконайте команду:

/showlastinterval

Бот покаже останній інтервал — пару логів початку й завершення — та запропонує видалити його. Після цього графік перемалюється автоматично; зазвичай він оновлюється раз на дві години.

• канал має працювати щонайменше 5 днів;
• видалити можна лише інтервал за останні 24 години.

Канали додаються на мапу після модерації та щонайменше кількох днів коректної роботи. Першими опрацьовуються канали з більшою кількістю підписників. У періоди великої черги пріоритет мають канали, які працюють понад тиждень і мають більше 30 підписників.

Канал може не пройти модерацію, якщо:

• адреса не існує або не знаходиться на мапі;
• є постійні хибні спрацьовування;
• контрольний пристрій працює від ДБЖ і не відображає реальну ситуацію;
• це особистий канал, дані якого не допомагають мешканцям поруч.

Якщо минуло понад сім днів і канал працює коректно, напишіть @SvitloBotAdmin. Додайте посилання на канал та його СвітлоБот ID.

Вимкніть згоду на відображення в меню @SvitloUkraineBot.

Можливі причини:

• власник вимкнув дозвіл на відображення;
• канал давав хибні спрацьовування або працював некоректно;
• статус світла тривалий час не змінювався;
• канал перебуває на технічній перерві понад 14 днів і тому автоматично прихований;
• систему заблоковано або деактивовано;
• особистий канал не відображає реальну картину відключень у будинку чи районі.

Перевірте статус у чат-боті. Якщо причина незрозуміла, зверніться до @SvitloBotAdmin і вкажіть посилання на канал або його унікальний ключ.

Це пов’язані адреси — будинки на одному електричному вводі, де світло зазвичай зникає та з’являється одночасно.

Налаштувати їх можуть адміністратори великих каналів — від 100 підписників — відповідною кнопкою в меню @SvitloUkraineBot.

• до трьох пов’язаних адрес;
• відстань — до 700 метрів від основної точки.

Якщо канал уже додано на мапу, в меню @SvitloUkraineBot доступна функція «Уточнити координати».

Вона дозволяє самостійно пересунути точку в радіусі до 200 метрів від поточного розташування. Якщо кнопки немає, оновіть меню: надішліть боту будь-яке повідомлення або натисніть «Статус».

Для швидкого завантаження дані мапи кешуються й оновлюються приблизно раз на 5 хвилин. Тому стан на мапі може з’явитися трохи пізніше, ніж повідомлення в Telegram-каналі.

• розмір маркера залежить від кількості підписників каналу;
• час останнього оновлення показується в інтерфейсі мапи;
• мапа запам’ятовує останнє положення та масштаб;
• у картці каналу є кнопка «Поділитися».

GGSWATCH — незалежна партнерська платформа, яка візуалізує стан мережі СвітлоБота та показує детальну статистику за регіонами України й районами Києва.

Відкрити ggswatch.com ↗

Так. Проєкт надає офіційний дозвіл і готовий код для безкоштовного некомерційного вбудовування інтерактивної мапи через iframe.

Умови використання, приклад коду й доступні варіанти мапи зібрані на сторінці Для партнерів.