# Automatyzacja webhookami
SUMMARY: Wyzwalanie systemów zewnętrznych, gdy zmieniają się wspomnienia — synchronizacja, powiadomienia, automatyzacja.

Automatyzacja webhookami
Webhooki pozwalają wyzwalać systemy zewnętrzne, gdy uruchamiają się zdarzenia
Synapse. Ten przewodnik obejmuje typowe wzorce automatyzacji.
Typowe wzorce
Wzorzec 1: powiadomienie o krytycznym wspomnieniu
Wysłanie wiadomości Slack, gdy zapisywane jest krytyczne wspomnienie:
[CODE BLOCK]
Rejestracja webhooka:
[CODE BLOCK]
Wzorzec 2: synchronizacja z systemem zewnętrznym
Synchronizacja wspomnień z Notion, Obsidian lub dowolną zewnętrzną bazą wiedzy:
[CODE BLOCK]
Wzorzec 3: wyzwalanie CI/CD
Wyzwalanie wdrożenia, gdy zapisywane jest wspomnienie „release":
[CODE BLOCK]
Wzorzec 4: przebudzenie agenta przy wiadomości człowieka
Wyzwolenie uruchomienia agenta LLM, gdy człowiek wysyła wiadomość czatu:
[CODE BLOCK]
Wzorzec 5: agregacja metryk
Śledzenie wzrostu pamięci, aktywności czatu, ukończenia zadań:
[CODE BLOCK]
Weryfikacja podpisu
Zawsze weryfikować podpisy webhooków, aby zapobiec fałszerstwu:
[CODE BLOCK]
Logika ponowień
Synapse ponawia nieudane webhooki z wykładniczym wycofywaniem. Obsługa powinna:
1. Szybko zwracać 200 — nie wykonywać ciężkiej pracy synchronicznie
2. Kolejkować pracę — użyć systemu zadań w tle
3. Być idempotentna — to samo zdarzenie może być dostarczone dwa razy
[CODE BLOCK]
Debugowanie webhooków
Sprawdzenie historii dostarczeń
Dostarczenia webhooków są logowane. Sprawdzić ostatnie dostarczenia webhooka:
[CODE BLOCK]
Ręczne testowanie webhooka
[CODE BLOCK]
Częste problemy
| Problem | Rozwiązanie |
|-------|-----|
| Odpowiedzi 4xx | Sprawdzić, czy obsługa zwraca 200 |
| Odpowiedzi 5xx | Błąd serwera — sprawdzić logi aplikacji |
| Timeout | Szybko zwrócić 200, kolejkować pracę asynchronicznie |
| Duplikaty dostaw | Uczynić obsługę idempotentną |
| Niedopasowanie podpisu | Zweryfikować poprawność sekretu |
Najlepsze praktyki
> [!TIP]
> - Zawsze weryfikować podpisy — nigdy tego nie pomijać
> - Szybko zwracać 200 — nie blokować Synapse
> - Być idempotentnym — obsługiwać duplikaty dostaw
> - Używać konkretnych zdarzeń — , nie 
> - Monitorować błędy dostaw — skonfigurować alertowanie
Następne kroki
- Webhooks API
- Cron i Scheduler
- Trwały agent LLM