Отладка webhook
Сокращает время поиска обрыва webhook-цепочки — от журнала Bitrix24 до nginx и n8n — без senior на каждый инцидент доставки.
Обновлён ·AgentPoint
Бесплатно·Обновлён ·Автор: AgentPoint
Платформы:amoCRM / KommoБитрикс24n8n
Зачем
Исходящий webhook CRM «не работает»: в Bitrix ошибка доставки, на сервере пустые логи, или endpoint отдаёт 502 — непонятно, на каком слое ломается цепочка.
Кому?
Админ или интегратор, когда CRM пишет «ошибка доставки» исходящего webhook.
Подойдёт, если нужно
- Bitrix24/amoCRM webhook не доходит до n8n или API
- 502/504/timeout на webhook endpoint за nginx
- Подпись webhook не проходит (raw body vs JSON parser)
- n8n: Test vs Production URL, workflow не Active
- Проверка SSL/DNS после renew сертификата
Не подойдёт, если нужно
Когда не подойдёт ↓
- Разбора REST 403/429 без webhook-контекста (см. api-error-explainer)
- Pen-test и обхода WAF
- Гарантии root cause без логов провайдера и сервера
- Отправки реальных webhook из demo
- Разбора REST 403/429 без webhook-контекста (см. api-error-explainer)
- Pen-test и обхода WAF
- Гарантии root cause без логов провайдера и сервера
- Отправки реальных webhook из demo
Как пользоваться
- 1
Опишите задачу. Bitrix24 onCrmDealUpdate → https://n8n.myshop.ru/webhook/bitrix-deal (production URL). Workflow Active ON. В Bitrix «ошибка доставки», nginx access log пустой час. SSL Let's Encrypt обновляли 3 дня назад. Чеклист: где обрыв, что проверить по слоям.
- 2
Получите черновик. Express webhook: header X-Webhook-Signature, HMAC-SHA256, всегда 401 Invalid signature. Глобально стоит express.json(). Как проверить подпись и исправить middleware — чеклист без секретов.
- 3
Проверьте результат. POST https://hooks.myshop.ru/bitrix/deal → 502 Bad Gateway. nginx proxy_pass на 127.0.0.1:3000, Node PM2 иногда перезапускается. Чеклист диагностики nginx/upstream/timeout и быстрый 2xx для Bitrix.
Ограничения и данные
Skill проверен модератором перед публикацией в каталоге.
- Работает только с текстом, который вы вставили.
- Не подключается к CRM, мессенджерам, 1С, API или файлам в демо.
- Не вводите пароли, API-ключи и реальные персональные или платёжные данные.
- Переписку и файлы мы не сохраняем в базе данных — они существуют только в открытом окне демо.
- Текст запроса и вложений временно передаётся LLM-провайдеру для генерации ответа.
- Проверяйте результат перед использованием в рабочем процессе.
Для технарей: SKILL.md и экспорт
Установка и экспорт
Скачайте SKILL.md, metadata.json, правило Cursor или адаптер под вашу платформу. Файлы генерируются из текущей версии skill и кешируются в хранилище.
Адаптеры платформ
Частые вопросы
Чем отличается от «Объяснение ошибки API»?
Здесь — пошаговая диагностика доставки webhook по слоям (журнал CRM → TLS → nginx → n8n/приложение). «Объяснение ошибки API» — когда уже известен HTTP-код и тело ответа.
Помощник вызывает мой webhook URL?
Нет. Демо даёт чеклист и команды для вашей локальной проверки. Не вставляйте секреты в URL в публичном демо.
Почему n8n не получает webhook при «успешной» отправке?
Частые причины: Test URL вместо Production, workflow выключен, неверный POST/GET, WEBHOOK_URL env, Function node «съедает» payload. Помощник проверяет это в чеклисте.
Нужен ли HTTPS для Bitrix24?
Да. Исходящие webhook Bitrix24 требуют публичный HTTPS с валидным сертификатом. После renew проверьте полную chain и доступность порта 443.
Нужно ли быть разработчиком?
Нет. Помощник для интегратора или админа: журнал Bitrix24, SSL и nginx — по шагам. Углублённый разбор middleware и HTTP-статусов — в «Объяснение ошибки API»; черновик workflow — в «Черновик workflow n8n».
История
v1.2.2 — F-71: FAQ «Помощник», dev как вторичная аудитория, cross-FAQ API/n8n. v1.2.1 — canonicalExample refresh after prod demo post-publish.
Частые вопросы
Чем отличается от «Объяснение ошибки API»?
Здесь — пошаговая диагностика доставки webhook по слоям (журнал CRM → TLS → nginx → n8n/приложение). «Объяснение ошибки API» — когда уже известен HTTP-код и тело ответа.
Помощник вызывает мой webhook URL?
Нет. Демо даёт чеклист и команды для вашей локальной проверки. Не вставляйте секреты в URL в публичном демо.
Почему n8n не получает webhook при «успешной» отправке?
Частые причины: Test URL вместо Production, workflow выключен, неверный POST/GET, WEBHOOK_URL env, Function node «съедает» payload. Помощник проверяет это в чеклисте.
Нужен ли HTTPS для Bitrix24?
Да. Исходящие webhook Bitrix24 требуют публичный HTTPS с валидным сертификатом. После renew проверьте полную chain и доступность порта 443.
Нужно ли быть разработчиком?
Нет. Помощник для интегратора или админа: журнал Bitrix24, SSL и nginx — по шагам. Углублённый разбор middleware и HTTP-статусов — в «Объяснение ошибки API»; черновик workflow — в «Черновик workflow n8n».
Похожие навыки
Нужно под ваш процесс?
Подстроим навык под ваши офферы, тон и ограничения. Или добавим новый, если такого нет.
Адаптировать под мой бизнес