> For the complete documentation index, see [llms.txt](https://book.microcrm.online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.microcrm.online/changelog/1.2.1.md). # 1.2.1 Минорное обновление: переименовали два путающих раздела, починили глобального ИИ-помощника, прокачали узлы YouTube — теперь субтитры работают и на чужих видео, добавили рефералки и UTM-метки в команды бота, и десятки UX-улучшений. *** ## **Добавлено** ### **1. Узлы YouTube — 6 новых узлов в конструкторе** Подключили полноценную работу с YouTube через интеграцию Google. Каждая компания подключает свои Google Cloud credentials в разделе «Интеграции» и получает свою независимую квоту YouTube Data API (10 000 единиц в день, своя на каждую компанию). В палитре конструктора узлы заблокированы до тех пор, пока YouTube не включён в интеграции — после подключения становятся доступны 6 узлов: * **Поиск.** Находит видео, каналы или плейлисты по поисковому запросу. Можно фильтровать по конкретному каналу, выбирать тип (Видео / Каналы / Плейлисты), сортировку (релевантность, дата, просмотры, рейтинг, алфавит) и количество результатов от 1 до 50. Результат — массив с заголовками, описаниями, превью и метаданными. Запросы кешируются на сутки, поэтому повторный одинаковый поиск не сжигает квоту. * **Инфо о видео.** Полная информация о видео по ссылке или ID. Поддерживает все форматы ссылок YouTube (короткие, обычные, Shorts, или просто 11-символьный ID). В ответе — название, описание, канал, дата публикации, длительность, превью, число просмотров / лайков / комментариев, теги, категория. Удобно подавать в ИИ-агента «расскажи о чём видео» или сохранять данные о популярном видео в карточку клиента. * **Аналитика канала.** Сводка по подключённому каналу за выбранный период (от 1 до 30 дней). Показывает подписчиков, общие просмотры за всё время, число видео, метрики последних 10 видео и сводку за период (просмотры, время просмотра, средняя длительность, прирост / отток подписчиков). Идеально передаётся в ИИ-агент: типовой сценарий «каждый понедельник в 9 утра — взять аналитику — попросить ИИ дать 5 рекомендаций по контенту — отправить уведомление в колокольчик» работает в 4 узла. * **Редактировать видео.** Изменяет метаданные собственного видео (где OAuth-аккаунт владеет каналом). В редакторе узла есть выпадающий список последних 30 видео канала — выбираете нужное, поля автоматически заполняются текущими значениями, дальше можно править только то, что нужно (заголовок, описание, теги). Незаполненные поля не трогаются. * **Сменить обложку.** Загружает кастомную обложку для собственного видео из URL изображения (JPEG / PNG до 2 МБ). Поддерживает переменные сценария — например, можно автоматически устанавливать обложку, сгенерированную узлом nano-banana, на новое видео сразу после его загрузки. * **Субтитры.** Получает текст субтитров с любого публичного YouTube-видео — можно передать в ИИ-агента для саммари, перевода, поиска по содержимому, генерации цитат. Подробнее про этот узел — в пункте 2 ниже. В карточке Google-интеграции в настройках появился live-счётчик использованной квоты за сегодня с разбивкой по операциям — видно, сколько единиц съело редактирование, сколько — поиск, и так далее. Когда квота на исходе, видно заранее. ИИ-помощник конструктора (нижняя правая фиолетовая иконка) знает про все 6 узлов и про типовые сценарии — попросите его «сделай саммари видео по ссылке которую пришлёт пользователь» или «каждую неделю давай мне рекомендации по моему каналу» и он соберёт сценарий сам. *** ## Изменено *** ### **1. Понятные названия разделов знаний** «База знаний» → **«Справочник»**, «RAG-пространство» → **«AI-база знаний»**. Раньше пользователи путались: оба раздела про «знания», но работают по-разному. Теперь имена явно отражают назначение: * **Справочник** — для FAQ, прайсов, расписаний, таблиц данных. Содержимое целиком уходит в ИИ-помощника. * **AI-база знаний** — для больших документов (PDF, DOCX), по которым ИИ ищет ответ через семантический поиск. В палитре конструктора узел называется «AI-база знаний (RAG)» — для опытных пользователей пометка «(RAG)» сохранена, чтобы понимать, что речь именно про векторный поиск по документам. Старые ссылки и закладки на раздел «База знаний» автоматически переадресуются на новый адрес — ничего не сломается. *** ### **2. Узел «YouTube: Субтитры» — работает на любых видео** Подробнее про сам узел — см. пункт 1 раздела «Добавлено». Здесь — что было дополнительно сделано в течение релиза. Изначально субтитры можно было получать только через официальный API Google — это работало 100% для своих видео (где OAuth-аккаунт владеет каналом), но для чужих API возвращало 403, и узел падал. Дальше попробовали несколько способов получать субтитры с чужих видео без расхода квоты — Google активно блокирует server-side получение субтитров через свои API и через прямой парсинг страницы. В итоге узел работает в двух режимах: * **Для своих видео** — официальный API Google (стабильно, контракт Google, расход квоты 250 единиц на видео) * **Для чужих видео** — публичный путь через сторонний сервис (стабильно, без расхода квоты Google) В редакторе узла галочка «Сначала пробовать официальный API» — оставляйте включённой для своих видео и выключайте для чужих, чтобы не сжечь 250 единиц квоты на 403-ответ от Google. Если включена и видео чужое — узел сам поймёт это по ответу 403 и автоматически перейдёт на публичный путь. Ответ узла приходит в виде структурированных данных: полный текст одной строкой плюс массив сегментов с таймкодами для синхронизации с моментами видео. В тестере сценария он рендерится в красивом коллапсном блоке с кнопкой «Копировать JSON» (см. пункт 7 ниже). *** ### **3. Триггер «Команда» — поддержка реферальных ссылок** Telegram и MAX позволяют запустить бота по ссылке вида `t.me/bot?start=ref123` — это удобно для рефералок, UTM-меток рекламных кампаний и одноразовых токенов. Раньше бот игнорировал хвост после команды. Теперь после срабатывания триггера хвост автоматически попадает в две переменные сценария: * одна — сырой текст (например, «ref123») * вторая — то же, но с URL-декодом Эти переменные сразу видны в пикере переменных всех нижестоящих узлов — можно сохранять в карточку клиента, отправлять в API, фильтровать в условиях, и так далее. В редакторе триггера добавили подсказку с примером ссылки. *** ## Исправлено *** ### **4. Глобальный ИИ-помощник — починили молчание** Помощник в правом нижнем углу больше не отвечает «Не получил содержательного ответа от ИИ. Попробуйте переформулировать вопрос». Теперь он реально отвечает на ваш вопрос — про баланс, тариф, задачи, клиентов. *** ### **5. Глобальный ИИ-помощник — кнопка закрыть на мобиле** На мобильных устройствах помощник открывался на весь экран, а закрыть его было нечем. Добавили кнопку «×» в шапке рядом с кнопкой очистки истории — теперь видна и на телефоне, и на ПК. *** ### **6. Глобальный ИИ-помощник — индикатор больше не висит** После того как помощник дал финальный ответ, серая плашка «Обрабатываю результаты…» продолжала висеть ещё пару секунд. Теперь она пропадает сразу при появлении ответа. *** ## Улучшено *** ### **7. JSON-ответы в тестере сценариев** В режиме тестирования сценария если узел вернул ответ в формате JSON (например, узел «Субтитры» с массивом сегментов или HTTP-запрос с JSON-ответом) — теперь ответ рендерится в моноширинном блоке кода с подсветкой, отступами и кнопкой «Копировать JSON» в правом верхнем углу. Высота блока ограничена, длинные ответы не раздувают чат — они листаются скроллом внутри блока. Раньше JSON выводился простыней текста и портил читаемость. *** ### **8. Чат конструктора — текст пользовательских сообщений теперь яркий** В чате конструктора (где вы общаетесь с ИИ-помощником при создании сценария) ваши сообщения отображались блёклым серым шрифтом на фиолетовом фоне — плохо читалось. Теперь текст белый и контрастный, как и должно быть. *** ### **9. Конструктор — карточки для незнакомых узлов** Если в сценарий попал узел нового типа, которого ваш браузер ещё не знает (например, обновился сервер, а вкладка с конструктором ещё не перезагружена), раньше отображался безымянный серый прямоугольник — выглядел как баг. Теперь показываем красивую градиентную карточку «Новый узел — возможно появится в следующем обновлении» с иконкой и кнопкой удаления, в стиле остальных узлов. *** ### **10. Колокольчик уведомлений — большая прокачка** Центр уведомлений в правом верхнем углу стал заметно удобнее и надёжнее. **Что нового:** * **Отдельная вкладка для задач.** Раньше уведомления о задачах смешивались с уведомлениями о клиентах в одной вкладке — было сложно быстро увидеть просрочки. Теперь под колокольчиком пять вкладок-иконок с tooltip и счётчиком непрочитанных по каждой: «Все», «Клиенты», «Тревоги», «Рассылки», «Задачи». Клик переключает фильтр. * **Клик по уведомлению о задаче открывает саму задачу.** Раньше переводило просто на страницу «Задачи», теперь сразу открывается попап нужной задачи. * **Упоминания в комментариях.** Если коллега тегнул вас через `@имя` в комментарии к задаче — придёт отдельное уведомление «Вас упомянули в комментарии» с превью текста, помимо общего «Новый комментарий» всем участникам. Работает и self-mention (если тегнули сами себя — придёт). * **Уведомления из сценариев бота попадают в колокольчик.** Узел «Уведомление» в сценарии теперь не только шлёт сообщение в Telegram/MAX, но и создаёт запись в колокольчике у получателей внутри платформы. Раньше дублирующая копия терялась. * **Клик по «общей» рассылке открывает красивый диалог-карточку** с заголовком, иконкой, временем, полным текстом (с поддержкой markdown — жирный, курсив, заголовки, списки, цитаты, ссылки, код) и кнопками-действиями (открыть URL, выполнить callback). Раньше открывался обычный popup, в нём текст шёл сжатой стеной. * **Корректная типография в уведомлениях.** Заголовки, списки, цитаты и блоки кода в текстах рассылок и задач теперь рендерятся с правильными отступами, маркерами и border'ами — раньше всё было плоской стеной без оформления. * **Удалённые рассылки сразу пропадают** из колокольчика во всех открытых вкладках браузера, без F5. * **Попап колокольчика стал компактнее**: ширина уменьшена, табы переведены на иконки с tooltip — больше не загромождает экран. Сдвинут правее, чтобы не наезжать на сайдбар. * **Безопасная доставка.** Если сообщение пришло пока вы были оффлайн или в фоновой вкладке, оно гарантированно догонит вас — приложение само рефетчит уведомления при возврате к окну и регулярно проверяет фоном. *** --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://book.microcrm.online/changelog/1.2.1.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.