Справка Открыть Искру

Боты Искры в Telegram и MAX

В облачной Искре боты называются «Моя Искра»: в Telegram — @youriskrabot, в MAX — @se13805330_2_bot. Для другого контура имя и адрес бота сообщает администратор. Через эти боты вы пишете самой Искре, навык для этого не нужен. Подключить к Искре собственного бота вашей компании, чтобы Искра работала с его группами и каналами, можно навыками «Чат-боты Telegram» и «Чат-боты MAX».

Вы можете общаться с ботом в личном Telegram-чате и в группах: задавать вопросы, создавать задачи и встречи, спрашивать о новых письмах. Для работы с почтой сначала подключите и настройте почтовый навык в самой Искре. Созданные задачи и встречи проверяйте в «Планах» выбранного профиля. Получение результатов запланированных запусков настраивается отдельно от переписки — см. «Уведомления Telegram-бота о результатах расписаний».

Бот Искры в MAX

В облачной Искре откройте бота по ссылке iskramax.ru (в MAX — @se13805330_2_bot). Для другого контура адрес MAX-бота сообщает администратор. Чтобы подключить профиль к боту Искры, откройте с ним личный чат, нажмите «Начать» и подключите нужный профиль через защищённую страницу по той же инструкции ниже. Для Telegram и MAX профиль подключается отдельно; отключение одного бота сохраняет другое подключение.

Собственного бота компании в MAX подключает не бот Искры, а навык «Чат-боты MAX».

В MAX доступны общие команды Искры, текстовые запросы, документы, фотографии, голосовые и результаты расписаний при поддержке этих возможностей вашим контуром Искры. Доступность уточните у администратора. Бот обрабатывает до 12 вложений в одном полученном сообщении; клиент MAX может отправить их раздельно. Документы и фотографии — до 20 МБ каждый, голосовые — до 5 минут и 16 МБ. Голосовой ответ приходит текстом. Фото с подписью остаются одним запросом; если клиент MAX отправил вопрос отдельным сообщением после файла, бот получает два отдельных запроса.

Ссылку отправляйте обычным текстом: её карточка предпросмотра не становится отдельным файлом. Пересланные в личный чат с ботом документ, фотографию или текст бот обрабатывает так же, как отправленные напрямую. Комментарий к пересылке клиент MAX отправляет отдельным сообщением, поэтому бот получает два запроса, как и при вопросе, отправленном после файла. Пересланное голосовое MAX может не передать боту; если бот его не распознал, отправьте голосовое боту напрямую.

Для обращения в группе добавьте MAX-бота администратором и напишите вопрос вместе с @имя_бота или /ask@имя_бота. Можно также отправить свой вопрос, а следом, в течение двух минут, отдельное упоминание бота: он возьмёт вашу последнюю ещё не использованную реплику, если она сохранилась целиком. Ответ виден группе и использует права автора обращения. Управление профилем и уведомлениями выполняется в личном чате.

Чтобы разобрать документ или фотографию участника группы, в том числе пересланные, ответьте на это сообщение через Reply и напишите вопрос с @имя_бота или /ask@имя_бота. Бот загрузит вложение из выбранного сообщения, даже если у него нет подписи; отдельное упоминание означает просьбу прокомментировать вложение. В личном чате так же можно ответить через Reply на свой файл, на пересланный файл или на файл, присланный ботом. Если у вашего нового сообщения есть своё вложение, бот обрабатывает его. Файлы из остальной истории автоматически не загружаются.

Сейчас MAX не передаёт боту голосовое после его доставки, поэтому Reply на голосовое не работает: отправьте голосовое боту напрямую. Если процитированное сообщение недоступно, например это голосовое или удалённое сообщение, в группе Искра сообщит, что цитата ей недоступна. На Reply к видео, стикеру или другому неподдерживаемому вложению бот ответит, что вложение не поддерживается; если MAX не передал боту само сообщение, цитата считается недоступной.

Недавние полученные сообщения участников и предыдущие ответы Искры могут войти в контекст ответа. Бот учитывает порядок сообщений, который сообщает MAX. Для более ранних полученных сообщений доступен такой же 30-дневный архив, как в Telegram: Искра запрашивает его, когда он нужен для ответа. Архивы двух ботов раздельные; пропущенные сообщения не восстанавливаются. Чтобы продолжить конкретный ответ Искры, ответьте на него функцией Reply. Reply с упоминанием бота позволяет разобрать доступную цитату, даже если она вышла из недавнего фрагмента. Доступный фрагмент показывает /context. Для работы группы боту нужны права читать сообщения и управлять сообщениями (read_all_messages и write); после отзыва обработка группы приостанавливается.

Короткая подсказка об этих правах есть в приветствии и /help, а при добавлении в группу может прийти добавившему в уже открытый и не остановленный личный чат.

При включении уведомлений в обоих ботах результат расписания приходит в оба личных чата. Остановка MAX-бота приостанавливает его доставку, сохраняя расписания в Искре. Для продолжения откройте бота и восстановите подключение через /connect. Запоздалая остановка старого подключения сохраняет новое подтверждённое подключение. Если MAX отклонил оформление ответа, бот повторит его обычным текстом с теми же кнопками. Если ответ всё же не удаётся отправить после повторных попыток, бот сообщит об этом отдельно и продолжит отправку остальных ответов.

Как подключить бота

Шаги ниже подключают ваш профиль к боту Искры. Собственного бота компании подключают навыки «Чат-боты Telegram» и «Чат-боты MAX».

  1. Откройте личный чат с ботом и нажмите «Начать» или отправьте /start.
  2. Нажмите «Подключить Искру», затем на открывшейся странице — «Продолжить в Искре». Откроется сайт вашей Искры.
  3. Если вы ещё не вошли, выберите доступный способ: Яндекс, VK или почту. При открытой сессии повторный вход не нужен.
  4. Проверьте название приложения и аккаунт, затем выберите нужный профиль: личный или рабочий. Посмотрите, какие возможности получит бот. Получение результатов расписаний можно разрешить отдельно.
  5. Подтвердите доступ и вернитесь в свой личный чат с ботом. Он пришлёт сообщение с выбранным профилем и кнопкой «Завершить подключение». Нажмите её и дождитесь сообщения о готовности. Кнопка на странице браузера также позволяет завершить подключение. После подтверждения отправьте первый вопрос.

Копировать API-ключ при таком подключении не требуется. Завершайте подключение в том же аккаунте мессенджера, из которого его начали. Если выбрали другой аккаунт Искры, воспользуйтесь «Другой аккаунт» на странице согласия и войдите заново. Если ссылка истекла, начните подключение ещё раз из личного чата с ботом.

Новый способ доступен, когда его настроил администратор контура. Если бот предлагает API-ключ или вы предпочитаете этот вариант, используйте инструкцию ниже. Браузер после подключения держать открытым не требуется.

Подключение своим API-ключом

В облачной Искре подключитесь к @youriskrabot. Для другого контура адрес бота уточните у администратора.

  1. Откройте личный чат с ботом и нажмите «Начать» или отправьте /start. Выберите вариант подключения по API-ключу. Если новый способ подключения не настроен, бот сразу покажет эту пошаговую инструкцию. Она доступна также при обращении к ещё не подключённому боту.
  2. Нажмите «Открыть Искру», войдите в аккаунт и выберите нужный профиль: личный или рабочий. Бот будет использовать задачи, навыки и доступные данные именно этого профиля.
  3. В выбранном профиле откройте Настройки → API-ключи, создайте отдельный ключ с названием, например, «Telegram». Для переписки выберите Чат и прогоны (chat:run), для почты и других навыков — также Запуск навыков (skills:run). Кнопка «Какие права выбрать?» в боте объясняет дополнительные права для файлов и уведомлений.
  4. Скопируйте ключ — полный ключ показывается один раз. Вернитесь к боту, нажмите «У меня есть ключ», затем «Вставить ключ в защищённой форме». Вставьте ключ на открывшейся странице и нажмите «Продолжить».
  5. Вернитесь в Telegram по ссылке из формы и нажмите «Подтвердить подключение» в личном чате. Дождитесь сообщения о готовности и отправьте первый вопрос.

Вводите ключ только в защищённой HTTPS-форме: отправлять его сообщением в чат или диктовать голосом не нужно. Запросы, отправленные до подключения, повторите после сообщения о готовности — автоматически они не выполняются.

Ссылка на форму действует 10 минут с момента её получения. Если она истекла, вернитесь к боту и получите новую через /connect; действующий API-ключ можно использовать снова. При отклонённом ключе бот объяснит, как восстановить подключение. Уже подключённому пользователю /start показывает готовность и примеры запросов, сохраняя текущую беседу.

Пошаговая справка по созданию и правам API-ключа. Для переписки браузер держать открытым не требуется.

Профиль, переподключение и отзыв доступа

Один Telegram-пользователь подключает один профиль. Переключение профиля на сайте не переключает бота. Чтобы заменить подключение, отправьте /connect и выберите нужный профиль на сайте либо используйте его API-ключ. Прежнее подключение работает до завершения нового.

Успешное переподключение начинает новую личную беседу и очищает её сохранённый контекст и личный архив, даже если профиль остался прежним. Незавершённый запрос автоматически не запускается под новым подключением. Обычное продление доступа в фоне сохраняет беседу и её контекст.

Команда /disconnect удаляет подключение бота. Доступ, выданный через сайт, можно также отозвать в Настройках → Подключённые приложения нужного профиля. При ручном подключении сам API-ключ отзывается отдельно в Настройках → API-ключи. Отзыв прекращает новые обращения; уже начатое действие может успеть завершиться, а ранее переданные приложению данные остаются у него.

Если бот просит подключиться заново после сбоя продления доступа, сначала проверьте результат последнего запроса в Искре. Он мог выполниться до сбоя. После переподключения отправьте нужный запрос самостоятельно, если его результата нет.

Текстовые запросы и ответы Telegram-бота

После подключения пишите обычным текстом: «Какие новые письма?», «Создай встречу завтра в 11:00». Время и доступные возможности определяются настройками профиля Искры. Действия, которым нужно дополнительное подтверждение в Искре, бот сам не подтверждает; он сообщит, если продолжить задачу в Telegram нельзя.

На обычный вопрос Искра старается отвечать в 1–3 коротких предложениях, сразу переходя к сути. Тон общения — живой и дружелюбный, с лёгким юмором по ситуации; в серьёзных и чувствительных темах — спокойный и бережный. Если нужен подробный разбор, попросите об этом в сообщении. Запрошенные письма, инструкции и документы Искра выдаёт полностью, с коротким сопровождением. Это относится и к личному чату, и к группам.

Ссылки, скрытые под словами входящего сообщения или подписи к вложению, тоже доступны Искре: адрес передаётся рядом с текстом ссылки.

В ответах сохраняются выделения, ссылки, списки, таблицы и блоки кода. В Telegram пустые строки между абзацами и переносы внутри абзаца сохраняются при просмотре и копировании текста ответа. Слишком большой ответ делится на несколько сообщений. В MAX списки, таблицы и некоторые другие элементы приходят читаемым обычным текстом; короткий ответ с такими элементами помещается в одно сообщение. Изображения внутри Markdown показываются ссылками; файлы, созданные Искрой как вложения, приходят отдельными документами.

Ход выполнения и очередь Telegram-бота

Во время работы бот меняет одно временное сообщение: распознаёт голос, загружает вложение, выполняет запрос, ищет сведения, работает с файлами или готовит ответ. Этап определяется фактическим ходом выполнения; бот не показывает внутренние рассуждения или содержимое вызовов инструментов. После результата или остановки временное сообщение удаляется. При отсутствии прав на удаление оно может остаться в чате. Служебные статусы не добавляются в историю беседы Искры.

Если Искра обновляется, временно недоступна или просит снизить частоту запросов, бот показывает причину ожидания. Запрос сохранён, повторные попытки выполняются автоматически. Следующее сообщение ждёт завершения предыдущего запроса этого же пользователя, в том числе отправленного в другом чате. Причина ожидания имеет приоритет над этапом работы.

Если объём переписки мешает начать ответ, бот автоматически собирает запрос заново под доступный размер: сначала убирает старые цитаты, сохраняя свежий контекст и текущий вопрос целиком. При успешном восстановлении вы получаете обычный ответ без промежуточного сообщения об ошибке.

Такой повтор выполняется, когда Искра подтвердила, что обработка ещё не началась. Если текущий вопрос сам превышает доступный размер или восстановить запрос безопасно не удалось, бот объяснит следующий шаг.

Ошибки Telegram-бота: подписка, лимиты, тарифы и оплата

При ограничении по подписке или исчерпании лимита бот завершает текущий запрос и показывает, что делать дальше, со ссылкой на «Тарифы и оплату». Для облачной Искры это cloud.iskrabot.ru/pricing. Возможные причины:

Причина Что делать
Нет активной подписки Выберите и оплатите тариф
Оплата ещё не подтверждена Если уже оплатили, дождитесь обновления статуса платежа
Оплата просрочена или подписка закончилась Проверьте подписку и оплатите продление
Доступ ограничен условиями подписки Проверьте тариф и статус оплаты; для профиля организации обратитесь к её администратору
Доступный лимит исчерпан Проверьте лимиты и тариф; для профиля организации обратитесь к её администратору

После восстановления доступа проверьте результат в Искре и при необходимости отправьте запрос снова. Это относится и к отказу при загрузке вложения. Если ограничение помешало получить файл результата, получите существующий результат в Искре: повторный запуск задачи не нужен. Подключение сохраняется: повторять /connect не нужно. Форма подключения тоже отличает ограничение по подписке от неверного ключа, частых попыток и временной недоступности Искры.

Для других известных ошибок бот подскажет следующий шаг: уменьшить вложение, уточнить запрос, начать новый диалог при заполненной рабочей области или продолжить задачу в Искре. Если часть ответа уже получена, она остаётся в сообщении об ошибке. Точная причина ограничения доступна после обновления Искры; при неизвестной внутренней ошибке бот сообщает о сбое без предложения оплаты.

Обращения к Telegram-боту в группе: упоминание и Reply

Каждый участник, который обращается к боту, сначала подключает собственный профиль в личном чате любым из двух способов. Затем отправьте /ask@имя_бота ваш вопрос или ответьте на сообщение бота. Эти способы работают и при включённом режиме приватности Telegram. Если владельцем бота настроено получение обычной переписки группы, можно также обратиться через @имя_бота. На остальные сообщения бот не отвечает. До появления этапа работы бот показывает индикатор набора текста.

Можно отправить вопрос обычным сообщением, а следом — только @имя_бота. Бот возьмёт вашу последнюю реплику в этой же теме, если прошло не больше двух минут, она ещё не использовалась для обращения и сохранилась целиком. Повторный тег, устаревшая реплика или неясный запрос дадут подсказку без запуска ответа Искры. Чтобы выбрать конкретное сообщение, ответьте на него через Reply с упоминанием бота. Эта цитата имеет приоритет, даже если уже вышла из доступного фрагмента переписки; отдельный тег в Reply означает просьбу прокомментировать цитату. Если цитата недоступна, самостоятельный вопрос или приложенный файл всё равно обрабатываются. Подсказка нужна только для отдельного упоминания без доступной цитаты или вопроса. Reply на сообщение бота обращается к нему без дополнительного упоминания. Вопрос с Reply сохраняет свою цитату и при последующем отдельном упоминании бота.

Запрос выполняется с правами автора обращения, а ответ видят все участники группы. Для личных сведений используйте личный чат. Подключение, его замена и настройки уведомлений также выполняются в личном чате; при ручном способе сам ключ вводится только в форме подключения.

Контекст Telegram-группы: 33 сообщения и доступное время

Для каждого обращения бот учитывает до 33 последних полученных сообщений этой группы или темы за 24 часа, включая свои предыдущие ответы, с именами авторов и временем сообщений. На одну цитату отводится до 2000 символов, на весь запрос вместе с контекстом и служебными данными — до 16000. Сначала помещается ваш запрос, затем Reply и наиболее свежая переписка; длинные цитаты сокращаются. Личный разговор в этот контекст не входит.

В обычной группе ответы через Reply используют общую историю этой группы. В группе с темами контекст ограничен текущей темой: цитаты и история другой темы в него не попадают. Если цитата недоступна, отправьте нужный текст отдельно; доступная история группы при этом сохраняется.

Отправьте /context или /context@имя_бота в группе, чтобы увидеть, сколько сообщений сохранено и сколько помещается в контекст, доступный период в UTC и ограничения. Подключать профиль для этой команды не нужно, ответ готовится без обращения к AI. В личном чате команда подскажет отправить её в группу. Бот видит только сообщения, которые ему передаёт Telegram, и не загружает более раннюю переписку. Если обычные сообщения ему недоступны, попросите владельца бота настроить доступ к переписке группы.

История чата Telegram или MAX за последние 30 дней

Если для ответа нужна более ранняя переписка, Искра может запросить у бота сохранённую историю за нужный период — от 1 до 30 дней. Например, спросите: «Что мы решили по проекту за последние десять дней?» История относится только к текущему чату и теме группы. Переписка других личных чатов, групп и тем в этот запрос не попадает.

Архив хранится отдельно от короткого контекста из 33 сообщений. Он включает полученный ботом текст, распознанные голосовые обращения и ответы Искры. Для обычного вопроса весь архив автоматически не передаётся. Когда история нужна, бот передаёт её Искре файлом и продолжает ответ на ваш вопрос. Подключению требуется право «Загрузка файлов» (files:write); при его отсутствии бот предложит изменить доступ через /connect в личном чате.

Это доступная боту часть переписки. Бот сохраняет сообщения, полученные из своего мессенджера; старые и пропущенные сообщения задним числом не восстанавливаются. Приватность и права группы могут ограничивать новые. Архив накапливается после обновления бота; уже удалённые сообщения не восстанавливаются. Документы, фотографии и исходные аудиозаписи в него не входят. В личном архиве могут сохраниться подготовленные ответы Искры, доставка которых в мессенджер не подтвердилась; групповые ответы сохраняются после подтверждённой доставки.

Длинные сообщения и слишком большой архив могут быть сокращены. Вместе с историей Искра получает сведения о доступном периоде и сокращениях и учитывает их в ответе. Отсутствие записей не означает, что в чате не было переписки. Для одного вопроса история предоставляется один раз; при необходимости уточните вопрос или период отдельным сообщением.

Если бот не смог подтвердить передачу истории, автоматическая повторная загрузка останавливается. Он сообщит об этом; отправьте вопрос об истории заново, чтобы попробовать ещё раз.

Команды Telegram-бота и личный разговор

Команды управления ниже выполняйте в личном чате; /context — в нужной группе или теме. Для вопроса в группе используйте /ask@имя_бота ваш вопрос или ответ на сообщение бота.

Команда Действие
/start Инструкция подключения или приглашение к разговору
/help Подсказка по командам
/ask@имя_бота ваш вопрос Обратиться к Искре в группе Telegram или MAX, указав имя своего бота
/keyrights Права API-ключа для переписки, навыков, файлов и уведомлений
/status Проверить подключение и состояние уведомлений
/new Начать новый личный разговор
/stop Остановить текущую задачу
/notifications off / /notifications on Выключить или включить результаты расписаний
/connect Подключить или заменить профиль
/disconnect Удалить подключение бота
/context / /context@имя_бота Показать доступный контекст группы или темы без API-ключа

Личная беседа в API Искры временная: она не появляется постоянным чатом в веб-интерфейсе и живёт до 24 часов бездействия. Бот сохраняет зашифрованный резерв последних 33 сообщений, включая свои ответы, без временного срока. После истечения API-беседы он создаёт новую и передаёт доступный резерв вместе с вашим вопросом — без отдельного сообщения, сразу с ответом. Если прежний контекст передать не удалось (например, сохранённых сообщений нет), бот предупредит, что отвечает в новой беседе без него. Пока беседа действует, передаётся только новая реплика. Длинные сообщения сокращаются. /new, отключение и переподключение очищают резерв и личный архив; перезапуск сервера их сохраняет. Резерв и архив накапливаются после установки соответствующей версии бота: прежние удалённые сообщения восстановить нельзя. После истечения беседы архив остаётся доступен в пределах 30 дней, а старые вложения нужно приложить повторно.

Уведомления Telegram-бота о результатах расписаний

Бот может присылать в личный Telegram-чат текст новых результатов запланированных запусков подключённого профиля. Для этого подключению нужно право «Результаты расписаний» (agenda:read): разрешите его на странице подключения либо выберите при создании API-ключа. Включите уведомления командой /notifications on, выключите — /notifications off. Получение результатов должно быть доступно на вашей установке.

Это отдельная доставка результатов, а не ответы на ваши текущие сообщения боту. Выключенные уведомления не мешают переписке; настройка Email-уведомления задачи ими не управляет. Если получение результатов стало доступно позже, старая история не рассылается. Сами задачи, встречи и их результаты проверяйте в «Планах» того же профиля.

Отключение бота или отзыв доступа не отменяет уже созданные расписания: остановите их в «Планах». Если подключение истекло или было отозвано, повторите /connect; для ручного способа при необходимости создайте новый ключ.

Почему не пришёл результат расписания

Отсутствие сообщения в Telegram не означает, что задача не выполнилась. Сначала откройте «Планы» → «Актуальное» в том профиле Искры, который подключён к боту, и проверьте результат записи или блок «Недавние результаты». Если работа уже выполнена, используйте её результат: повторный запуск может повторить действия с файлами или во внешних сервисах.

Затем проверьте доставку:

  1. В личном чате с ботом отправьте /status. Если уведомления выключены, включите их командой /notifications on.
  2. Убедитесь, что выбранному подключению разрешены «Результаты расписаний» (agenda:read). При подключении через сайт это право выбирается на странице согласия; при ручном подключении оно должно быть у API-ключа. Если нужно заменить подключение, используйте /connect с тем же нужным профилем и разрешите это право.
  3. Сообщение «ожидают доступа: нужен API результатов и право agenda:read» означает, что бот ещё не начал получать ленту результатов. Оно может появиться до первого успешного опроса и само по себе не доказывает, что сервер устарел. Если право выдано и уведомления включены, но ожидание сохраняется, попросите администратора проверить доступность API результатов на основной Искре.

При первом успешном подключении к ленте бот начинает с новых результатов выбранного профиля; историю до этого момента он не рассылает. Состояние «Уведомления включены» не подтверждает доставку конкретного результата — сам результат проверяйте в «Планах». Выключение уведомлений и отключение бота не отменяют записи: остановить их можно в «Планах».

Файлы Telegram-бота: отправить вложение и скачать результат

Прикрепите документ или фотографию к сообщению и напишите запрос в подписи. Без подписи Искра получает просьбу разобрать вложение. В группе используйте упоминание в подписи или reply на сообщение бота.

Чтобы разобрать документ или фотографию участника группы, ответьте на это сообщение через Reply и напишите вопрос с @имя_бота или /ask@имя_бота. Бот загрузит вложение из выбранного сообщения, даже если у него нет подписи. Отдельное упоминание в Reply означает просьбу прокомментировать вложение. В личном чате также можно ответить на сообщение с файлом через Reply. Если у вашего нового сообщения есть своё вложение, бот обрабатывает его. Файлы из остальной истории автоматически не загружаются; укажите нужное сообщение через Reply или прикрепите файл заново. Альбом Telegram обрабатывается отдельными сообщениями.

Для приёма файла подключению нужно право files:write, для отправки результата — files:read. Входящее вложение ограничено 20 MB, исходящий документ — 50 MB. Если права нет или файл уже недоступен, бот сообщит об этом; текстовый чат продолжит работать. Голосовые запросы описаны ниже; видео и видеосообщения в этой версии бота не поддерживаются.

Ранее загруженные файлы доступны в той же действующей беседе Искры. После её истечения восстанавливается текстовый резерв: нужное старое вложение следует приложить повторно. Файлы результата приходят документами, даже если Искра не добавила текстовый ответ. В группе их видят все участники.

Исходные файлы навыка «Память» memory.md и memory-log.md автоматически в Telegram не прикладываются. Чтобы получить их снимки, явно попросите об этом в подтверждённом личном диалоге владельца с ботом. Снимки отражают состояние на момент запроса; для нового состояния запросите выгрузку снова. При подключении официального бота своим API-ключом эта выгрузка пока не работает; используйте подключение через «Продолжить в Искре».

Эти два исходных файла и их снимки нельзя отправить в группу или супергруппу. Отказ не переносит отправку в личный диалог. Ограничение относится именно к этим файлам: другие результаты навыка, например длинные выборки фактов, могут приходить отдельными файлами, в том числе в группе. Обычные документы, в том числе Markdown-файлы, по-прежнему можно получать в группе.

Голосовые сообщения Telegram-боту

В личном чате запишите голосовой запрос длительностью до 5 минут и размером до 16 MiB. В группе отправьте голосовое через Reply на сообщение бота; если доступна подпись, можно обратиться к боту в ней. Чтобы разобрать голосовое участника группы, ответьте на него через Reply и напишите вопрос с упоминанием бота или /ask@имя_бота. Бот распознает выбранную запись и передаст её как цитату исходного автора; ваш вопрос определяет, что с ней сделать. Это работает и для голосового из Reply в личном чате. Если в вашем сообщении есть собственное вложение, используется оно. Записи из остальной истории автоматически не распознаются.

Собственное голосовое Искра выполняет как ваш запрос, а голосовое из Reply использует как контекст вашего вопроса. Запрос и распознавание выполняются с правами подключённого профиля автора обращения. Достаточно права Чат (chat:run); отдельное право загрузки файлов для голосового запроса не нужно. Ответ приходит текстом, а созданные файлы — документами при наличии files:read. Аудиоответа нет. Произнесённые /connect и другие команды бота не исполняются как команды: для управления отправляйте их обычным текстовым сообщением.

Голосовой ввод требует обновления основной Искры с поддержкой голосовых запросов API. Обновления одного бота недостаточно. Если ваш контур ещё не обновлён, бот предложит отправить текст. Браузер для записи и получения ответа не нужен. Распознавание учитывается по условиям вашего профиля; ограничения подписки и оплаты действуют так же, как для текстовых запросов.

Если речь не обнаружена, запись повреждена или превышен лимит, бот объяснит причину: запишите более короткое голосовое или отправьте текст. /stop останавливает ожидание результата, а /new также начинает новый личный разговор; поздняя расшифровка не запускает отменённый запрос.

Если отправка записи завершилась без подтверждения, бот сообщит о неопределённом результате. Возможное платное распознавание автоматически не повторяется; при необходимости отправьте новый запрос самостоятельно.