Перейти к содержимому
Max Guides

Часто ищут

Разделы

Почему не приходят уведомления Webhook?

Обновлено 20 октября 2026 г.2 мин

Webhook не может присылать уведомления, если не работает сервер бота или есть проблемы с сетью

Обратите внимание, с 25 мая для повышения безопасности при получении вебхуков прекращается поддержка самоподписанных сертификатов и передачи данных по HTTP. Используйте HTTPS и сертификаты, удостоверенные доверенными центрами сертификации, в том числе сертификаты Минцифры Подробнее о требованиях безопасности при подключении вебхуков — в описании POST /subscriptions

Проверьте по списку

Заголовок раздела «Проверьте по списку»

Требования ниже — из описания POST /subscriptions.

  1. Подписка жива. Запросите GET /subscriptions. Если 8 часов подряд endpoint не отвечал успешно, бот автоматически отписывается — подпишитесь заново через POST /subscriptions.
  2. Адрес — HTTPS на порту 443. Другие порты не поддерживаются, порт в URL не указывается. HTTP не принимается.
  3. Сертификат. Нужен сертификат доверенного центра или Минцифры, самоподписанный не подойдёт. Домен в URL должен совпадать с CN или SAN, сервер должен отдавать полную цепочку.
  4. Ответ 200 за 30 секунд. Любой другой код или задержка — ошибка доставки. Отвечайте сразу, тяжёлую обработку делайте после.
  5. Нужные типы событий. Проверьте update_types в подписке: например, без bot_started не придут запуски по диплинку (dev.max.ru).
  6. Секрет. Если при подписке указан secret, MAX присылает его в заголовке X-Max-Bot-Api-Secret. Сверьте, что ваш сервер не отклоняет запросы из-за опечатки в значении.
  7. Права в группе или канале. Без права read_all_messages бот не получает обновления через Webhook (dev.max.ru).
  8. Нет параллельного Long Polling. Одновременно оба способа не работают — выберите один.
  9. Правильный домен API. Запросы бота отправляйте на platform-api2.max.ru, токен — в заголовке Authorization (dev.max.ru).

Как MAX повторяет доставку

Заголовок раздела «Как MAX повторяет доставку»

После неудачной доставки MAX делает до 10 повторных попыток с растущим интервалом: через 60 секунд, через 150, через 375 и так далее. Через 8 часов без успешного ответа подписка снимается (POST /subscriptions).

Похожие материалы

Заголовок раздела «Похожие материалы»

Все материалы для разработчиков собраны в разделе «Разработчикам».

Источники

Заголовок раздела «Источники»