Отладка webhook
Сокращает время поиска обрыва webhook-цепочки — от журнала Bitrix24 до nginx и n8n — без senior на каждый инцидент доставки.
Обновлён ·AgentPoint
Бесплатно·Обновлён ·Автор: AgentPoint
Платформы:amoCRM / KommoБитрикс24n8n
Зачем
Исходящий webhook CRM «не работает»: в Bitrix ошибка доставки, на сервере пустые логи, или endpoint отдаёт 502 — непонятно, на каком слое ломается цепочка.
Подойдёт, если нужно
- 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.md и экспорт
Установка и экспорт
Скачайте SKILL.md, metadata.json, правило Cursor или адаптер под вашу платформу. Файлы генерируются из текущей версии skill и кешируются в хранилище.
Адаптеры платформ
Частые вопросы
Чем этот skill отличается от api-error-explainer?
webhook-debug-checklist — пошаговая диагностика доставки webhook по слоям (CRM journal → TLS → nginx → n8n/app). api-error-explainer разбирает конкретный HTTP status и body, когда ошибка уже известна.
Skill вызывает мой webhook URL?
Нет. Demo даёт чеклист и команды для вашей локальной проверки. Не вставляйте секреты в URL в public demo.
Почему n8n не получает webhook при «успешной» отправке?
Частые причины: Test URL вместо Production, workflow выключен, неверный POST/GET, WEBHOOK_URL env, Function node «съедает» payload. Skill проверяет это в чеклисте.
Нужен ли HTTPS для Bitrix24?
Да. Исходящие webhook Bitrix24 требуют публичный HTTPS с валидным сертификатом. После renew проверьте полную chain и доступность порта 443.
История
v1.1.0 — expanded SKILL.md: webhook delivery checklist (inbound/outbound, SSL, nginx 502, signature raw body, n8n prod URL), 3 examples. Research: Hook0, Webhookify, n8n community, Bitrix24 RU guides. Completes developer-integrator-pack content expansion.
Частые вопросы
Чем этот skill отличается от api-error-explainer?
webhook-debug-checklist — пошаговая диагностика доставки webhook по слоям (CRM journal → TLS → nginx → n8n/app). api-error-explainer разбирает конкретный HTTP status и body, когда ошибка уже известна.
Skill вызывает мой webhook URL?
Нет. Demo даёт чеклист и команды для вашей локальной проверки. Не вставляйте секреты в URL в public demo.
Почему n8n не получает webhook при «успешной» отправке?
Частые причины: Test URL вместо Production, workflow выключен, неверный POST/GET, WEBHOOK_URL env, Function node «съедает» payload. Skill проверяет это в чеклисте.
Нужен ли HTTPS для Bitrix24?
Да. Исходящие webhook Bitrix24 требуют публичный HTTPS с валидным сертификатом. После renew проверьте полную chain и доступность порта 443.
Похожие навыки
Нужно под ваш процесс?
Подстроим навык под ваши офферы, тон и ограничения. Или добавим новый, если такого нет.
Адаптировать под мой бизнес