# webhook-engineer

Проектирует приём и отправку вебхуков с проверкой HMAC-подписей, дедупликацией событий и защитой от сбоев доставки.

- субагент · `type=agent` · Claude Code · ★ 26093
- Автор: VoltAgent Community
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/VoltAgent/awesome-claude-code-subagents/tree/HEAD/categories/01-core-development/webhook-engineer.md
- Обновлён: 2026-10-11
- HTML: https://affpapa.org/nevibecode/agents/webhook-engineer

## Что делает

Субагент работает на модели `sonnet` с инструментами `Read`, `Write`, `Edit`, `Bash`, `Glob` и `Grep`. Он анализирует маршруты вебхуков в кодовой базе и настраивает обработчики так, чтобы они выдерживали повторные запросы, смену порядка событий и сетевые сбои.

Для входящих вебхуков субагент выстраивает проверку HMAC-подписи по необработанному телу запроса до парсинга JSON, сравнение за константное время и отсечение устаревших запросов по таймстемпу. События сначала сохраняются в базе или ставятся в очередь, и только потом подтверждаются ответом 2xx. Обработка выполняется асинхронно, а для сбоев настраивается экспоненциальная задержка и очередь недоставленных сообщений.

При отправке собственных вебхуков субагент добавляет защиту от SSRF, блокирует внутренние диапазоны адресов и запрещает опасные редиректы. Без сохранения исходного тела запроса в HTTP-сервере валидация подписи сломается.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add VoltAgent/awesome-claude-code-subagents
```
В чате агента (не в терминале):
```text
/plugin install voltagent-core-dev@voltagent-subagents
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/webhook-engineer.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/webhook-engineer.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/webhook-engineer.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/VoltAgent/awesome-claude-code-subagents/tree/HEAD/categories/01-core-development/webhook-engineer.md

## Когда брать
- проверить HMAC-подпись входящего запроса до парсинга JSON
- настроить дедупликацию событий через хранилище с TTL и ограничения базы данных
- изолировать сбойные вебхуки в очереди недоставленных сообщений
- защитить отправку исходящих хуков от атак типа SSRF и перепривязки DNS

## Примеры запросов агенту
- Проверь обработчик вебхуков и настрой валидацию HMAC-подписи по сырому телу запроса.
- Спроектируй идемпотентную обработку входящих событий с очередью недоставленных сообщений.
- Добавь защиту от SSRF и блокировку внутренних IP-адресов для исходящих вебхуков.

## Похожие
- [python-pro](https://affpapa.org/nevibecode/agents/python-pro.md) — субагент · 11689 установок
- [ai-engineer](https://affpapa.org/nevibecode/agents/ai-engineer.md) — субагент · 7687 установок
- [code-explorer](https://affpapa.org/nevibecode/agents/code-explorer.md) — субагент · 1172 установки

Из того же набора: [voltagent/awesome-claude-code-subagents](https://affpapa.org/nevibecode/by/voltagent/awesome-claude-code-subagents.md) — 171 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md