Вебхук бота MAX: подписка, секрет и сертификат Минцифры

Вебхук бота MAX по шагам: сертификат Минцифры для platform-api2, подписка с секретом, код на Python, PHP и Node.js, настоящие события и повторы доставки.

Опубликовано 21 минута чтения

  • max
  • боты
  • вебхуки
  • max bot api
  • localhost
  • туннель
  • сертификаты
Обложка: вебхук бота MAX — заголовок X-Max-Bot-Api-Secret и повтор с тем же mid

Бот MAX получает события вебхуком: MAX отправляет POST с JSON на ваш HTTPS-адрес на порту 443 и ждёт ответ 200 не дольше 30 секунд. Для работающего вебхука нужны три вещи:

  1. Корневой сертификат Минцифры. Документация MAX велит перейти на platform-api2.max.ru, а его сертификат выдан российским удостоверяющим центром. Без корня Минцифры не пройдут ни подписка, ни отправка сообщений.
  2. Подписка с секретом. POST /subscriptions с полями url, update_types и secret. Секрет приходит в заголовке X-Max-Bot-Api-Secret каждого события — по нему обработчик отличает MAX от постороннего.
  3. Публичный HTTPS-адрес. На localhost MAX не отправит. Для отладки подойдёт адрес приёма на hook.csap.ru с туннелем на ваш компьютер.

Подписка, события и повтор доставки проверены 17.10.2026 на настоящем боте MAX, сертификат — для curl, Python, PHP и Node.js; правила повторов и отписки — по документации MAX.

Что понадобится

  • Бот MAX и его токен. Ботов создают на платформе MAX для партнёров: нужен проверенный профиль организации, ИП или самозанятого — резидента России, бот проходит модерацию. Токен — на business.max.ru/self: «Чат-боты» → ⋮ → «Настройки».
  • Аккаунт на hook.csap.ru и CLI webhooks. Адрес приёма выдаётся и без регистрации, туннель — после входа. На бесплатном тарифе — один адрес, одна сессия туннеля и 500 запросов в месяц.
  • Python 3, PHP 7.4+ или Node.js 18+ — обработчик дан на всех трёх, без сторонних библиотек.

Шаг 1. Сертификат Минцифры для platform-api2.max.ru

Документация MAX велит отправлять запросы на platform-api2.max.ru вместо platform-api.max.ru и добавить сертификат Минцифры в доверенные. Цепочки у доменов разные:

ДоменКем выдан сертификат
platform-api.max.ru (старый)HARICA — международный центр, есть в любой ОС
platform-api2.max.ruRussian Trusted Sub CA → Russian Trusted Root CA (Минцифры)

На сервере с Ubuntu без этого корня запрос к новому домену падает:

код
$ curl https://platform-api2.max.ru/me
curl: (60) SSL certificate problem: unable to get local issuer certificate

Python сообщает о той же ошибке: CERTIFICATE_VERIFY_FAILED … unable to get local issuer certificate.

Ставится только корневой сертификат. Промежуточный MAX отдаёт сам, внутри цепочки; с одним корнем проверка проходит. Ставить промежуточный вручную не нужно и вредно: его перевыпускают. Сейчас platform-api2.max.ru отдаёт промежуточный сертификат со сроком до 2029 года, а в старой копии файла russian_trusted_sub_ca_pem.crt срок — март 2027-го.

Ubuntu и Debian

bash
sudo curl -fsSL -o /usr/local/share/ca-certificates/russian_trusted_root_ca.crt \
  https://gu-st.ru/content/lending/russian_trusted_root_ca_pem.crt
sudo update-ca-certificates

Сверьте отпечаток — подменённый «корень» хуже, чем никакого:

bash
openssl x509 -in /usr/local/share/ca-certificates/russian_trusted_root_ca.crt \
  -noout -subject -enddate -fingerprint -sha256
код
subject=C = RU, O = The Ministry of Digital Development and Communications, CN = Russian Trusted Root CA
notAfter=Feb 27 21:04:15 2032 GMT
sha256 Fingerprint=D2:6D:2D:02:31:B7:C3:9F:92:CC:73:85:12:BA:54:10:35:19:E4:40:5D:68:B5:BD:70:3E:97:88:CA:8E:CF:31

Проверка: код 401 вместо ошибки сертификата значит, что TLS пройден и MAX ждёт токен.

bash
curl -s -o /dev/null -w "%{http_code}\n" https://platform-api2.max.ru/me

В Docker-образе на Debian или Ubuntu — те же действия при сборке: файл в /usr/local/share/ca-certificates/, затем update-ca-certificates; в slim-образах сначала установите пакет ca-certificates.

Где системного хранилища недостаточно

Системное хранилище видят curl, PHP (curl_*) и стандартная библиотека Python. Две популярные среды его не видят и падают даже после update-ca-certificates:

СредаОшибкаРешение
Python requests из pip (виртуальное окружение)SSLError: у requests свой набор сертификатов certifiREQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt или verify="/путь/russian_trusted_root_ca.crt"
Node.js (fetch, https)UNABLE_TO_GET_ISSUER_CERT_LOCALLY, в fetch видно только fetch failedNODE_EXTRA_CA_CERTS=/путь/russian_trusted_root_ca.crt при запуске

requests из пакета Ubuntu (python3-requests) смотрит в системное хранилище и работает сразу. Отсюда частое «локально работает, на сервере — нет»: локально стоит пакет из apt, на сервере — из pip.

Не отключайте проверку — verify=False, NODE_TLS_REJECT_UNAUTHORIZED=0, curl -k. Токен бота уйдёт любому, кто окажется между вами и MAX.

Шаг 2. Обработчик вебхука: Python, PHP, Node.js

Секрет придумываете вы: от 5 до 256 символов A-Z, a-z, 0-9, _ и -. Сгенерируйте его один раз и сохраните в файл: обработчик, проверка из шага 3 и подписка из шага 5 должны видеть одно и то же значение, а $(openssl rand -hex 32) в новом терминале даст другое.

bash
export MAX_BOT_TOKEN='токен бота'
openssl rand -hex 32 > .max_secret   # один раз
export MAX_WEBHOOK_SECRET=$(cat .max_secret)   # в каждом терминале

Обработчик делает пять вещей:

  • Сверяет секрет за постоянное время (hmac.compare_digest, hash_equals, timingSafeEqual), а не через ==: время сравнения не должно подсказывать, сколько символов совпало. Нет заголовка или он чужой — 403.
  • Отвечает 400 на битое тело и на JSON, который не объект. MAX повторит и 400, но в ленте и журнале сразу видно, что виноват запрос, а не обработчик.
  • Отвечает 200 до тяжёлой работы (Python и Node.js; PHP — в конце, см. ниже). Всё, что дольше 30 секунд или не 200, MAX считает неудачей и повторяет.
  • Отсеивает повторы по mid. Повтор приходит с тем же телом — тем же mid и timestamp.
  • Отвечает на message.recipient.chat_id — это идентификатор диалога с ботом, а не sender.user_id.

Python

bot.py, только стандартная библиотека:

python
import hmac
import json
import logging
import os
import threading
import urllib.request
from collections import OrderedDict
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer

TOKEN = os.environ["MAX_BOT_TOKEN"]
# Та же строка, что в поле secret при подписке.
SECRET = os.environ["MAX_WEBHOOK_SECRET"]
API = "https://platform-api2.max.ru"

logging.basicConfig(level=logging.INFO, format="%(asctime)s %(message)s")
log = logging.getLogger("bot")

seen = OrderedDict()  # последние mid: повтор MAX приходит с тем же mid
seen_lock = threading.Lock()


def first_time(key: str) -> bool:
    with seen_lock:
        if key in seen:
            return False
        seen[key] = True
        if len(seen) > 10_000:
            seen.popitem(last=False)
        return True


def send_text(chat_id: int, text: str) -> None:
    req = urllib.request.Request(
        f"{API}/messages?chat_id={chat_id}",
        data=json.dumps({"text": text}).encode(),
        headers={"Authorization": TOKEN, "Content-Type": "application/json"},
        method="POST",
    )
    with urllib.request.urlopen(req, timeout=10) as resp:
        resp.read()


def handle(update: dict) -> None:
    kind = update.get("update_type")
    try:
        if kind == "bot_started":
            send_text(update["chat_id"], "Привет! Напишите что-нибудь — повторю.")
        elif kind == "message_created":
            msg = update["message"]
            if not first_time(msg["body"]["mid"]):
                log.info("повтор %s, пропускаю", msg["body"]["mid"])
                return
            send_text(msg["recipient"]["chat_id"], "Получил: " + msg["body"].get("text", ""))
        else:
            log.info("событие %s", kind)
    except Exception as e:
        log.error("%s: %s", kind, e)


class Webhook(BaseHTTPRequestHandler):
    def do_POST(self):
        got = self.headers.get("X-Max-Bot-Api-Secret", "")
        if not hmac.compare_digest(got.encode(), SECRET.encode()):
            self.send_response(403)
            self.end_headers()
            return
        length = int(self.headers.get("Content-Length", 0))
        try:
            update = json.loads(self.rfile.read(length))
        except ValueError:
            update = None
        if not isinstance(update, dict):
            # Не JSON-объект — 400: в журнале MAX видно, что виноват запрос.
            self.send_response(400)
            self.end_headers()
            return
        # 200 сразу, работа — в фоне: на ответ MAX даёт 30 секунд.
        self.send_response(200)
        self.end_headers()
        threading.Thread(target=handle, args=(update,), daemon=True).start()

    def log_message(self, fmt, *args):
        log.info("%s %s", self.command, args[1] if len(args) > 1 else "")


ThreadingHTTPServer(("127.0.0.1", 8080), Webhook).serve_forever()

Запуск: python3 bot.py.

PHP

bot.php. Каждый запрос PHP живёт в отдельном процессе, общей памяти между запросами нет, поэтому mid хранится в SQLite: повтор упирается в первичный ключ. Тот же приём годится и для рабочего бота на любом языке — с вашей базой вместо SQLite.

php
<?php
// Запуск для отладки: php -S 127.0.0.1:8080 bot.php
$token = getenv('MAX_BOT_TOKEN');
$secret = getenv('MAX_WEBHOOK_SECRET'); // та же строка, что в поле secret

if (!is_string($secret) || $secret === '') {
    http_response_code(500); // секрет не задан — ошибка настройки, а не запроса
    exit;
}
$got = $_SERVER['HTTP_X_MAX_BOT_API_SECRET'] ?? '';
if ($_SERVER['REQUEST_METHOD'] !== 'POST' || !hash_equals($secret, $got)) {
    http_response_code(403);
    exit;
}

$update = json_decode(file_get_contents('php://input'), true);
if (!is_array($update)) {
    http_response_code(400);
    exit;
}

// Каждый запрос PHP — отдельный процесс, поэтому mid храним в SQLite:
// повтор MAX приходит с тем же mid и упирается в первичный ключ.
$db = new PDO('sqlite:' . __DIR__ . '/max_seen.sqlite');
$db->exec('CREATE TABLE IF NOT EXISTS seen (mid TEXT PRIMARY KEY)');

function send_text(string $token, int $chatId, string $text): void
{
    $ch = curl_init('https://platform-api2.max.ru/messages?chat_id=' . $chatId);
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_HTTPHEADER => ['Authorization: ' . $token, 'Content-Type: application/json'],
        CURLOPT_POSTFIELDS => json_encode(['text' => $text], JSON_UNESCAPED_UNICODE),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 10,
    ]);
    $body = curl_exec($ch);
    $code = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    $err = curl_error($ch);
    curl_close($ch);
    if ($body === false || $code !== 200) {
        error_log("send_text: HTTP $code $err");
    }
}

switch ($update['update_type'] ?? '') {
    case 'bot_started':
        send_text($token, $update['chat_id'], 'Привет! Напишите что-нибудь — повторю.');
        break;
    case 'message_created':
        $msg = $update['message'];
        $ins = $db->prepare('INSERT OR IGNORE INTO seen (mid) VALUES (?)');
        $ins->execute([$msg['body']['mid']]);
        if ($ins->rowCount() === 0) {
            error_log('повтор ' . $msg['body']['mid'] . ', пропускаю');
            break;
        }
        send_text($token, $msg['recipient']['chat_id'], 'Получил: ' . ($msg['body']['text'] ?? ''));
        break;
    default:
        error_log('событие ' . ($update['update_type'] ?? '?'));
}

http_response_code(200);

Ответ пользователю здесь уходит до ответа MAX, поэтому CURLOPT_TIMEOUT — 10 секунд: с запасом меньше 30.

Node.js

bot.mjs, без зависимостей:

javascript
import http from "node:http";
import { timingSafeEqual } from "node:crypto";

const TOKEN = process.env.MAX_BOT_TOKEN;
// Та же строка, что в поле secret при подписке.
const SECRET = Buffer.from(process.env.MAX_WEBHOOK_SECRET);
const API = "https://platform-api2.max.ru";

const seen = new Set(); // последние mid: повтор MAX приходит с тем же mid

function firstTime(mid) {
  if (seen.has(mid)) return false;
  seen.add(mid);
  if (seen.size > 10_000) seen.delete(seen.values().next().value);
  return true;
}

function secretOk(got) {
  const b = Buffer.from(got ?? "");
  return b.length === SECRET.length && timingSafeEqual(b, SECRET);
}

async function sendText(chatId, text) {
  const res = await fetch(`${API}/messages?chat_id=${chatId}`, {
    method: "POST",
    headers: { Authorization: TOKEN, "Content-Type": "application/json" },
    body: JSON.stringify({ text }),
    signal: AbortSignal.timeout(10_000),
  });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
}

async function handle(update) {
  const kind = update.update_type;
  if (kind === "bot_started") {
    await sendText(update.chat_id, "Привет! Напишите что-нибудь — повторю.");
  } else if (kind === "message_created") {
    const { mid, text = "" } = update.message.body;
    if (!firstTime(mid)) return console.log(`повтор ${mid}, пропускаю`);
    await sendText(update.message.recipient.chat_id, `Получил: ${text}`);
  } else {
    console.log(`событие ${kind}`);
  }
}

http
  .createServer((req, res) => {
    if (req.method !== "POST" || !secretOk(req.headers["x-max-bot-api-secret"])) {
      res.writeHead(403).end();
      return;
    }
    let body = "";
    req.setEncoding("utf8");
    req.on("data", (chunk) => (body += chunk));
    req.on("end", () => {
      let update;
      try {
        update = JSON.parse(body);
      } catch {
        update = null;
      }
      if (!update || typeof update !== "object") {
        res.writeHead(400).end();
        return;
      }
      // 200 сразу, работа — после ответа: на ответ MAX даёт 30 секунд.
      res.writeHead(200).end();
      handle(update).catch((e) => console.error(`${update.update_type}: ${e.cause?.code ?? e.message}`));
    });
  })
  .listen(8080, "127.0.0.1");

Запуск — обязательно с корнем Минцифры:

bash
NODE_EXTRA_CA_CERTS=/usr/local/share/ca-certificates/russian_trusted_root_ca.crt node bot.mjs

Без переменной отправка падает с UNABLE_TO_GET_ISSUER_CERT_LOCALLY; e.cause?.code в журнале нужен, чтобы увидеть именно эту причину, а не безликое fetch failed.

seq в JavaScript портится. В теле сообщения есть поле seq, например 117454973278766335. Это больше Number.MAX_SAFE_INTEGER (9007199254740991), и JSON.parse в Node.js превращает его в 117454973278766340. Python читает число точно, PHP — на 64-битной системе. Для отсева повторов и ссылок на сообщение берите строковый mid.

Шаг 3. Проверка без MAX

Запустите обработчик и отправьте одно событие дважды, затем с чужим секретом и без него:

bash
B='{"update_type":"message_created","timestamp":1792220851000,"message":{"recipient":{"chat_type":"dialog","chat_id":70000001},"body":{"mid":"mid.test-1","text":"1"}}}'
for i in 1 2; do
  curl -s -o /dev/null -w "доставка $i → %{http_code}\n" -X POST \
    -H "X-Max-Bot-Api-Secret: $MAX_WEBHOOK_SECRET" -d "$B" http://127.0.0.1:8080/
done
curl -s -o /dev/null -w "чужой секрет → %{http_code}\n" -X POST \
  -H "X-Max-Bot-Api-Secret: nope" -d "$B" http://127.0.0.1:8080/
curl -s -o /dev/null -w "без секрета → %{http_code}\n" -X POST -d "$B" http://127.0.0.1:8080/
curl -s -o /dev/null -w "битое тело → %{http_code}\n" -X POST \
  -H "X-Max-Bot-Api-Secret: $MAX_WEBHOOK_SECRET" -d '{не json' http://127.0.0.1:8080/

Все три обработчика отвечают одинаково:

код
доставка 1 → 200
доставка 2 → 200
чужой секрет → 403
без секрета → 403
битое тело → 400

В журнале у второй доставки — повтор mid.test-1, пропускаю. С ненастоящим токеном или в выдуманный чат отправка закончится ошибкой HTTP от MAX (HTTP Error 401: Unauthorized и подобные). Это нормально; плохо, если вместо неё ошибка сертификата — тогда вернитесь к шагу 1.

Шаг 4. Адрес и туннель

bash
webhooks login
webhooks endpoints create
webhooks tunnel --endpoint <токен адреса> --target http://127.0.0.1:8080

endpoints create печатает адрес приёма https://hook.csap.ru/t/<токен>. На бесплатном тарифе адрес один: если он уже есть, возьмите его токен из webhooks endpoints. Туннель печатает туннель открыт: <токен> → http://127.0.0.1:8080 и пишет строку на каждый запрос. Цель — 127.0.0.1, тот же адрес, который слушает обработчик. Белый IP, проброс портов и свой сертификат не нужны: туннель — исходящее соединение с вашей машины.

Шаг 5. Подписка на вебхук: POST /subscriptions

bash
curl -X POST https://platform-api2.max.ru/subscriptions \
  -H "Authorization: $MAX_BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://hook.csap.ru/t/<токен>",
    "update_types": ["bot_started", "bot_stopped", "message_created",
                     "message_edited", "message_removed", "dialog_removed"],
    "secret": "'"$MAX_WEBHOOK_SECRET"'"
  }'

Ответ — {"success":true}. Токен передаётся только заголовком Authorization: в адресе запроса MAX его больше не принимает.

Список подписок — GET /subscriptions. Секрета в ответе нет, храните его сами:

json
{"subscriptions":[{"url":"https://hook.csap.ru/t/<токен>","time":1792220528628,
  "update_types":["bot_stopped","message_removed","message_created","bot_started","message_edited","dialog_removed"]}]}

Подписка добавляется, а не заменяет прежнюю. У бота, подписанного на рабочий сервер, после POST /subscriptions в списке стало две подписки, и одно сообщение пришло на оба адреса. Рабочий бот не ломается, но оба обработчика получают каждое событие и оба могут ответить пользователю. Поэтому отладочную подписку снимайте сразу после проверки, а ответы бота отлаживайте на отдельном боте.

Пока у бота есть хотя бы одна подписка, GET /updates (long polling) не работает.

Шаг 6. Проверка вживую

Напишите боту в MAX. Туннель напечатает строку с ответом обработчика, бот ответит «Получил: …». (В проверке ответы уходили через platform-api.max.ru; platform-api2.max.ru проверен тем же токеном запросом GET /me.) Само событие видно в ленте адреса вместе с заголовками:

Снято на локальном стенде сервиса той же версии, что hook.csap.ru: настоящие тело и заголовки события MAX от 17.10.2026, имя и номера заменены.

Отладочную подписку после проверки снимите:

bash
curl -X DELETE "https://platform-api2.max.ru/subscriptions?url=https://hook.csap.ru/t/<токен>" \
  -H "Authorization: $MAX_BOT_TOKEN"

Какие события присылает MAX

Каждое событие — POST, Content-Type: application/json; charset=UTF-8, User-Agent: OneMe/0.1.10 Bot API. Тип — в update_type, время — timestamp в миллисекундах.

Что сделал человекupdate_typeГде chat_id
Написал ботуmessage_createdmessage.recipient.chat_id
Исправил сообщениеmessage_editedmessage.recipient.chat_id
Нажал «Начать»bot_startedchat_id
Удалил чат с ботомdialog_removed и/или bot_stoppedchat_id

message_created (имя и номера пользователя и чата заменены):

json
{
  "message": {
    "recipient": {"chat_type": "dialog", "chat_id": 70000001, "user_id": 480000001},
    "timestamp": 1792220661602,
    "body": {"mid": "mid.00000000043211e901a148ad076244ff", "seq": 117454973278766335, "text": "Test"},
    "sender": {"user_id": 410000001, "first_name": "Анна", "is_bot": false, "last_name": "",
               "last_activity_time": 1792220661000, "name": "Анна"}
  },
  "timestamp": 1792220661602,
  "user_locale": "ru",
  "update_type": "message_created"
}

recipient.user_id — сам бот, sender — человек.

message_edited — тот же mid, новый text, новый верхний timestamp; поля user_locale нет. Обработчик, который отсеивает повторы по mid, должен смотреть на update_type: правка — не повтор.

bot_started:

json
{
  "chat_id": 70000001,
  "user": {"user_id": 410000001, "first_name": "Анна", "is_bot": false, "last_name": "",
           "last_activity_time": 1792220998000, "name": "Анна"},
  "timestamp": 1792220997707,
  "user_locale": "ru",
  "update_type": "bot_started"
}

Если человек пришёл по ссылке max.ru/<бот>?start=<параметр>, параметр, по описанию API, приходит в поле payload (вживую не снималось); у ссылки без параметра поля нет.

Удаление чата. По документации приходят и dialog_removed, и bot_stopped. На проверке за два удаления пришло по одному: сначала только dialog_removed, потом только bot_stopped. Считайте любое из них сигналом «человек ушёл».

Повторы доставки: что делает MAX, если обработчик не ответил

Проверка на настоящем боте: человек пишет «1», а обработчик не отвечает — первая доставка в 12:07:31 получила от hook.csap.ru 504. Через 71 секунду, в 12:08:42, пришёл повтор; к этому времени обработчик был запущен и ответил через туннель:

код
12:08:44 5937b7cd POST    / → 200 (4ms)

(Время в строке туннеля — момент ответа, по местным часам машины с CLI.)

Повтор и первая доставка различаются только ответом — заголовки и все поля JSON совпадают:

Пара повторена на локальном стенде с настоящими телами MAX; на стенде первая доставка получила 502 — обработчик был выключен.

По документации повторов до 10, интервалы растут: 60, 150, 375 секунд и дальше. Если 8 часов подряд нет ответа 200, MAX снимает подписку сам — события перестают приходить без единой ошибки на вашей стороне. Бот замолчал после простоя сервера — первым делом GET /subscriptions.

Чужой секрет выглядит в ленте так: запрос дошёл, обработчик ответил 403, событие не обработано.

С localhost на сервер

  • В подписке — адрес вашего сервера, отладочная подписка снята (DELETE).
  • Корень Минцифры — на сервере и в Docker-образе; для requests из pip и Node.js — переменная из таблицы шага 1.
  • Секрет — в переменной окружения или хранилище секретов, не в коде.
  • mid — в базе под уникальным ключом: повторы приходят и после перезапуска процесса.
  • Проверка подписки по расписанию: если адреса сервера нет в GET /subscriptions, подписку сняли — вручную или сам MAX после 8 часов без ответа 200.

Симптом → причина

СимптомПричинаПроверка
CERTIFICATE_VERIFY_FAILED, curl: (60), UNABLE_TO_GET_ISSUER_CERT_LOCALLYНет корня Минцифры для platform-api2.max.ruШаг 1, таблица «Где системного хранилища недостаточно»
Бот молчит, в ленте пустоПодписка снята после 8 часов неудач или стоит на другом адресеGET /subscriptions
Запросы в ленте, обработчик отвечает 403Секрет в подписке и в MAX_WEBHOOK_SECRET разныйЗаголовок X-Max-Bot-Api-Secret в ленте против переменной
Одно сообщение обработано дваждыПовтор после таймаута или ответа не 200Два запроса с одним mid в ленте
Бот отвечает дваждыУ бота две подписки — например, отладочная и рабочаяGET /subscriptions
401 от APIНеверный токен или токен в адресе: на ?access_token= MAX отвечает Query parameter access_token is deprecated, use Authorization headerGET /me с заголовком Authorization
В туннеле target.unreachableОбработчик не запущен или слушает другой адрес и портcurl -X POST http://127.0.0.1:8080 — любой HTTP-ответ, даже 403, значит, что обработчик слушает
В Node.js seq не совпадает с тем, что в лентеЧисло больше 2^53, JSON.parse его округлилОпирайтесь на mid

Вопросы

Можно ли получать события бота MAX без вебхука? Да, через GET /updates (long polling) — но только пока у бота нет ни одной подписки.

Нужен ли platform-api2.max.ru, если platform-api.max.ru ещё отвечает? Документация MAX велит перейти на platform-api2.max.ru. Корень Минцифры лучше поставить заранее: без него переход сломает и отправку, и подписку.

Почему бот работал, а потом перестал получать события? Если адрес 8 часов не отвечал 200, MAX снял подписку. Проверьте GET /subscriptions и подпишитесь заново.

Можно ли отлаживать на рабочем боте? Можно: отладочная подписка добавится рядом с рабочей, рабочая продолжит получать события. Но ответы пользователю отправят оба обработчика — для отладки ответов нужен отдельный бот.

Где взять заголовок X-Max-Bot-Api-Secret? Его значение — поле secret из вашего POST /subscriptions. По документации заголовок передаётся, только если секрет задан при подписке; без него отличить MAX от постороннего запроса нечем.

Ещё по теме

Все руководства
HTTP-уведомление ЮKassa в ленте hook.csap.ru

Не приходят HTTP-уведомления ЮKassa: где теряется вебхук и как это проверить

Не приходят уведомления ЮKassa? Симптомы и причины, проверка адреса, TLS и кода ответа, повторы до 24 часов и обработчик, который не отметит заказ дважды.

  • юkassa
  • http-уведомления
  • вебхуки
  • платежи
  • отладка
Cookie и Яндекс Метрика

Мы хотим подключить Яндекс Метрику: она ставит cookie и помогает понять, как посетители пользуются сайтом. Метрика заработает, только если вы разрешите. Без неё сервис работает так же. Политика обработки данных