Webhooki

Webhook wysyła wiadomość na Twój adres za każdym razem, gdy na Twoim koncie zajdzie wybrane zdarzenie, na przykład nowy zakup. Po wykonaniu tych kroków masz aktywny webhook, sekret podpisu do weryfikacji jego wiadomości i miejsce, w którym obserwujesz wysyłki. Webhooki są częścią każdego aktualnego planu Zanfii.

Dodaj webhook

Zdarzenia, które możesz subskrybować

Powiadomienie na 14 dni przed końcem jest wysyłane tylko dla dostępów trwających co najmniej 3 miesiące.

Jak wygląda wysyłka

Każda wysyłka to żądanie HTTP POST z treścią JSON i poniższymi nagłówkami, do których dochodzą skonfigurowane przez Ciebie własne nagłówki i basic auth:

Treść ma zawsze tę samą kopertę. Klucze wymienione w data są zawsze obecne i mają wartość null, gdy zdarzenie nie niesie dla nich wartości; zdarzenie może dodać własne klucze (przy zakupie: productName, paymentType, quantity, price).

{
  "apiVersion": "2026-07-13",
  "event": "product.ProductPurchased",
  "occurredAt": "2026-09-30T10:00:00.000Z",
  "workspaceId": "identyfikator Twojego konta",
  "data": {
    "clientId": "cli_4f81c92a7b3d",
    "clientEmail": "anna.novak@example.com",
    "clientFirstName": "Anna",
    "clientLastName": "Novak",
    "clientName": "Anna Novak",
    "productId": "prod_8c31a2f4d95e",
    "priceId": "price_5e92c7d1a48b",
    "orderId": "35e479ee-d456-4ee9-a5da-e7ff8109ffcc",
    "checkoutId": "chk_1f83b6a92c4d",
    "orderTotalAmount": 199,
    "consents": [{ "name": "marketing", "value": true }],
    "utmSource": "facebook",
    "utmMedium": "cpc",
    "utmCampaign": "summer-launch",
    "utmTerm": null,
    "utmContent": null
  }
}

Pole podglądu w edytorze pokazuje treść dla zdarzenia, które wybierzesz, więc traktuj je jako źródło wiedzy o dodatkowych kluczach każdego zdarzenia.

Zweryfikuj podpis

Każda wysyłka zawiera nagłówek X-Zanfia-Signature: t=[czas unix],v1=[podpis]. Podpis to HMAC-SHA256, zapisany szesnastkowo, z tekstu [t].[surowe body] (wartość t, kropka, a potem treść żądania dokładnie w otrzymanej postaci), obliczony Twoim sekretem podpisu. Na swoim serwerze:

1. Odczytaj t i v1 z nagłówka.
2. Oblicz HMAC-SHA256 z wartości t, kropki i surowej treści żądania, używając sekretu whsec_ jako klucza.
3. Porównaj wynik z v1 porównaniem w stałym czasie i odrzuć żądanie, jeśli się różnią.

Obliczaj podpis z surowej treści, przed parsowaniem JSON; treść zserializowana ponownie daje inny podpis.

Monitoruj, wysyłaj ponownie, wstrzymuj i usuwaj

Lista pod adresem /workflows/webhooks ma cztery kolumny: Endpoint, Zdarzenia, Stan i Aktywny.

Kliknij wiersz, aby otworzyć okno Szczegóły webhooka: adres, stan, zdarzenia oraz Ostatnie wywołania z czasem, statusem i odpowiedzią. Strzałka ponownej wysyłki przy wywołaniu wysyła to zdarzenie jeszcze raz z aktualnymi ustawieniami webhooka („Zdarzenie wysłane ponownie - endpoint odpowiedział 200”). Przyciski na dole to Usuń („Usunąć ten webhook?”), Wyślij test i Edytuj.

Aby wstrzymać webhook bez usuwania, wyłącz jego przełącznik Aktywny na liście; przestaje otrzymywać zdarzenia do czasu ponownego włączenia.

Webhooki w automatyzacjach

Jeśli któraś z Twoich automatyzacji zawiera akcję webhook, jej adres pojawia się w drugiej tabeli, Używane w automatyzacjach, razem z automatyzacjami, które go wywołują, oraz tym samym stanem i historią wywołań. Te adresy edytuje się w samej automatyzacji, nie tutaj. O automatyzacjach przeczytasz w artykule Zbuduj automatyzację.