Информация Подключение групп Telegram, MAX и транскрибация голосовых

Подключение групп Telegram, MAX и транскрибация голосовых

На этой странице описаны все текущие варианты подключения групп MAX в кабинете и работа транскрибации голосовых сообщений для подписчиков.

Общие рассылки и уведомления в сервисе работают через Telegram и Max; в этой инструкции разобран сценарий для групп Max.

Как работает транскрибация голосовых

  1. Подписчик отправляет голосовое сообщение в подключённую группу.
  2. Бот получает голосовое вложение, распознаёт речь и формирует текст.
  3. Текст расшифровки отправляется в ту же группу как ответ-цитата на исходное голосовое сообщение.

Что умеет система сейчас

  • Автоматическое добавление группы в кабинет при событии добавления бота в группу.
  • Ручное добавление группы по chat_id в разделе «Группы (бот)».
  • Обновление названия группы через очередь (без блокировки страницы).
  • Удаление группы из кабинета с командой боту выйти из этой группы.
  • Транскрибация голосовых в подключённых группах с учётом лимитов тарифа.

Обязательные условия подключения группы

  • Администратор должен быть привязан к боту (через стандартную привязку в кабинете).
  • Бота нужно добавить в нужную группу.
  • Боту нужно выдать права администратора группы, иначе доступ к сообщениям/вложениям может быть ограничен.

Способ 1 (рекомендуется): автоматическое подключение

  1. Администратор добавляет бота в группу из своего привязанного аккаунта.
  2. Бот получает событие добавления в группу и автоматически создаёт запись в allowlist групп в кабинете.
  3. Бот подтягивает название группы и отправляет администратору уведомление в личный чат.

Если группа уже закреплена за другим пользователем докго.рф, подключение отклоняется.

Способ 2: ручное добавление по ID

  1. Откройте «Группы (бот)».
  2. Введите chat_id группы и сохраните запись.
  3. При необходимости нажмите «Обновить название» — запрос уйдёт в очередь и название подтянется асинхронно.

Удаление группы

  • При удалении группы в кабинете запись удаляется из allowlist.
  • Дополнительно в очередь ставится команда leave_chat.
  • После обработки очереди бот выходит из этой группы.

Что проверить, если что-то не работает

  • Бот действительно добавлен в правильную группу и имеет права администратора.
  • Группа добавлена в allowlist в разделе «Группы (бот)».
  • Администратор привязан к боту и у него есть активный личный чат с ботом (для сервисных уведомлений).
  • Убедитесь, что в вашем тарифе есть доступ к расшифровке голосовых и лимит не превышен.

Важно

Качество распознавания зависит от дикции, фонового шума и длительности аудио.