Тонкости программирования ботов для месенджера MAKC.
Данный документ поможет вам в разработке, т.к. много моментов вызывает очень неоднозначные чувства, например,
разработчики не подумали о том, что банально скопировать название из выпадающего списка невозможно,
а информация как сформировать ссылку на пользователя спрятана так, что даже яндекс с гуглом вам не поможет. Итак:
Список событий передаваемых в MAX WebHook обработчик в поле 'update_type'
Этот же список передается при установке обработчика в поле update_types, - документация.
'message_created', 'message_callback', 'message_edited', 'message_removed', 'bot_added', 'bot_removed', 'dialog_muted', 'dialog_unmuted', 'dialog_cleared', 'dialog_removed', 'user_added', 'user_removed', 'bot_started', 'bot_stopped', 'chat_title_changed', 'message_chat_created'
Как сформировать ссылку на пользователя в МАКС по его ID?
Ссылка аналогичная ссылке в телеграмtg://user?id= в МАКС выглядит так:
<a href="max://user/USER_ID">ИМЯ ФАМИЛИЯ</a>
Обратите внимание, ничего кроме "ИМЯ ФАМИЛИЯ" в анкоре писать нельзя, иначе ссылки не будет!!!
Как получить ID пользователя в МАКС?
Запустите бота @id616301431999_bot и отправьте ему команду /id.
Чтобы узнать ID другого пользователя, перешлите боту в личку любое сообщение от пользователя, бот сообщит Вам id пользователя от кого вы переслали.
Как открыть панель отладки в WebView в Макс?
После указания ссылки на мини приложение здесь.
Открыть в браузере https://max.ru/botName?startapp и не разрешаешь открыть в приложении,
откроется WEB-версия макс, - там можно открыть окно отладки.
Есть нюансы:
- приложение на компе зависает после открытия в web версии и в приложении одного WebView
- область видимости переменных усложняет отладку
В MAX уже есть публичные чаты или группы?
Если у вас есть канал, Вы можете в каждом посте публиковать ссылку на свой чат канала.
Хочу сделать бота в Макс, что делать, к кому обращаться?
Чтобы сделать бота нужно иметь свое ООО или ИП:
- Регистрируетесь на мсп.рф
- Подтверждаете учётку через госуслуги.
- Переходите в business.max.ru и подтверждаете учётку
- Создаете канал и ботов.
- Если у вас бот с разработкой, то можно обращаться ко мне
Где взять swagger.json для API Max?
Последний доступный с сайта скачал 23.11.2025 - swagger.json, открывать можно - editor.swagger.io.
Не передается параметр
window.WebApp.initDataUnsafe.start_param
Ни через кнопку:
'attachments' => [ ['type' => 'inline_keyboard', 'payload' => ['buttons' => [[['text' => 'Проверка!!', 'type'=>'open_app', 'web_app' => 'id616301431999_bot', 'payload'=>'chat%3E123']]]]]]Ни через диплинк:
https://max.ru/id616301431999_bot?startapp=chat%3E123
Решение:
Если использовать любой из недопустимых символов, то параметр не передается! Совсем! Без сообщения об ошибке!
Разрешены: A-Za-z0-9_-
https://max.ru/id616301431999_bot?startapp=setting_chat_-69749299898981При ответе, пожалуйста, сохраните тему письма На ваше обращение поступил ответ: Добрый день!
Бот не получает сообщения в групповом чате на webhook
В мессенджере MAX боты по умолчанию работают в режиме приватности. Это означает, что без прав администратора в групповом чате бот «видит» и получает через Webhook только те сообщения, которые адресованы лично ему через упоминание - @.
Полезные ссылки
- Сообщество разработчиков ботов в МАКС
- Наши телеграм-боты
- Антиспам бот для MAKC здесь
- Почтальон бот - пересылка сообщений в телеграм из мессенджера MAKC в телеграмм
.
Прокомментировать/Отблагодарить