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. Клиент должен уважать этот заголовок и повторять запрос с задержкой.