Dokumentacja

Webhooki — Przegląd i konfiguracja Pro

Webhooki Savebase pozwalają połączyć bibliotekę z dowolnym narzędziem automatyzacji — Zapier, Make, Slack, Airtable, Discord lub własnym backendem. Gdy post zostaje zapisany, otagowany, usunięty lub przywrócony, Savebase wysyła HTTP POST do zarejestrowanego endpointu.

Funkcja Pro

Webhooki są dostępne w Pro i Lifetime. Zmień plan w savebase.space/pricing.

Przegląd

Gdy wystąpi zdarzenie w bibliotece, Savebase wysyła podpisany JSON do wszystkich włączonych endpointów dla tego zdarzenia. Możesz dodać kilka, np. po jednym na integrację.

Konfigurowanie webhooka

1

Przejdź do Ustawienia → Webhooki

Przejdź do Dashboard → Settings → Webhooks.
2

Kliknij Dodaj webhook

Wprowadź adres URL punktu końcowego (wymagany HTTPS), opcjonalną etykietę i wybierz zdarzenia do subskrypcji.
3

Kopiuj sekret podpisywania

Po utworzeniu webhooka odsłoń i skopiuj Sekret do podpisywania. Użyj tego, aby sprawdzić, czy żądania pochodzą z Savebase.
4

Przetestuj endpoint

Kliknij Wyślij zdarzenie testowe aby natychmiast wysłać próbne dane.

Obsługiwane zdarzenia

ZdarzenieKiedy zadziała
post.savedNowy post jest dodawany do biblioteki
post.taggedTag jest dodawany do postu
post.deletedPost jest przenoszony do kosza
post.restoredPost jest przywracany z kosza

Format ładunku danych

Wszystkie zdarzenia korzystają z tej samej struktury nadrzędnej JSON:

bash
{
  "event": "post.saved",
  "timestamp": "2026-03-11T12:00:00.000Z",
  "data": {
    "id": 123,
    "url": "https://x.com/user/status/...",
    "title": "Post title or null",
    "source": "x",
    "author_name": "username",
    "tags": ["design", "ai"],
    "saved_at": "2026-03-11T12:00:00.000Z"
  }
}

Integracja Zapier

1

Utwórz nowy Zap

W Zapier kliknij Create Zap i wyszukaj Webhooks by Zapier jako aplikację wyzwalającą.
2

Wybierz Catch Hook

Wybierz Catch Hook. Zapier wygeneruje unikalny URL webhooka.
3

Zarejestruj URL w Savebase

Skopiuj adres URL z Zapier do Settings → Webhooks i wybierz zdarzenia.
4

Przetestuj wyzwalacz

Zapisz post. Zapier wykryje ładunek danych — zmapuj data.url, data.titleitp. do kroków działania.
5

Dodaj swoje działanie

Połącz dowolną akcję Zapier — wiersz Google Sheets, wiadomość Slack, stronę Notion, wpis Discord.

Brak natywnej weryfikacji podpisu w Zapier

Dodaj krok Filter lub Code w Zapier, aby zweryfikować X-Savebase-Signature nagłówku do kontroli bezpieczeństwa.

Make (Integromat)

1

Utwórz nowy scenariusz

W Make dodaj Webhooki → Własny webhook moduł wyzwalacza.
2

Zarejestruj się w Savebase

Skopiuj adres URL z Make do Settings → Webhooks.
3

Określ strukturę danych

Zapisz post w Savebase — Make automatycznie wykryje strukturę ładunku danych.
4

Zbuduj scenariusz

Mapa data.url, data.sourcei inne pola do kolejnych modułów, takich jak Airtable, Notion lub e-mail.

Poprzednia

Rozwiązywanie problemów

Dalej

Bezpieczeństwo i podpisy HMAC