Ответы по условиям: заглушка, которая ведёт себя как настоящий сервер
Вкладка «Ответы» на hook.csap.ru: заглушка из записанного ответа вашего сервера, правила фразой «Когда … сделать …», заготовки 200 OK, ошибка 500 и задержка, проверка подписи ЮKassa и Робокассы с ответом 401.
Опубликовано 13 минут чтения
- заглушка
- ответы
- правила
- тестирование вебхуков
- подпись
- mock
- повторы
Что сделает ваш код, если платёжка ответит на уведомление 500? А если ответ придёт через 28 секунд? А если кто-то пришлёт уведомление с чужой подписью? На боевом сервере это не проверить, а заглушка, которая всегда отвечает 200 OK, не умеет ломаться.
Вкладка «Ответы» у адреса приёма на hook.csap.ru делает из адреса сервер с характером: на одни запросы отвечать так, на другие иначе, на третьи не отвечать вовсе. Начать стоит с самого полезного трюка: снять точный ответ боевого сервера и превратить его в заглушку одним нажатием.
Записать ответ сервера и получить заглушку
Боевой обработчик отвечает платёжке сложным JSON, и тестовому контуру нужна его точная копия без обращения к боевому серверу. Рукописная заглушка расходится с настоящей через неделю. Записанная — нет.
- В «Ответах» заведите ответ «Переслать на сервер» с адресом боевого обработчика (есть заготовка). Отправитель получает ответ вашего сервера, а сервис записывает в карточку запроса ответ цели: код, заголовки и тело.
- Откройте карточку запроса в ленте, блок «Ответ цели». Под ним кнопка «Сделать заглушку» с пояснением: «Новый ответ в «Ответах» с этим кодом и телом: сервис будет отвечать так же, не обращаясь к вашему серверу».
- Открывается форма «Новый ответ, первым в списке», уже заполненная: название «Заглушка POST /crm/orders», условия — тот же метод и путь, действие — ответить с кодом, типом, телом и теми заголовками цели, которые отправителю доходят. Первым в списке — иначе его перекрыл бы прокси, из которого он сделан. В «Проверить на запросе» уже выбран тот самый запрос: проверьте и сохраните.
Тело цели сохраняется до 64 КБ; если оно не сохранилось, кнопки нет, и карточка объясняет почему. Дальше ответ правится как любой другой: код 500 вместо 200, задержка перед ним, условие «только для суммы больше 10 000». Так из одного записанного ответа получается целый набор сценариев для тестов.
Как адрес решает, что ответить
Список в «Ответах» — фразы сверху вниз, над ним так и написано: «Проверяются сверху вниз, срабатывает первый подходящий». «Если json-поле type равно confirmation → ответить 200», «Если путь начинается с /crm/ → вернуть ответ сервера crm.example.ru», «Если json-поле type существует → ответить 200». Последняя строка всегда одна и та же: «Иначе → ответ адреса по умолчанию» — для всего, что не подошло ни к одному ответу. Без своих ответов адрес отвечает пустым 200.
Правила проверяются по порядку, применяется первое совпавшее. У каждого ответа есть выбор, что делать дальше: «Остановиться» (обычно) или «Проверять следующие», если ниже стоит, например, задержка. Ответ выключается переключателем «Включён | Выключен», а не удаляется: настроенная работа остаётся. В форме ответ читается фразой «Когда … сделать … затем …». Дайте ответам названия: в списке и в итоге проверки видно «ВКонтакте: подтверждение», а не «ответ № 1».
Сломать по-настоящему: три опыта
Форма нового ответа начинается с ряда кнопок «Начать с заготовки»: «Ответить 200 OK», «Вернуть ошибку 500», «Задержать ответ», «Переслать на свой сервер». Нажатие заполняет форму, сохраняете вы. Две заготовки и одно действие формы — готовые опыты над отправителем.
Опыт 1. Повторит ли он. Заготовка «Вернуть ошибку 500»: на любой запрос 500, тело {"error": "test"}. Впишите адрес приёма в настройки отправителя — лучше тестовой интеграции, а не боевой — и вызовите событие. Каждая повторная попытка придёт в ленту отдельным запросом со своим временем, и расписание повторов будет видно без документации. Например, amoCRM по своей документации повторяет через 5 минут, 15, ещё 15 и через час, а набрав больше ста неуспешных ответов за два часа, отключает хук: поэтому на боевом хуке такой опыт не ставят. Посмотрели — переключите ответ на «Выключен», и следующее событие получит 200.
Опыт 2. Сколько он ждёт. Заготовка «Задержать ответ»: подождать 10 секунд, потом 200. amoCRM по документации ждёт две секунды, Тильда — пять, так что обе уйдут раньше. Дальше лента покажет, как отправитель поступил: прислал повтор или замолчал. У многих провайдеров срок ожидания в документации не назван вовсе, и опыт с задержкой — простой способ его прикинуть. Наибольшая задержка зависит от тарифа, форма показывает предел.
Опыт 3. Как он переживает тишину. Действие «Оборвать соединение» (его добавляют в форме кнопкой «+ Оборвать соединение»): ответа нет вовсе, в ленте у запроса «нет ответа». Самая честная имитация лежащего сервера, честнее любого 5xx.
Заготовка «Ответить 200 OK» нужна в обратной ситуации: сервис ждёт именно 200 с телом, иначе повторяет или отключает хук, а свой сервер ещё не написан. «Переслать на свой сервер» — начало записи ответа для заглушки, о ней выше.
Разные ответы разным запросам
Пример, где без условий не обойтись: Callback API ВКонтакте. При подключении сервера ВКонтакте присылает {"type": "confirmation", "group_id": …} и ждёт в ответ строку подтверждения из настроек сообщества, а на все остальные события — ok. Два ответа:
- «ВКонтакте: подтверждение»: когда JSON-поле
typeравноconfirmation→ ответить 200, тип «Текст», телоa1b2c3d4(ваша строка). - «ВКонтакте: остальные события»: когда JSON-поле
typeсуществует → ответить 200, тип «Текст», телоok.
Порядок обязателен: второй ответ совпадает и с подтверждением, и, стой он первым, до первого дело бы не дошло. Всё, у чего поля type нет, получит ответ адреса по умолчанию. Пример события confirmation есть в каталоге тестовых событий адреса («Прислать пример» → ВКонтакте), его можно прислать себе одной кнопкой и сразу проверить оба ответа.
Условий у ответа может быть несколько, связь между ними «все» или «любое», любое обращается операцией «НЕ». Вложенных групп нет: два разных набора условий — это два ответа в списке, и порядок решает, какой сработает. Видов одиннадцать:
| Условие | Операции | Пример |
|---|---|---|
| Всегда | всегда (в форме без условий: «На любой запрос») | |
| Метод | равно | метод равно POST |
| Путь | равно, содержит, начинается с, заканчивается на, регэксп | путь начинается с /yookassa/ |
| Заголовок | существует, равно, содержит, начинается с, заканчивается на, регэксп | заголовок X-Shop-Id равно 42 |
| Параметр запроса | те же | параметр запроса key равно abc |
| Тело | содержит, равно, начинается с, заканчивается на, регэксп | тело содержит "event":"payment.succeeded" |
| JSON-поле | существует и те же; путь order.items[0].sku | JSON-поле object.status равно succeeded |
| Поле формы | те же; ключ как у отправителя: leads[status][0][id] | поле формы OutSum равно 1490.00 |
| XML-поле | те же; XPath /order/@id, /order/item[2]/sku | XML-поле /order/@id существует |
| IP отправителя | равно адресу или подсети | IP отправителя равно 203.0.113.0/24 |
| Подпись провайдера | верна, не сошлась, нет данных | НЕ подпись провайдера верна |
Путь к JSON-полю не нужно набирать: в карточке запроса у каждой строки дерева тела кнопка «Путь» копирует его в виде, который понимает условие. Поле формы называется так, как его назвал отправитель, в том числе со скобками amoCRM и Битрикс24.
В «сделать» — действия по порядку: «Ответить» (код, тип тела — JSON, текст, XML, HTML, форма или свой — и тело), «Ответить по шаблону» с подстановками из запроса ({{ json.order.id }}, {{ form.InvId }}, {{ uuid }}, {{ now }}: ответ «эхом» на ваш же номер заказа — один шаблон), «Подождать», «Переслать на сервер» и «Оборвать соединение». Заголовки ответа задать можно, но не любые: Set-Cookie, Location, политики безопасности и заголовки соединения отправителю не уходят, и ответ с ними не сохранится, чтобы не обещать того, чего не будет. Content-Type, Cache-Control, Retry-After, Access-Control-* и свои X-* проходят.
Чужим — 401
У кнопки «Проверка подписи» в «Ответах» выбирается провайдер (ЮKassa, Робокасса, Т-Банк, Битрикс24, Telegram, GitHub) и вставляется секрет из его кабинета. С этого момента сервис считает подпись каждого входящего запроса, а в карточке запроса появляется строка «Подпись: верна / не сошлась / нет данных». Секрет хранится зашифрованным и после сохранения не показывается.
Условие «Подпись провайдера» превращает это в поведение. Ответ «Когда НЕ подпись провайдера верна → ответить 401» ловит и «не сошлась», и «нет данных»: запрос без подписи получает 401 так же, как запрос с подделанной. На стенде с проверкой Telegram это выглядело так: запрос с верным секретом — 200, с чужим — 401, без секрета — 401. Так адрес отвечает отказом всем, кто не знает секрета, и до вашего сервера за «Переслать на сервер» такой запрос не доходит. Получателей из «Пересылки» это не касается: копии им уходят независимо от ответов, поэтому у получателя для того же есть своё условие «Подпись провайдера».
Как считается подпись у каждого провайдера и где брать секрет: ЮKassa, Робокасса, Битрикс24.
Проверить, не сохраняя
Под формой — «Проверить на запросе»: «Что ответит сервис на запрос из ленты с этими правками, без сохранения». По умолчанию выбран последний запрос из ленты, можно выбрать любой из списка или указать номер. Кнопка «Проверить» показывает, какой ответ сработает и что уйдёт отправителю: для примера confirmation — «Сработает ответ «ВКонтакте: подтверждение»», код 200, тип text/plain; charset=utf-8, задержка 0 мс, тело a1b2c3d4. Ничего никуда не отправляется, набор ещё не сохранён.
Это главный способ не сломать боевой приём опечаткой в условии: сначала проверка на вчерашнем уведомлении ЮKassa, потом «Сохранить».
Прокси или пересылка
«Переслать на сервер» в «Ответах» и получатель во вкладке «Пересылка» выглядят похоже и решают разные задачи.
| «Переслать на сервер» в «Ответах» | Получатель в «Пересылке» | |
|---|---|---|
| Кто отвечает отправителю | ваш сервер: код и тело байт в байт, заголовки через список разрешённых | адрес приёма, по правилам «Ответов» |
| Если сервер не ответил за 30 секунд | отправитель получает 502 и действует по своим правилам | отправитель давно получил 200, копия повторяется в окне тарифа |
| Повторы | нет: отправитель ждёт на линии | есть, по тарифу |
| Когда нужен | ответ вашего сервера важен отправителю: подтверждение ВКонтакте, проверка перед оплатой CloudPayments; запись ответа для заглушки | событие не должно потеряться, ответ отправителю стандартный |
Их можно сочетать: отправитель получает 200 от ответа адреса, а копия с повторами идёт в CRM. Подробно в руководстве о пересылке с повторами.
Что ещё стоит знать
- Пока подключён туннель, ответы не работают: отвечает ваш локальный сервер. Отключили туннель — снова отвечает адрес.
- Ответ сервиса не выполняется в браузере. К каждому ответу адреса добавляются запрещающие заголовки безопасности, поэтому подключить адрес приёма как скрипт, стиль или страницу в рамке нельзя. Для отправителя-машины это ничего не меняет.
- Лимиты. Число ответов на адрес и наибольшая задержка зависят от тарифа, форма показывает предел; подробности на странице тарифов. Регулярное выражение проверяется при сохранении, неверное не сохранится.
- Ответы — не пересылка. Копии на ваши серверы с повторами заводятся во вкладке «Пересылка», независимо от порядка ответов и «Остановиться».
Вопросы
Как сделать заглушку с точным ответом моего сервера? Ответ «Переслать на сервер», затем в карточке запроса под блоком «Ответ цели» кнопка «Сделать заглушку»: форма нового ответа с кодом, телом и заголовками цели, первым в списке.
Как ответить 200 на вебхук Тильды, amoCRM или Битрикс24 без своего сервера? Адрес приёма отвечает пустым 200 без настроек. Нужен свой текст — заготовка «Ответить 200 OK» в «Ответах», тело можно изменить.
Как проверить, повторяет ли отправитель вебхук после ошибки? Заготовка «Вернуть ошибку 500»: адрес отвечает 500 на всё, повторы видны в ленте с временем. Выключите ответ переключателем, когда посмотрели.
Как проверить таймаут отправителя? Заготовка «Задержать ответ»: пауза перед ответом, предел зависит от тарифа. Если отправитель не дождался, лента покажет, прислал ли он повтор.
Можно отвечать по-разному в зависимости от содержимого запроса? Да: условия по методу, пути, заголовку, параметру, телу, JSON-, form- и XML-полю, IP и подписи, с «все / любое» и «НЕ». Правила применяются по порядку сверху вниз, первое совпавшее.
Как отклонять запросы с неверной подписью? Настроить «Проверку подписи» (провайдер и секрет) и завести ответ «Когда НЕ подпись провайдера верна → ответить 401».
Ещё по теме
- Вебхук пришёл, а ваш сервер лежал: пересылка с повторами — копии на ваш сервер с повторами и журналом.
- Один вебхук, несколько систем: пересылка в CRM, n8n и свой сервер без кода — несколько получателей с условиями и шаблонами.
- Робокасса: Result URL, проверка подписи и ошибка 29 — подпись Result URL и ответ
OK<InvId>.
Адрес приёма и ответы доступны без регистрации на hook.csap.ru, тарифы — на странице тарифов.
Проверено 24.10.2026 на стенде сервиса hook.csap.ru версии 1.37.0: ответы, проверка на запросе, прокси и заглушка настоящие, снимки оттуда же.