Je RSVP's, check-ins en foto's naar andere apps sturen
Met webhooks vertelt je evenement andere apps meteen wat er gebeurt. Zodra een gast zijn RSVP beantwoordt, bij de deur wordt ingecheckt of er een nieuwe foto in de galerij verschijnt, stuurt Fotify een klein bericht naar een adres dat jij kiest. Vanaf daar kan het in je CRM, een Google Sheet, een Slack-kanaal, een e-mailreeks of op je eigen server terechtkomen.
Je kunt op twee manieren koppelen:
- Zapier of Make, zonder code: koppel met een API-sleutel en kies wat er moet gebeuren.
- Een eigen webhook-URL: Fotify stuurt er een ondertekend JSON-bericht naartoe.
Webhooks, Zapier en Make zijn inbegrepen vanaf het Professional-abonnement en bij elk evenement met een evenementabonnement.
Wat Fotify kan versturen
Elke webhook luistert naar een of meer van deze momenten:
- RSVP ontvangen: een gast heeft zijn RSVP beantwoord of gewijzigd. Bevat naam, e-mailadres, telefoonnummer, antwoord, groepsgrootte, opmerkingen en de antwoorden op je eigen vragen.
- Gast ingecheckt: een gast is bij de deur ingecheckt, met de groep en de persoon die is aangekomen.
- Nieuwe foto of video: er is iets nieuws in de galerij verschenen. Foto's bevatten een link naar de afbeelding die 7 dagen werkt. Foto's die op goedkeuring wachten, worden verstuurd zodra je ze goedkeurt, en foto's in privéalbums worden nooit verstuurd.
- Evenement gestart: je hebt het evenement gestart en gasten kunnen uploaden.
- Evenement beëindigd: je hebt het evenement beëindigd of het uploadvenster is gesloten.
Stap 1: Koppel Zapier of Make
- Open in het Fotify-dashboard Accountinstellingen → Integraties.
- Typ een naam voor de sleutel, bijvoorbeeld "Zapier", en klik op Sleutel aanmaken.
- Kopieer de sleutel meteen. Uit veiligheid wordt hij maar één keer getoond.
- Open de Fotify-app in Zapier of Make via deze links (de app staat nog niet in hun app-directory's) en plak de sleutel wanneer om een koppeling wordt gevraagd.
- Kies een trigger, zoals Nieuwe RSVP-reactie of Nieuwe foto of video, en selecteer je evenement in de lijst.
De evenementenlijst toont de evenementen die je beheert en waarvan het abonnement webhooks bevat. Elke Zap of elk scenario dat je aanzet, verschijnt op de pagina Webhooks van het evenement, gemarkeerd als Zapier of Make.
Je kunt in plaats van de Fotify-app ook Webhooks by Zapier → Catch Hook van Zapier of Custom webhook van Make gebruiken: kopieer het adres dat ze geven en voeg het in Stap 2 toe als webhook-URL.
Stap 2: Voeg een webhook-URL toe
- Open je evenement in het dashboard en scroll naar de kaart Webhooks, Zapier & Make.
- Klik op Webhooks instellen en daarna op Webhook toevoegen.
- Plak het adres dat de berichten moet ontvangen. Het moet beginnen met
https://en bereikbaar zijn via internet. - Vink aan wat er verstuurd moet worden, voeg zo nodig een label toe en klik op Webhook toevoegen.
- Kopieer het ondertekeningsgeheim dat boven de nieuwe webhook staat en bewaar het bij je ontvanger.
- Klik op Testgebeurtenis verzenden om te controleren of alles aankomt.
Alleen mensen die het evenement kunnen beheren, kunnen de webhooks toevoegen of wijzigen, en voor elk moment is toegang tot de bijbehorende gegevens nodig: gastmomenten vereisen toegang tot de gastenlijst, fotomomenten toegang tot de galerij.
Hoe een bericht eruitziet
Elk bericht is een POST met een JSON-body:
{
"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
}
}
}
De status van een RSVP is accepted, declined, not_answered, attended, pending_approval (wacht op je goedkeuring) of waitlisted. Een gast die op goedkeuring wacht of op de wachtlijst staat, heeft confirmedGuests op 0 en de groep die is aangevraagd in requestedGuests; rsvp.responded wordt opnieuw verstuurd wanneer je die gast goedkeurt of afwijst.
De id blijft hetzelfde wanneer een bericht opnieuw wordt verzonden, zodat je ontvanger duplicaten kan overslaan. De headers noemen het moment (Fotify-Event) en het bericht (Fotify-Delivery).
Data van het evenement zelf, zoals eventDate en eventTime, staan in de tijdzone van de locatie, zoals je gasten ze zien.
Controleer of een bericht van Fotify komt
Elk bericht bevat een Fotify-Signature-header zoals t=1780000000,v1=5257a8…. Zo controleer je hem:
- Neem
t(het moment van verzenden) en de ruwe request-body. - Bereken een HMAC-SHA256 van
t+.+ body, met het ondertekeningsgeheim van je webhook. - Vergelijk het resultaat met
v1en weiger berichten waarvantmeer dan 5 minuten oud is.
In 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));
}
Je kunt het geheim opnieuw tonen of een nieuw geheim aanmaken via de kaart van de webhook. Een nieuw geheim vervangt het oude meteen.
Nieuwe pogingen, het bezorglogboek en webhooks die uitschakelen
- Antwoord met een 2xx-status binnen 10 seconden om een bericht te bevestigen.
- Mislukte berichten worden opnieuw geprobeerd: 8 keer in ongeveer 4 uur.
- Het bezorglogboek van elke webhook toont elk bericht van de laatste 30 dagen, met status, antwoord en de volledige body. Klik op Opnieuw verzenden om er een opnieuw te versturen.
- Een webhook schakelt zichzelf uit wanneer zijn URL 50 keer achter elkaar faalt, wanneer de ontvanger met
410 Goneantwoordt (zo laten Zapier en Make weten dat een Zap of scenario is verwijderd), of wanneer de persoon die hem heeft toegevoegd geen toegang meer heeft tot het evenement. Op de kaart staat waarom. Zet hem weer aan zodra het probleem is opgelost: dan word jij de persoon namens wie hij handelt.
Webhooks instellen met een AI-assistent
Als je een AI-assistent hebt gekoppeld zoals Claude, kun je hem vragen de webhooks van je evenement op te sommen, er een toe te voegen, een test te sturen of er een te verwijderen. Hij heeft de URL van jou nodig en toont je het ondertekeningsgeheim één keer.
Veelgestelde vragen
V: Welk abonnement heb ik nodig? A: Webhooks, Zapier en Make zijn inbegrepen vanaf het Professional-abonnement en bij elk evenementabonnement. Bij andere abonnementen noemt de kaart Webhooks het abonnement dat ze bevat.
V: Heb ik een Zapier- of Make-account nodig? A: Ja, om Zapier of Make te gebruiken heb je daar een account nodig. Voor webhooks naar je eigen URL is niets anders nodig.
V: Hoeveel webhooks kan een evenement hebben? A: Maximaal 25, inclusief die Zapier en Make aanmaken.
V: Waarom is een foto niet bij mijn webhook aangekomen? A: Foto's worden verstuurd wanneer ze in de galerij verschijnen. Een foto die op goedkeuring wacht, wordt verstuurd zodra je hem goedkeurt, en foto's in privéalbums worden nooit verstuurd.
V: Kan ik een URL op mijn eigen computer gebruiken om te testen?
A: Nee. Fotify verstuurt alleen naar openbare https://-adressen. Gebruik een tunnelservice of een request-inspector om vanaf je computer te testen.
V: Wat gebeurt er met mijn webhooks als ik een API-sleutel intrek? A: Zapier en Make kunnen met die sleutel geen abonnementen meer aanmaken of verwijderen. Verwijder de abonnementen die je niet meer wilt op de pagina Webhooks van het evenement.
Was dit artikel nuttig?