Вебхук бота MAX: подписка, секрет и сертификат Минцифры
Вебхук бота MAX по шагам: сертификат Минцифры для platform-api2, подписка с секретом, код на Python, PHP и Node.js, настоящие события и повторы доставки.
Опубликовано 21 минута чтения
- max
- боты
- вебхуки
- max bot api
- localhost
- туннель
- сертификаты
Бот MAX получает события вебхуком: MAX отправляет POST с JSON на ваш HTTPS-адрес на порту 443 и ждёт ответ 200 не дольше 30 секунд. Для работающего вебхука нужны три вещи:
- Корневой сертификат Минцифры. Документация MAX велит перейти на
platform-api2.max.ru, а его сертификат выдан российским удостоверяющим центром. Без корня Минцифры не пройдут ни подписка, ни отправка сообщений. - Подписка с секретом.
POST /subscriptionsс полямиurl,update_typesиsecret. Секрет приходит в заголовкеX-Max-Bot-Api-Secretкаждого события — по нему обработчик отличает MAX от постороннего. - Публичный HTTPS-адрес. На
localhostMAX не отправит. Для отладки подойдёт адрес приёма на 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.ru | Russian 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
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
Сверьте отпечаток — подменённый «корень» хуже, чем никакого:
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 ждёт токен.
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 свой набор сертификатов certifi | REQUESTS_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 failed | NODE_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) в новом терминале даст другое.
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, только стандартная библиотека:
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 -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, без зависимостей:
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");
Запуск — обязательно с корнем Минцифры:
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
Запустите обработчик и отправьте одно событие дважды, затем с чужим секретом и без него:
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. Адрес и туннель
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
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. Секрета в ответе нет, храните его сами:
{"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, имя и номера заменены.
Отладочную подписку после проверки снимите:
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_created | message.recipient.chat_id |
| Исправил сообщение | message_edited | message.recipient.chat_id |
| Нажал «Начать» | bot_started | chat_id |
| Удалил чат с ботом | dialog_removed и/или bot_stopped | chat_id |
message_created (имя и номера пользователя и чата заменены):
{
"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:
{
"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 header | GET /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 от постороннего запроса нечем.
Ещё по теме
- Вебхук n8n на localhost: тестовый и рабочий адрес, туннель — если события бота разбирает n8n.
- Вебхуки Wazzup: сообщения WhatsApp, статусы и защита адреса — WhatsApp через Wazzup: по ключу API подписи нет, защита секретом в адресе.
- Туннель на localhost — как устроен
webhooks tunnelи что он делает с запросами.