# Автоматизація webhook-ів
SUMMARY: Запускайте зовнішні системи при зміні спогадів — синхронізація, сповіщення, автоматизація.

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