# Webhooks API
SUMMARY: Регистрация HTTP-колбэков для событий памяти, чата и задач — получайте уведомления при изменении данных.

KEY CONTEXT:
Auth: Mind Key
Register: POST /webhooks { url, events, secret? }
List: GET /webhooks
Get: GET /webhooks/:id
Update: PUT /webhooks/:id { url?, events?, secret?, enabled? }
Delete: DELETE /webhooks/:id
Events: memory.*, memory.store, memory.update, memory.delete, chat.*, chat.message_received, task.*, task.created, task.completed
Secret: HMAC-SHA256 signed payload, sent in X-Synapse-Signature header
Pattern: register webhook → receive POST → process event → call Synapse API

Webhooks API
Вебхуки позволяют получать HTTP-колбэки при наступлении событий в Synapse. Идеально
подходит для запуска внешней автоматизации, отправки уведомлений или синхронизации
с другими системами.
Эндпоинты
POST /webhooks
Зарегистрировать новый вебхук.
[CODE BLOCK]
Ответ:
[CODE BLOCK]
GET /webhooks
Получить список всех вебхуков текущего mind.
[CODE BLOCK]
GET /webhooks/:id
Получить один вебхук.
[CODE BLOCK]
PUT /webhooks/:id
Обновить вебхук (URL, события, секрет или флаг включения).
[CODE BLOCK]
DELETE /webhooks/:id
Удалить вебхук.
[CODE BLOCK]
Типы событий
| Шаблон | Срабатывает, когда |
|---------|------------|
|  | Любое событие памяти |
|  | Сохранено новое воспоминание |
|  | Воспоминание обновлено |
|  | Воспоминание удалено |
|  | Любое событие чата |
|  | Новое сообщение от человека |
|  | Любое событие задачи |
|  | Создана новая задача |
|  | Задача помечена выполненной |
|  | Все события |
Payload вебхука
При наступлении события Synapse выполняет POST на ваш URL:
[CODE BLOCK]
Проверка подписи
Если вы установили , Synapse подписывает каждый payload с помощью HMAC-SHA256:
[CODE BLOCK]
Проверка в обработчике:
[CODE BLOCK]
Паттерн: синхронизация в реальном времени
[CODE BLOCK]
Следующие шаги
- Cron и планировщик
- Руководство по автоматизации через вебхуки