Jak posílat RSVP, příchody hostů a fotky své události do jiných aplikací
Webhooky umožňují vaší události dát ostatním aplikacím vědět, co se děje, ve chvíli, kdy se to stane. Když host odpoví na RSVP, je odbaven u vstupu nebo se v galerii objeví nová fotka, Fotify pošle malou zprávu na adresu, kterou zvolíte. Odtud může skončit ve vašem CRM, v tabulce Google Sheets, v kanálu Slacku, v e-mailové sekvenci nebo na vašem vlastním serveru.
Připojit se můžete dvěma způsoby:
- Zapier nebo Make, bez programování: připojíte se pomocí API klíče a vyberete, co se má stát.
- Vlastní adresa webhooku: Fotify na ni pošle podepsanou zprávu JSON.
Webhooky, Zapier a Make jsou v ceně od tarifu Professional výše a u každé události, která běží v rámci předplatného události.
Co všechno může Fotify odeslat
Každý webhook naslouchá jednomu nebo více z těchto okamžiků:
- Přijato RSVP: host odpověděl na RSVP nebo svou odpověď změnil. Obsahuje jeho jméno, e-mail, telefon, odpověď, velikost skupiny, poznámky a odpovědi na vaše vlastní otázky.
- Host odbaven: host byl odbaven u vstupu, včetně skupiny a osoby, která dorazila.
- Nová fotka nebo video: v galerii se objevilo něco nového. Fotky obsahují odkaz na obrázek, který funguje 7 dní. Fotky čekající na schválení se odešlou po vašem schválení a fotky v soukromých albech se neodesílají nikdy.
- Událost zahájena: zahájili jste událost a hosté mohou nahrávat.
- Událost ukončena: ukončili jste událost, nebo se zavřelo její okno pro nahrávání.
Krok 1: Připojte Zapier nebo Make
- V dashboardu Fotify otevřete Nastavení účtu → Integrace.
- Zadejte název klíče, například „Zapier“, a klikněte na Vytvořit klíč.
- Klíč ihned zkopírujte. Z bezpečnostních důvodů se zobrazí jen jednou.
- Otevřete aplikaci Fotify v Zapieru nebo v Make pomocí těchto odkazů (v jejich adresářích aplikací zatím není uvedena) a po vyzvání k připojení vložte klíč.
- Vyberte spouštěč, například New RSVP response nebo New photo or video, a ze seznamu zvolte svou událost.
Seznam událostí ukazuje události, které spravujete a jejichž tarif zahrnuje webhooky. Každý Zap nebo scénář, který zapnete, se objeví na stránce Webhooky dané události s označením Zapier nebo Make.
Místo aplikace Fotify můžete použít také Webhooks by Zapier → Catch Hook nebo Custom webhook v Make: zkopírujte adresu, kterou vám nabídnou, a přidejte ji jako adresu webhooku v kroku 2.
Krok 2: Přidejte adresu webhooku
- Otevřete událost v dashboardu a sjeďte na kartu Webhooky, Zapier a Make.
- Klikněte na Nastavit webhooky a potom na Přidat webhook.
- Vložte adresu, která má zprávy přijímat. Musí začínat
https://a být dostupná z internetu. - Zaškrtněte, co se má odesílat, podle potřeby přidejte popisek a klikněte na Přidat webhook.
- Zkopírujte podpisový klíč zobrazený nad novým webhookem a uložte ho u svého příjemce.
- Kliknutím na Odeslat testovací událost ověřte, že vše dorazí.
Webhooky události mohou přidávat a měnit jen lidé, kteří událost spravují, a každý okamžik vyžaduje přístup k příslušným datům: okamžiky týkající se hostů vyžadují přístup k seznamu hostů, okamžiky týkající se fotek přístup ke galerii.
Jak vypadá zpráva
Každá zpráva je požadavek POST s tělem ve formátu 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
}
}
}
Hodnota status u RSVP je jedna z accepted, declined, not_answered, attended, pending_approval (čeká na vaše schválení) nebo waitlisted. Host čekající na schválení nebo na čekací listině má confirmedGuests rovno 0 a skupinu, o kterou požádal, uvádí v requestedGuests; rsvp.responded se spustí znovu, když ho schválíte nebo odmítnete.
Hodnota id zůstává při opětovném odeslání zprávy stejná, takže váš příjemce může duplicity přeskočit. Hlavičky uvádějí okamžik (Fotify-Event) a zprávu (Fotify-Delivery).
Data samotné události, například eventDate a eventTime, jsou uvedena v časovém pásmu místa konání, tak jak je vidí vaši hosté.
Ověřte, že zpráva přišla z Fotify
Každá zpráva nese hlavičku Fotify-Signature ve tvaru t=1780000000,v1=5257a8…. Ověříte ji takto:
- Vezměte
t(čas odeslání) a nezpracované tělo požadavku. - Spočítejte HMAC-SHA256 z
t+.+ tělo pomocí podpisového klíče svého webhooku. - Výsledek porovnejte s
v1a zprávy, jejichžtje starší než 5 minut, odmítněte.
V 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));
}
Klíč můžete na kartě webhooku znovu zobrazit nebo vytvořit nový. Nový klíč okamžitě nahradí starý.
Opakování, protokol doručení a webhooky, které se vypnou
- Potvrďte zprávu odpovědí se stavem 2xx do 10 sekund.
- Neúspěšné zprávy se zkoušejí znovu 8krát během zhruba 4 hodin.
- Protokol doručení u každého webhooku ukazuje všechny zprávy za posledních 30 dní s jejich stavem, odpovědí a úplným tělem. Kliknutím na Odeslat znovu zprávu odešlete znovu.
- Webhook se sám vypne, když jeho adresa selže 50krát za sebou, když příjemce odpoví
410 Gone(tak Zapier a Make oznamují, že byl Zap nebo scénář smazán), nebo když osoba, která ho přidala, ztratí přístup k události. Důvod uvádí jeho karta. Po odstranění problému ho znovu zapněte: stanete se osobou, za kterou jedná.
Nastavení webhooků pomocí AI asistenta
Pokud jste připojili AI asistenta, například Claude, můžete ho požádat, aby vypsal webhooky vaší události, přidal nový, odeslal test nebo některý smazal. Adresu URL mu musíte zadat vy a podpisový klíč vám ukáže jen jednou.
Často kladené otázky
Q: Jaký tarif potřebuji? A: Webhooky, Zapier a Make jsou v ceně od tarifu Professional výše a u každého předplatného události. U ostatních tarifů karta Webhooky uvádí tarif, který je zahrnuje.
Q: Potřebuji účet v Zapieru nebo Make? A: Ano, pro použití Zapieru nebo Make potřebujete účet u nich. Webhooky na vlastní adresu URL nevyžadují nic dalšího.
Q: Kolik webhooků může mít událost? A: Až 25, včetně těch, které vytvoří Zapier a Make.
Q: Proč fotka nedorazila na můj webhook? A: Fotky se odesílají, když se objeví v galerii. Fotka čekající na schválení se odešle po vašem schválení a fotky v soukromých albech se neodesílají nikdy.
Q: Mohu k testování použít adresu URL na svém počítači?
A: Ne. Fotify odesílá pouze na veřejné adresy https://. K testování z počítače použijte tunelovací službu nebo nástroj pro kontrolu požadavků.
Q: Co se stane s mými webhooky, když zruším platnost API klíče? A: Zapier a Make s tímto klíčem už nebudou moci vytvářet ani odebírat odběry. Odběry, které už nechcete, smažte na stránce Webhooky dané události.
Byl tento článek užitečný?