Jak wysyłać RSVP, check-iny i zdjęcia z wydarzenia do innych aplikacji
Webhooki pozwalają Twojemu wydarzeniu informować inne aplikacje o tym, co się dzieje, w chwili, gdy to się dzieje. Gdy gość odpowie na zaproszenie, zostanie zameldowany przy wejściu albo w galerii pojawi się nowe zdjęcie, Fotify wysyła krótką wiadomość na wybrany przez Ciebie adres. Stamtąd może trafić do Twojego CRM, Arkusza Google, kanału na Slacku, sekwencji e-maili lub na Twój własny serwer.
Możesz połączyć się na dwa sposoby:
- Zapier lub Make, bez kodu: połącz się za pomocą klucza API i wybierz, co ma się wydarzyć.
- Własny adres URL webhooka: Fotify wysyła na niego podpisaną wiadomość JSON.
Webhooki, Zapier i Make są w cenie od planu Professional wzwyż oraz w każdym wydarzeniu objętym subskrypcją wydarzenia.
Co może wysyłać Fotify
Każdy webhook nasłuchuje jednego lub kilku z tych momentów:
- Otrzymano RSVP: gość odpowiedział na zaproszenie lub zmienił swoje RSVP. Zawiera imię i nazwisko, e-mail, telefon, odpowiedź, liczbę osób, komentarze oraz odpowiedzi na Twoje własne pytania.
- Gość zameldowany: gość został zameldowany przy wejściu, wraz z grupą i osobą, która przybyła.
- Nowe zdjęcie lub wideo: w galerii pojawiło się coś nowego. Zdjęcia zawierają link do obrazu, który działa przez 7 dni. Zdjęcia czekające na zatwierdzenie są wysyłane po Twoim zatwierdzeniu, a zdjęcia z albumów prywatnych nie są wysyłane nigdy.
- Wydarzenie rozpoczęte: rozpoczęto wydarzenie i goście mogą przesyłać zdjęcia.
- Wydarzenie zakończone: zakończyłeś(-aś) wydarzenie albo zamknęło się jego okno przesyłania.
Krok 1: Połącz Zapier lub Make
- W panelu Fotify otwórz Account settings → Integrations (Ustawienia konta → Integracje).
- Wpisz nazwę klucza, na przykład „Zapier”, i kliknij Utwórz klucz.
- Od razu skopiuj klucz. Ze względów bezpieczeństwa jest pokazywany tylko raz.
- Otwórz aplikację Fotify w Zapier lub Make za pomocą tych linków (nie ma jej jeszcze w ich katalogach aplikacji) i wklej klucz, gdy zostaniesz poproszony(-a) o połączenie.
- Wybierz wyzwalacz, na przykład New RSVP response lub New photo or video, i wskaż swoje wydarzenie z listy.
Lista wydarzeń pokazuje wydarzenia, którymi zarządzasz i których plan obejmuje webhooki. Każdy włączony Zap lub scenariusz pojawia się na stronie Webhooks wydarzenia, oznaczony jako Zapier lub Make.
Zamiast aplikacji Fotify możesz też użyć Webhooks by Zapier → Catch Hook albo Custom webhook w Make: skopiuj adres, który podadzą, i dodaj go jako adres URL webhooka w kroku 2.
Krok 2: Dodaj adres URL webhooka
- Otwórz wydarzenie w panelu i przewiń do karty Webhooks, Zapier i Make.
- Kliknij Skonfiguruj webhooki, a potem Dodaj webhook.
- Wklej adres, który ma odbierać wiadomości. Musi zaczynać się od
https://i być dostępny z internetu. - Zaznacz, co wysyłać, w razie potrzeby dodaj etykietę i kliknij Dodaj webhook.
- Skopiuj sekret podpisu wyświetlony nad nowym webhookiem i zapisz go u odbiorcy.
- Kliknij Wyślij zdarzenie testowe, aby sprawdzić, czy wszystko dociera.
Webhooki wydarzenia mogą dodawać i zmieniać tylko osoby, które mogą nim zarządzać, a każdy moment wymaga dostępu do swoich danych: momenty dotyczące gości wymagają dostępu do listy gości, a momenty dotyczące zdjęć wymagają dostępu do galerii.
Jak wygląda wiadomość
Każda wiadomość to żądanie POST z treścią JSON:
{
"id": "4f1c2e9a-7b2d-4c1e-9a8f-2d3b4c5e6f70",
"type": "rsvp.responded",
"createdAt": "2026-06-01T18:24:05.000Z",
"event": { "id": "…", "name": "Ana & Leo's Wedding" },
"data": {
"rsvp": {
"firstName": "Alex",
"lastName": "Rivera",
"email": "alex@example.com",
"status": "accepted",
"confirmedGuests": 2
}
}
}
Status RSVP (status) to jedna z wartości: accepted, declined, not_answered, attended, pending_approval (czeka na Twoje zatwierdzenie) lub waitlisted. Gość czekający na zatwierdzenie lub będący na liście oczekujących ma confirmedGuests równe 0, a liczbę osób, o którą prosił, w requestedGuests; rsvp.responded jest wysyłane ponownie, gdy go zatwierdzisz lub odrzucisz.
Pole id pozostaje takie samo, gdy wiadomość jest wysyłana ponownie, dzięki czemu odbiorca może pomijać duplikaty. Nagłówki podają moment (Fotify-Event) oraz wiadomość (Fotify-Delivery).
Daty samego wydarzenia, takie jak eventDate i eventTime, są podawane w strefie czasowej miejsca wydarzenia, tak jak widzą je Twoi goście.
Sprawdź, czy wiadomość pochodzi z Fotify
Każda wiadomość zawiera nagłówek Fotify-Signature w postaci t=1780000000,v1=5257a8…. Aby go sprawdzić:
- Weź
t(czas wysłania) oraz surową treść żądania. - Oblicz HMAC-SHA256 z
t+.+ treść, używając sekretu podpisu swojego webhooka. - Porównaj wynik z
v1i odrzucaj wiadomości, w którychtjest starsze niż 5 minut.
W Node.js:
const crypto = require("crypto");
function isFromFotify(rawBody, header, secret) {
const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
const expected = crypto
.createHmac("sha256", secret)
.update(`${parts.t}.${rawBody}`)
.digest("hex");
const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
return fresh && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
}
Sekret możesz pokazać ponownie lub utworzyć nowy na karcie webhooka. Nowy sekret natychmiast zastępuje stary.
Ponowienia, dziennik dostaw i webhooki, które się wyłączają
- Odpowiedz statusem 2xx w ciągu 10 sekund, aby potwierdzić wiadomość.
- Nieudane wiadomości są ponawiane 8 razy w ciągu około 4 godzin.
- Dziennik dostaw przy każdym webhooku pokazuje wszystkie wiadomości z ostatnich 30 dni wraz ze statusem, odpowiedzią i pełną treścią. Kliknij Wyślij ponownie, aby wysłać wiadomość jeszcze raz.
- Webhook wyłącza się sam, gdy jego adres URL zawiedzie 50 razy z rzędu, gdy odbiorca odpowie
410 Gone(tak Zapier i Make sygnalizują usunięcie Zapa lub scenariusza) albo gdy osoba, która go dodała, nie ma już dostępu do wydarzenia. Jego karta podaje powód. Włącz go ponownie po usunięciu problemu: wtedy to Ty stajesz się osobą, w imieniu której działa.
Skonfiguruj webhooki z asystentem AI
Jeśli połączyłeś(-aś) asystenta AI, takiego jak Claude, możesz poprosić go o wyświetlenie webhooków wydarzenia, dodanie jednego, wysłanie testu lub usunięcie webhooka. Adres URL musisz podać Ty, a sekret podpisu asystent pokaże Ci tylko raz.
Najczęściej zadawane pytania
P: Jakiego planu potrzebuję? O: Webhooki, Zapier i Make są w cenie od planu Professional wzwyż oraz w każdej subskrypcji wydarzenia. W innych planach karta Webhooks podaje, który plan je obejmuje.
P: Czy potrzebuję konta w Zapier lub Make? O: Tak, aby korzystać z Zapier lub Make, potrzebujesz tam konta. Webhooki na Twój własny adres URL nie wymagają niczego więcej.
P: Ile webhooków może mieć wydarzenie? O: Do 25, wliczając te utworzone przez Zapier i Make.
P: Dlaczego zdjęcie nie dotarło do mojego webhooka? O: Zdjęcia są wysyłane, gdy pojawią się w galerii. Zdjęcie czekające na zatwierdzenie jest wysyłane po Twoim zatwierdzeniu, a zdjęcia z albumów prywatnych nie są wysyłane nigdy.
P: Czy do testów mogę użyć adresu URL na własnym komputerze?
O: Nie. Fotify wysyła dane tylko na publiczne adresy https://. Aby testować z własnego komputera, użyj usługi tunelowania lub inspektora żądań.
P: Co stanie się z moimi webhookami, jeśli unieważnię klucz API? O: Zapier i Make nie będą mogły za pomocą tego klucza tworzyć ani usuwać subskrypcji. Subskrypcje, których już nie chcesz, usuń na stronie Webhooks wydarzenia.
Czy ten artykuł był pomocny?