Переносьте правила й усувайте проблеми

Керуйте своїми правилами

У чаті швидко накопичуються корисні правила: матеріали курсу, оплата, вакансії та команди кураторів. Розберімося, як упорядкувати їх, вимкнути непотрібне й перенести налаштування до наступної групи курсу.

Знайти, вимкнути, скопіювати чи видалити

У списку видно правила та стислий опис їхніх дій. Знайдіть, наприклад, «оплата» або звузьте список фільтрами Усі, Тригери, Команди та Проблеми.

Вимкнути. Курс завершився? Вимкніть його інформаційне правило. Налаштування збережуться, і згодом правило можна буде знову ввімкнути.

Вимкнути лише одну альтернативу АБО. Припустімо, відповідь про оплату досі потрібна в Підтримці, але тимчасово не потрібна в Запитаннях новачків. Вимкніть цю альтернативу. Основна умова та інші ввімкнені альтернативи працюватимуть далі, а ваш вибір збережеться після повторного відкриття правила.

Вимкнути все правило. Головний перемикач зупиняє і основну умову, і всі альтернативи АБО. Вимкнення однієї альтернативи не зупиняє все правило.

Копіювати. Уже є відповідь на PDF і потрібна схожа для іншого типу документа? Створіть копію, а потім перевірте назву, умови, команду, стан увімкнення та дії. Якщо залишити копію без змін, на один файл можуть відповісти обидва правила.

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

Перевірте налаштування

Перевірити перевіряє відкрите правило. Перевірити всі — увесь набір.

Можливо, ви створили винагороду за корисні відповіді, але забули ввімкнути XP. Або вибрали ще не підключений канал журналу. Усуньте ці проблеми, перш ніж вмикати правило.

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

Не ігноруйте попередження лише тому, що вдалося зберегти правило. Збережена відповідь мало допоможе, якщо бот не може надіслати її куди потрібно.

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

Після перевірки налаштувань випробуйте правило в Telegram. Наприклад, надішліть відповідний PDF і звичайне фото. Відповідь має з'явитися лише на PDF.

Чому правила можуть перетинатися

Уявімо, одне правило відповідає на «оплатити», а інше — на «як оплатити». Запитання «Як оплатити курс?» відповідає обом, тому людина може отримати дві відповіді.

Перевірка конфліктів шукає однакові умови; текст дії не має значення. Тож Без конфліктів не доводить, що схожі правила ніколи не перетнуться.

Особливо уважно перевіряйте повторні винагороди та протилежні рішення, наприклад коли одне правило схвалює заявку на вступ, а інше її відхиляє.

Експорт: зберегти чи передати налаштування

Перед початком нового курсу можна експортувати всі його правила або лише вибрані. Експорт — це набір налаштувань у форматі JSON. Для перенесення правил його не потрібно редагувати вручну.

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

Перед передаванням перевірте вміст: тексти й умови правил можуть містити приватні запрошення, ID учасників та посилання, які ви не хочете поширювати.

Імпорт: перенести правила до іншого чату

Запускаєте другу групу курсу? Відкрийте Імпортувати, вставте експортований набір і підтвердьте.

Імпорт додає правила до наявних. Він не замінює їх. Якщо імпортувати один набір двічі, можна отримати дві копії тієї самої відповіді.

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

Переносьте вимкнені правила або спершу випробуйте імпорт у тестовій групі. Імпорт не перетворює кожне правило на безпечну чернетку: він зберігає записаний стан увімкнення.

Після імпорту:

1. Знову виберіть теми-джерела та місця для відповідей.
2. Перевірте запрошення, вибраних користувачів і канал журналу.
3. Перевірте, чи виконуються дії разом, чи одна вибирається випадково. Також перевірте обов'язкові дії, позначені зірочкою Завжди.
4. Переконайтеся, що за потреби ввімкнено XP чи репутацію, а бот має потрібні права.
5. Перевірте налаштування.
6. Випробуйте одне правило на відповідному та невідповідному повідомленнях. Потім увімкніть решту.

Якщо ви вже користуєтеся старими тригерами

Старий тригер міг відповідати на «оплата» будь-де в чаті. В Автоматизації можна додати конкретну тему, робочі години та кілька способів поставити запитання. Для інших завдань є окремі події, умови щодо учасників, кілька дій і команди.

Переносьте правила поступово: відтворіть потрібну поведінку, перевірте її та вимкніть старий тригер-дублікат. Не вважайте експорт Triggers v2 готовим до імпорту набором у новому форматі.

Скільки правил і дій можна додати?

Для початку зазвичай достатньо одного-двох правил. Якщо готуєте великий набір для курсу чи кількох спільнот, спершу перевірте ліміти.

Збережені правила

На момент оновлення цього посібника діють такі ліміти:

• Free: до 2 окремих правил без додаткових альтернатив АБО для всього правила.
• Pro: до 50 правил, до 2 додаткових альтернатив АБО в кожному.
• Business: до 100 правил, до 5 додаткових альтернатив АБО в кожному.

Команда з матеріалами курсу й тригер із відповіддю про оплату — два окремі правила. Вимкнене правило досі займає місце: вимкнення не видаляє його. Альтернативи АБО містяться всередині правила й мають власний ліміт.

Налаштовані дії

Правило може містити до 100 рядків дій. Це зручно для варіантів відповіді: наприклад, 30 привітань, з яких під час кожного вступу випадково вибирається одне.

Один запуск допускає до 20 дій за лічильником редактора, позначеним як ліміт дій Telegram API. Рядок налаштувань і зарахована дія — не завжди те саме: надсилання відповіді до трьох тем рахується як три.

Кілька прикладів допоможуть розібратися:

• Надіслати інформаційне повідомлення до однієї теми: 1.
• Надіслати його до трьох тем: 3.
• Надіслати його до трьох тем з очищенням попередньої відповіді: 6 — три надсилання і три місця для очищення. Очищення враховується навіть під час першого запуску, коли попередніх відповідей ще немає.
• Попередити одного учасника й надіслати пояснення без очищення: 2.
• Додати 25 XP: 0 у цьому розрахунку, хоча рядок дії враховується в ліміті 100 рядків.

Інші дії рахуються так:

• Видати чи зняти попередження, обмежити, зняти обмеження або видалити повідомлення учасника: 1 на кожного вибраного учасника, відомого боту. Обидва може рахуватися як 2.
• Видалити повідомлення події, схвалити чи відхилити заявку на вступ: по 1.
• Змінити репутацію, як і XP: 0 у цьому розрахунку.

Усі дії враховує весь список. Одна випадкова — усі обов'язкові дії та найдорожчий можливий випадковий вибір. Редактор не припускає, що завжди випадатиме найдешевше надсилання.

Окремого обмеження «щонайбільше п'ять надсилань» немає. Простий список без очищення та інших витрат може містити 20 надсилань. Це не гарантує доставку кожного повідомлення: права бота й обмеження Telegram усе одно діють.

Коли наступна дія не вкладається в ліміт

Бот рахує повну вартість дії перед її виконанням. Якщо вона не вкладається, не виконується ні ця дія, ні решта списку. Уже виконані дії не скасовуються.

Наприклад, одна дія з надсиланням до 21 теми не скоротиться до перших 20. Невдала спроба виконати дію теж займає виділене їй місце.

Бюджет 20 дій стосується одного запуску одного правила. Це не спільний добовий ліміт чату чи всіх його правил.

Лічильник допомагає спланувати правило, а не підраховує кожен запит бота до Telegram. Попередження може додатково запустити покарання з налаштувань чату, а очищення історії повідомлень — потребувати кількох запитів. Тому фактична кількість запитів до Telegram може перевищувати 20.

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

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

Коли результат не такий, як очікували

Почніть з одного конкретного прикладу: що людина написала, де саме й на яку відповідь ви очікували. Так легше знайти зайву умову, ніж змінювати всі налаштування одразу.

Правило збережене, але бот мовчить

Можливо, ви завантажили PDF, а правило очікує звичайний текст. Або запитання надійшло у Вільному спілкуванні, а правило обмежене Підтримкою.

Перевірте стан увімкнення, чат, подію та умови. Якщо повідомлення відповідає лише одній альтернативі АБО, переконайтеся, що вона теж увімкнена. У тестовій групі залиште одну просту умову та одну відповідь, потім повертайте решту налаштувань по одному. Якщо створюєте копію в тому самому чаті, вимкніть оригінал на час перевірки.

Уже 10:00, але повідомлення не з'явилося

В Автоматизації розклад означає «обробляти відповідні події в ці години», а не «надіслати повідомлення о десятій ранку».

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

Людина знову отримала винагороду

Два модератори могли відповісти командою /reward_member на те саме корисне повідомлення. Це два виклики, і винагорода може нарахуватися двічі.

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

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

Реакцію додали, але результат несподіваний

Ілля мав 👍, додав ❤️, і умова на 👍 знову спрацювала. Правило перевіряє реакції, що залишилися після зміни. 👍 досі серед них.

Перевірте напрям зміни та вибрані емодзі. Фільтр конкретних емодзі потребує напряму додавання. Для кількості реакцій перевірте суму вибраних типів: оновлення з 20 і 21 реакцією можуть обидва відповідати мінімуму 20. Нуль або порожнє поле не задає межу діапазону.

На одне запитання надходять дві однакові відповіді

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

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

Попередження отримав модератор

Ймовірно, дія спрямована на автора команди, а не на людину в повідомленні, на яке відповіли. У прикладі Анни та Іллі виберіть Іллю — автора повідомлення, на яке відповіла Анна.

Перевірте режим Повідомлення у відповіді, справжню відповідь у Telegram та Застосувати до у кожній дії. Видалення повідомлення події все одно видаляє команду, а не початкове повідомлення Іллі.

Моя власна команда не виконується

Можливо, команду потрібно надіслати відповіддю, а ви надіслали її окремо. Або ви не належите до групи, вибраної в полі Ініціатор.

Перевірте написання, дозволених користувачів і спосіб виклику. Переконайтеся, що ви справді створили команду в редакторі та її назву ще не обробляє вбудована команда.

Пояснення надійшло, але повідомлення не видалено

Відповідь не доводить успішність інших дій. Бот може мати право надсилати повідомлення, але не видаляти їх.

Перевірте права Combot і статус учасника. Правило не обходить обмеження Telegram, особливо щодо адміністраторів. Якщо правило містить повідомлення, попередження та обмеження листування, перевірте кожне окремо.

Виконалася лише перша частина списку дій

Правило з кількома надсиланнями до різних тем і очищенням для кожного витрачає бюджет швидше, ніж може здатися за кількістю рядків.

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

XP чи репутація не збільшилися

Можливо, ви додали винагороду, ще не ввімкнувши XP у новому чаті курсу. Перевірте функцію, отримувача та ненульову цілочисельну зміну. 25 означає «додати 25», а не «установити загальне значення 25».

Для команди подяки тому, хто запросив, відповідайте на повідомлення цієї людини. Якщо винагорода натомість спирається на заявку на вступ за посиланням, перевірте, чи є посилання в каталозі Combot і чи відомий його автор. Невідомого отримувача не замінює новачок.

Правило спрацювало на людину, яку ви не вважаєте новачком

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

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

Час від вступу рахується не так, як ви очікували

Ілля вступив учора о 23:50. Сьогодні о 00:10 він усе ще в чаті лише двадцять хвилин: перехід через північ не додав добу.

Перевірте одиниці та порівняння. Місяць тут означає 30 діб. Старі правила можуть рахувати повні минулі доби, тоді як явно вибрана одиниця використовує точну тривалість. Якщо потрібне Дорівнює, переконайтеся, що старе налаштування не залишило Щонайменше.

Посилання не вважається зовнішнім

Можливо, ви вибрали запрошення на відкрите заняття й очікуєте, що решта посилань будуть зовнішніми. Але інше посилання теж може бути записане в каталозі Combot цього чату.

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

Список завдань змінився, а сповіщення немає

Переконайтеся, що скопіювали посилання на сам список завдань, а не на службове повідомлення про його оновлення. Посилання з ?comment=… не підходить; потрібне пряме посилання на повідомлення в чаті.

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

Перевірка мови, біографії чи файлу не спрацювала

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

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

Відповідь з'явилася не в тій темі

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

Після імпорту виберіть теми знову. Якщо відповідь з'явилася в кількох місцях, перевірте список призначень: вона надсилається до кожної вибраної теми. Для повідомлень журналу потрібні ID тем у місці призначення журналу, а не в групі-джерелі.

Старі відповіді бота залишаються

Очищення може бути ввімкнене для правила, але дія надсилання явно вказує не видаляти. Вибір на рівні дії має пріоритет.

Перевірте налаштування й знову запустіть правило: очищення відбувається з наступним надсиланням, а не за таймером. Кожна дія та кожна тема відстежують власну попередню відповідь. У випадковому наборі привітання Б не обов'язково видаляє привітання А. Старіші повідомлення без чіткого зв'язку також можуть залишитися.

Обкладинка курсу не з'являється

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

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

Редактор показує Конфліктів немає, але правила перетинаються

Він шукає однакові умови. «Оплатити» та «як оплатити» записані по-різному, але можуть трапитися в одному запитанні.

Випробуйте обидва правила на тому самому повідомленні. Якщо потрібна одна спільна відповідь, одне правило з альтернативами АБО може бути зручнішим за дві незалежні відповіді.

Не вдається додати ще одне правило

Вимкнене правило торішнього курсу досі займає місце. Перевірте ліміт тарифу й кількість збережених правил, зокрема вимкнених та імпортованих копій.

Перед видаленням експортуйте непотрібний набір, якщо він ще може знадобитися.

Коротка перевірка перед запуском

Для відповіді про оплату список перевірок може бути таким:

1. «Як оплатити курс?» у Підтримці отримує потрібну відповідь.
2. «Як змінити пароль?» там само не отримує відповіді про оплату.
3. Те саме запитання про оплату у Вільному спілкуванні не отримує відповіді, якщо вибрана лише Підтримка.
4. Повідомлення від виключеного адміністратора не відповідає жодній альтернативі, де задано цей виняток.
5. Повідомлення в робочі та неробочі години отримують відповідні заплановані відповіді.
6. Повторне запитання не створює небажаних винагород або зайвих повідомлень.

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

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

Якщо потрібна допомога зі сценарієм, запитайте в чаті підтримки Combot. Покажіть налаштування й поясніть очікуваний результат, але приховайте приватні запрошення та зайві відомості про учасників.

Нехай повторних пояснень буде менше, а часу на саму розмову — більше!