# Автоматизация через вебхуки
SUMMARY: Запускайте внешние системы при изменении памяти — синхронизация, уведомления, автоматизация.

Автоматизация через вебхуки
Вебхуки позволяют запускать внешние системы при наступлении событий Synapse.
Это руководство описывает типовые паттерны автоматизации.
Частые паттерны
Паттерн 1: уведомление о критичной памяти
Отправка Slack-сообщения при сохранении критичной памяти:
[CODE BLOCK]
Регистрация вебхука:
[CODE BLOCK]
Паттерн 2: синхронизация с внешней системой
Синхронизация памяти с Notion, Obsidian или любой внешней базой знаний:
[CODE BLOCK]
Паттерн 3: запуск CI/CD
Запуск развёртывания при сохранении памяти о «релизе»:
[CODE BLOCK]
Паттерн 4: пробуждение агента при сообщении человека
Запуск LLM-агента, когда человек отправляет сообщение в чат:
[CODE BLOCK]
Паттерн 5: агрегация метрик
Отслеживание роста памяти, активности чата, завершения задач:
[CODE BLOCK]
Проверка подписи
Всегда проверяйте подписи вебхуков для предотвращения подмены:
[CODE BLOCK]
Логика повторов
Synapse повторяет неудачные вебхуки с экспоненциальной задержкой. Ваш обработчик должен:
1. Быстро возвращать 200 — не делайте тяжёлую работу синхронно
2. Ставить работу в очередь — используйте фоновую систему задач
3. Быть идемпотентным — одно событие может быть доставлено дважды
[CODE BLOCK]
Отладка вебхуков
Проверка истории доставок
Доставки вебхуков логируются. Проверьте недавние доставки вашего вебхука:
[CODE BLOCK]
Ручное тестирование вебхука
[CODE BLOCK]
Частые проблемы
| Проблема | Решение |
|-------|-----|
| 4xx ответы | Проверьте, что обработчик возвращает 200 |
| 5xx ответы | Ошибка сервера — проверьте логи приложения |
| Тайм-аут | Возвращайте 200 быстро, ставьте работу в очередь асинхронно |
| Дублирующиеся доставки | Сделайте обработчик идемпотентным |
| Несовпадение подписи | Проверьте, что секрет корректен |
Лучшие практики
> [!TIP]
> - Всегда проверяйте подписи — никогда не пропускайте это
> - Возвращайте 200 быстро — не блокируйте Synapse
> - Будьте идемпотентны — обрабатывайте дублирующиеся доставки
> - Используйте конкретные события — , а не 
> - Мониторьте неудачи доставки — настройте оповещения
Следующие шаги
- Webhooks API
- Cron и планировщик
- Постоянный LLM-агент