Come inviare RSVP, check-in e foto del tuo evento ad altre app
I webhook permettono al tuo evento di dire ad altre app che cosa sta succedendo nel momento stesso in cui succede. Quando un invitato risponde all'RSVP, fa il check-in all'ingresso o una nuova foto appare nella galleria, Fotify invia un piccolo messaggio a un indirizzo che scegli tu. Da lì può arrivare nel tuo CRM, in un foglio Google, in un canale Slack, in una sequenza di email o sul tuo server.
Puoi collegarti in due modi:
- Zapier o Make, senza scrivere codice: ti colleghi con una chiave API e scegli cosa deve succedere.
- Un URL webhook tuo: Fotify gli invia un messaggio JSON firmato.
Webhook, Zapier e Make sono inclusi dal piano Professional in su e su ogni evento che rientra in un abbonamento evento.
Che cosa può inviare Fotify
Ogni webhook ascolta uno o più di questi momenti:
- RSVP ricevuto: un invitato ha risposto o ha modificato il suo RSVP. Include nome, email, telefono, risposta, numero di persone, commenti e le risposte alle tue domande personalizzate.
- Check-in dell'invitato: un invitato ha fatto il check-in all'ingresso, con il gruppo e la persona arrivata.
- Nuova foto o nuovo video: qualcosa di nuovo è apparso nella galleria. Le foto arrivano con un link all'immagine valido per 7 giorni. Le foto in attesa di approvazione vengono inviate dopo che le approvi, e le foto negli album privati non vengono mai inviate.
- Evento avviato: hai avviato l'evento e gli invitati possono caricare.
- Evento terminato: hai terminato l'evento oppure la sua finestra di caricamento si è chiusa.
Passaggio 1: collega Zapier o Make
- Nella dashboard di Fotify, apri Impostazioni account → Integrazioni.
- Scrivi un nome per la chiave, ad esempio "Zapier", e clicca su Crea chiave.
- Copia subito la chiave. Per la tua sicurezza viene mostrata una sola volta.
- Apri l'app Fotify in Zapier o in Make da questi link (non è ancora presente nei rispettivi elenchi delle app) e incolla la chiave quando ti chiede di collegarti.
- Scegli un trigger, come Nuova risposta RSVP o Nuova foto o nuovo video, e seleziona il tuo evento dall'elenco.
L'elenco degli eventi mostra quelli che gestisci e il cui piano include i webhook. Ogni Zap o scenario che attivi compare nella pagina Webhook dell'evento, contrassegnato come Zapier o Make.
Puoi anche usare Webhooks by Zapier → Catch Hook di Zapier o il Custom webhook di Make al posto dell'app Fotify: copia l'indirizzo che ti forniscono e aggiungilo come URL webhook nel Passaggio 2.
Passaggio 2: aggiungi un URL webhook
- Apri il tuo evento nella dashboard e scorri fino alla scheda Webhook, Zapier e Make.
- Clicca su Configura i webhook, poi su Aggiungi un webhook.
- Incolla l'indirizzo che deve ricevere i messaggi. Deve iniziare con
https://ed essere raggiungibile da internet. - Seleziona cosa inviare, aggiungi un'etichetta se vuoi e clicca su Aggiungi webhook.
- Copia il segreto di firma mostrato sopra il nuovo webhook e conservalo insieme al tuo ricevitore.
- Clicca su Invia evento di prova per verificare che tutto arrivi.
Solo chi può gestire l'evento può aggiungere o modificare i suoi webhook, e ogni momento richiede l'accesso ai propri dati: i momenti legati agli invitati richiedono l'accesso alla lista invitati, quelli legati alle foto l'accesso alla galleria.
Come appare un messaggio
Ogni messaggio è una POST con un corpo 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
}
}
}
Lo status di un RSVP è uno tra accepted, declined, not_answered, attended, pending_approval (in attesa della tua approvazione) o waitlisted. Un ospite in attesa di approvazione o in lista d'attesa ha confirmedGuests a 0 e il gruppo richiesto in requestedGuests; rsvp.responded scatta di nuovo quando lo approvi o lo rifiuti.
L'id resta lo stesso quando un messaggio viene inviato di nuovo, così il tuo ricevitore può ignorare i duplicati. Gli header indicano il momento (Fotify-Event) e il messaggio (Fotify-Delivery).
Le date dell'evento stesso, come eventDate e eventTime, sono espresse nel fuso orario della location, così come le vedono i tuoi invitati.
Verifica che un messaggio provenga da Fotify
Ogni messaggio porta un header Fotify-Signature simile a t=1780000000,v1=5257a8…. Per verificarlo:
- Prendi
t(l'ora di invio) e il corpo grezzo della richiesta. - Calcola un HMAC-SHA256 di
t+.+ corpo, usando il segreto di firma del tuo webhook. - Confronta il risultato con
v1e scarta i messaggi il cuitrisale a più di 5 minuti fa.
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));
}
Puoi mostrare di nuovo il segreto o crearne uno nuovo dalla scheda del webhook. Un nuovo segreto sostituisce subito il vecchio.
Nuovi tentativi, registro delle consegne e webhook che si disattivano
- Rispondi con uno stato 2xx entro 10 secondi per confermare un messaggio.
- I messaggi non riusciti vengono ritentati 8 volte nell'arco di circa 4 ore.
- Il registro delle consegne di ogni webhook mostra tutti i messaggi degli ultimi 30 giorni, con stato, risposta e corpo completo. Clicca su Invia di nuovo per reinviarne uno.
- Un webhook si disattiva da solo quando il suo URL fallisce 50 volte di fila, quando il ricevitore risponde
410 Gone(è il modo in cui Zapier e Make segnalano che uno Zap o uno scenario è stato eliminato) o quando la persona che lo ha aggiunto non ha più accesso all'evento. La sua scheda ne spiega il motivo. Riattivalo una volta risolto il problema: diventi tu la persona per cui agisce.
Configura i webhook con un assistente IA
Se hai collegato un assistente IA come Claude, puoi chiedergli di elencare i webhook del tuo evento, aggiungerne uno, inviare una prova o eliminarne uno. Ha bisogno dell'URL da parte tua e ti mostra il segreto di firma una sola volta.
Domande frequenti
D: Di quale piano ho bisogno? R: Webhook, Zapier e Make sono inclusi dal piano Professional in su e su ogni abbonamento evento. Sugli altri piani la scheda Webhook indica il piano che li include.
D: Mi serve un account Zapier o Make? R: Sì, per usare Zapier o Make serve un account su quei servizi. I webhook verso un tuo URL non richiedono altro.
D: Quanti webhook può avere un evento? R: Fino a 25, compresi quelli creati da Zapier e Make.
D: Perché una foto non è arrivata al mio webhook? R: Le foto vengono inviate quando compaiono nella galleria. Una foto in attesa di approvazione viene inviata dopo che la approvi, e le foto negli album privati non vengono mai inviate.
D: Posso usare un URL sul mio computer per fare dei test?
R: No. Fotify invia solo a indirizzi https:// pubblici. Usa un servizio di tunnel o un ispettore di richieste per fare test dal tuo computer.
D: Che cosa succede ai miei webhook se revoco una chiave API? R: Zapier e Make non possono più creare o rimuovere iscrizioni con quella chiave. Elimina dalla pagina Webhook dell'evento le iscrizioni che non vuoi più.
Questo articolo è stato utile?