EN
TR
DEIntegracje webhooków
Wysyłaj zdarzenia Workexe do Slack, Jira, Zapier, Make, n8n lub własnego endpointu. Weryfikuj dostawy podpisem HMAC, odtwarzaj nieudane payloady, ograniczaj webhooki do projektu.
Wychodzące vs przychodzące
Wychodzące webhooki wysyłają zdarzenia Workexe przy zmianach (spadek pozycji, audyt, eksport raportu). Przychodzące pozwalają zewnętrznym narzędziom wywołać akcje Workexe przez podpisany POST.
- Wychodzące: Workexe → Twój URL
- Przychodzące: narzędzie → Workexe API
- JSON ze schematem v1
- Endpointy per projekt
Typy zdarzeń
Subskrybuj wszystkie lub podzbiór. Payload: ID projektu, nazwa zdarzenia, znacznik ISO, znormalizowany obiekt danych.
- keyword.position_changed
- backlink.new_or_lost
- site_audit.crawl_completed
- report.export_ready
- task.created
- workflow.run_failed
- integration.connected
Konfiguracja w 3 krokach
Dostępne od Pro i Agency. Natywne connectory bez kodu, raw URL dla własnych stacków.
- Ustawienia → Integracje → Webhooks → Dodaj endpoint
- Wklej URL, wybierz zdarzenia, skopiuj secret
- Wyślij test, potwierdź 2xx w logu
- Włącz live po teście
Bezpieczeństwo
Każda dostawa: X-Workexe-Signature (HMAC-SHA256). Odrzucaj żądania starsze niż 5 minut.
- Rotacja secret bez przestoju (24h overlap)
- Opcjonalna allowlista IP (Enterprise)
- TLS 1.2+ na URL docelowych
- Sekrety nie są ponownie zwracane
Retry i logi
Nieudane dostawy retry automatycznie. Pełne body 90 dni.
- 3 retry: 1min, 5min, 30min
- Log: status, latency, kod
- Ręczny replay jednym klikiem
- Alert email po 10 błędach w 1h
Natywne connectory
Wolisz UI? Wbudowane connectory na tym samym silniku webhook.
- Slack z rich blocks
- Jira z labelami
- Zapier / Make / n8n
- Google Sheets append row
- 1Otwórz projekt
Uruchom moduł integracje webhooków w panelu projektu.
- 2Podłącz źródła
Dodaj GSC, GA4 i wymagane importy CSV.
- 3Ustaw zakres
Lokalizacja, język, urządzenie i progi alertów.
- 4Waliduj
Sprawdź pierwszy skan na znanej stronie/query.