Ответы по условиям: заглушка, которая ведёт себя как настоящий сервер

Вкладка «Ответы» на hook.csap.ru: заглушка из записанного ответа вашего сервера, правила фразой «Когда … сделать …», заготовки 200 OK, ошибка 500 и задержка, проверка подписи ЮKassa и Робокассы с ответом 401.

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

  • заглушка
  • ответы
  • правила
  • тестирование вебхуков
  • подпись
  • mock
  • повторы
Карточка запроса в hook.csap.ru: блок «Ответ цели» с кнопкой «Сделать заглушку» и список ответов фразами

Что сделает ваш код, если платёжка ответит на уведомление 500? А если ответ придёт через 28 секунд? А если кто-то пришлёт уведомление с чужой подписью? На боевом сервере это не проверить, а заглушка, которая всегда отвечает 200 OK, не умеет ломаться.

Вкладка «Ответы» у адреса приёма на hook.csap.ru делает из адреса сервер с характером: на одни запросы отвечать так, на другие иначе, на третьи не отвечать вовсе. Начать стоит с самого полезного трюка: снять точный ответ боевого сервера и превратить его в заглушку одним нажатием.

Записать ответ сервера и получить заглушку

Боевой обработчик отвечает платёжке сложным JSON, и тестовому контуру нужна его точная копия без обращения к боевому серверу. Рукописная заглушка расходится с настоящей через неделю. Записанная — нет.

  1. В «Ответах» заведите ответ «Переслать на сервер» с адресом боевого обработчика (есть заготовка). Отправитель получает ответ вашего сервера, а сервис записывает в карточку запроса ответ цели: код, заголовки и тело.
  2. Откройте карточку запроса в ленте, блок «Ответ цели». Под ним кнопка «Сделать заглушку» с пояснением: «Новый ответ в «Ответах» с этим кодом и телом: сервис будет отвечать так же, не обращаясь к вашему серверу».
  3. Открывается форма «Новый ответ, первым в списке», уже заполненная: название «Заглушка 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. Два ответа:

  1. «ВКонтакте: подтверждение»: когда JSON-поле type равно confirmation → ответить 200, тип «Текст», тело a1b2c3d4 (ваша строка).
  2. «ВКонтакте: остальные события»: когда JSON-поле type существует → ответить 200, тип «Текст», тело ok.

Порядок обязателен: второй ответ совпадает и с подтверждением, и, стой он первым, до первого дело бы не дошло. Всё, у чего поля type нет, получит ответ адреса по умолчанию. Пример события confirmation есть в каталоге тестовых событий адреса («Прислать пример» → ВКонтакте), его можно прислать себе одной кнопкой и сразу проверить оба ответа.

Условий у ответа может быть несколько, связь между ними «все» или «любое», любое обращается операцией «НЕ». Вложенных групп нет: два разных набора условий — это два ответа в списке, и порядок решает, какой сработает. Видов одиннадцать:

УсловиеОперацииПример
Всегдавсегда (в форме без условий: «На любой запрос»)
Методравнометод равно POST
Путьравно, содержит, начинается с, заканчивается на, регэксппуть начинается с /yookassa/
Заголовоксуществует, равно, содержит, начинается с, заканчивается на, регэкспзаголовок X-Shop-Id равно 42
Параметр запросате жепараметр запроса key равно abc
Телосодержит, равно, начинается с, заканчивается на, регэксптело содержит "event":"payment.succeeded"
JSON-полесуществует и те же; путь order.items[0].skuJSON-поле object.status равно succeeded
Поле формыте же; ключ как у отправителя: leads[status][0][id]поле формы OutSum равно 1490.00
XML-полете же; XPath /order/@id, /order/item[2]/skuXML-поле /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».

Ещё по теме

Адрес приёма и ответы доступны без регистрации на hook.csap.ru, тарифы — на странице тарифов.

Проверено 24.10.2026 на стенде сервиса hook.csap.ru версии 1.37.0: ответы, проверка на запросе, прокси и заглушка настоящие, снимки оттуда же.

Все руководства
Строка доставки в ленте hook.csap.ru: повтор 3, ответ 502, следующая попытка через 3 минуты

Вебхук пришёл, а ваш сервер лежал: пересылка с повторами

Битрикс24 не повторяет вебхук, Тильда даёт две минуты, amoCRM отключает хук. Как принять событие на постоянный адрес, ответить отправителю сразу и досылать копию на свой сервер с повторами и журналом каждой попытки.

  • пересылка
  • повторы
  • доставка вебхуков
  • надёжность
  • битрикс24
  • тильда
  • amocrm
Вкладка «Пересылка» в hook.csap.ru: три получателя одного адреса с разными условиями и состоянием доставок

Один вебхук, несколько систем: пересылка в CRM, n8n и свой сервер без кода

Как отправить один вебхук сразу в CRM, n8n и на свой сервер: получатели на одном адресе приёма, отбор по условиям, JSON по шаблону из формы Тильды, свой ключ API в заголовке и ограничение частоты для распродаж.

  • пересылка
  • несколько получателей
  • n8n
  • тильда
  • шаблон
  • интеграции
  • автоматизация
Cookie и Яндекс Метрика

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