Webhook troubleshooting

Webhooks — самая частая точка проблем при интеграциях.

Outgoing webhook не приходит на ваш сервер

1. Аудит-лог → фильтр Webhooks → смотрите webhook.delivered / webhook.failed 2. Проверьте URL вашего endpoint через curl 3. Verify HMAC-подпись (X-ImpactBot-Signature: sha256=hex) 4. Используйте webhook.site для приёма без backend

Incoming webhook не запускает воронку

1. URL: https://api.impactbot.ru/api/webhook/external/{ВАШ_TOKEN} 2. Минимальные обязательные поля: platform_id, platform 3. Проверьте что воронка активна (зелёный значок) 4. Аудит для конкретного клиента: Клиенты → ваш тест → правая панель → История

Payment webhook не апгрейдит подписку

1. Проверьте signature в логах (403 → mismatch, 200 → прошло) 2. Метаданные должны содержать metadata.client_id 3. Idempotency через Redis dedup (защита от двойной обработки) 4. Тестовый webhook от YooKassa: Личный кабинет → HTTP-уведомления → Resend

Rate limits

При ограничении частоты сервер возвращает HTTP 429 и заголовок Retry-After. Клиент должен уважать этот заголовок и повторять запрос с задержкой.