Max messenger bot api

[!TIP] Коротко: Подробная инструкция: max messenger bot api. Пошаговое руководство с проверками и рабочими решениями.

Взаимодействие с ботами и функциональными интеграциями в MAX

В мессенджере MAX взаимодействие с автоматизированными системами и внешними сервисами (РКН, Госуслуги) происходит через специальных чат-ботов. Данный гайд описывает процесс поиска, активации и использования ключевых ботов, а также работу с их функционалом.

Поиск и добавление чат-бота

Для начала работы с любым ботом или API-интеграцией внутри мессенджера необходимо добавить соответствующий контакт в список чатов.

Пошаговая инструкция:

1. Откройте приложение MAX (Android, iPhone) или веб-версию.
2. Нажмите на иконку поиска (лупа) в правом верхнем углу экрана.
3. Введите в текстовое поле точный никнейм бота. Для корректного поиска необходимо знать никнейм заранее (например, @maxbot, @channel_bot или @goskey_bot).
4. В результатах поиска нужный бот отобразится первым. Нажмите на него, чтобы открыть диалог.
5. Нажмите кнопку «Начать» внизу экрана. Это активирует бота и добавит его в ваш список чатов.

Создание каналов через @channel_bot

Блогеры и авторы сообществ могут использовать API-интеграцию с реестром Роскомнадзора (РКН) через бота @channel_bot для создания официальных каналов. Это доступно только для ресурсов с отметкой «А+» (аудитория от 10 000 подписчиков, прошедшая регистрацию).

Процесс регистрации канала:

Настройка созданного канала:

После получения одобрения выполните финальные настройки:

1. Снова зайдите в @channel_bot и выберите «Создать канал».
2. Нажмите «Перейти в канал».
3. Загрузите аватарку и добавьте описание.
4. Важно: Никнейм и название канала сформируются автоматически на основе данных из реестра РКН и не подлежат ручному изменению.

Интеграция с Госключом через @goskey_bot

Для подписания документов внутри мессенджера используется интеграция с сервисом Госуслуги через бота @goskey_bot.

Связывание профилей:

1. Активируйте бота @goskey_bot, нажав «Начать».
2. В меню выберите «Загрузить документы», затем нажмите «Подтвердить профиль».
3. Нажмите кнопку «Перейти на Госуслуги».
4. Авторизуйтесь на портале и нажмите «Предоставить» для доступа к данным.
5. Вернитесь в бот и нажмите «Подтвердить» для завершения связки.

Процесс подписания документов:

1. Откройте диалог с @goskey_bot.
2. Отправьте необходимые файлы в чат.
3. Выберите тип подписи в меню:
   • УНЭП — для большинства стандартных документов.
   • УКЭП — если требуется усиленная квалифицированная подпись.
4. Нажмите кнопку «Подписать документы». Система перенаправит вас в приложение «Госключ».
5. Авторизуйтесь в «Госключе» с паролем и подтвердите подписание кнопкой «Подписать».
6. Готовые файлы с подписью автоматически появятся в чате с ботом в MAX.

Работа с официальными и AI-ботами

В системе предусмотрены официальные боты для информирования и выполнения задач с помощью нейросетей. Официальные боты имеют специальную отметку (галочку) напротив названия.

• @maxbot — официальный новостной бот. Используйте его для получения информации о последних обновлениях мессенджера и новинках функционала.
• @gigachat — бесплатная нейросеть от Сбера. Этот бот поддерживает следующие функции:
  • Работа с текстом и ответы на вопросы.
  • Написание кода и помощь в программировании.
  • Генерация изображений по текстовому описанию.
  • Решение разнообразных задач в режиме диалога.

Если что-то пошло не так

При работе с ботами пользователи могут столкнуться с рядом ограничений или ошибок. Ниже приведены способы их устранения.

1. Ошибка при создании канала: «Заявка отклонена» или нет доступа

• Причина: Отсутствует отметка А+ или несовпадение данных.
• Решение: Убедитесь, что ваш канал/сообщество имеет аудиторию более 10 000 человек и прошел регистрацию в РКН. Заявку в @channel_bot нужно отправлять строго с того профиля MAX, который зарегистрирован на тот же номер телефона, что и канал в реестре РКН.

2. Бот @goskey_bot не подписывает документы

• Причина: Превышение лимитов на файлы.
• Решение: Проверьте количество и вес файлов. За один раз можно отправить не более 20 файлов. Суммарный вес отправляемых документов не должен превышать 100 МБ.

3. Не удается найти бота в поиске

• Причина: Неверный ввод никнейма.
• Решение: Вводите никнейм точно, начиная с символа @. Например, поиск по слову “новости” может не дать результата, нужно вводить @maxbot.

4. Хештег для Telegram не проходит проверку

• Причина: Хештег не вставлен или кэш не обновился.
• Решение: Вставьте полученный от бота хештег в описание (bio) вашего Telegram-канала, сохраните изменения и подождите 1-2 минуты перед нажатием кнопки «Проверить» в боте.

Что важно учесть

• Множественные каналы: Если вы владеете несколькими ресурсами с отметкой А+ и хотите создать для каждого зеркало в MAX, процедуру нужно проходить заново для каждого канала. Отправьте повторную заявку в @channel_bot после одобрения предыдущей.
• Автоматические данные: При создании канала через бота вы не сможете задать произвольное название. Оно будет идентично тому, что указано в реестре Роскомнадзора, для сохранения узнаваемости и подтверждения подлинности.
• Безопасность: Официальные боты всегда имеют значок верификации. Будьте внимательны при поиске: если бот запрашивает личные данные, но не имеет галочки подтверждения и соответствующего никнейма (например, @maxbot), не взаимодействуйте с ним.

[!NOTE] Примечание: отдельные условия и ограничения могут меняться. Уточняйте актуальные детали в поддержке MAX.

Что ещё посмотреть по теме

• Решение проблем и лайфхаки
• Скрытые возможности
• Настройки приватности