Cómo enviar las confirmaciones, los check-ins y las fotos de tu evento a otras apps
Los webhooks permiten que tu evento avise a otras apps de lo que ocurre en el instante en que ocurre. Cuando un invitado responde su confirmación, se registra su llegada en la puerta o aparece una foto nueva en la galería, Fotify envía un pequeño mensaje a la dirección que elijas. Desde ahí puede llegar a tu CRM, una hoja de Google, un canal de Slack, una secuencia de correos o tu propio servidor.
Puedes conectar de dos maneras:
- Zapier o Make, sin código: conecta con una clave de API y elige qué debe ocurrir.
- Una URL de webhook propia: Fotify le envía un mensaje JSON firmado.
Los webhooks, Zapier y Make están incluidos desde el plan Professional y en todos los eventos que funcionan con una suscripción de evento.
Qué puede enviar Fotify
Cada webhook escucha uno o varios de estos momentos:
- Confirmación recibida: un invitado respondió o cambió su confirmación. Incluye su nombre, correo, teléfono, respuesta, número de acompañantes, comentarios y las respuestas a tus preguntas personalizadas.
- Invitado registrado: se registró la llegada de un invitado en la puerta, con el grupo y la persona que llegó.
- Nueva foto o video: apareció algo nuevo en la galería. Las fotos incluyen un enlace a la imagen que funciona durante 7 días. Las fotos pendientes de aprobación se envían cuando las apruebas, y las fotos de álbumes privados nunca se envían.
- Evento iniciado: iniciaste el evento y los invitados pueden subir contenido.
- Evento finalizado: terminaste el evento o se cerró su ventana de carga.
Paso 1: Conecta Zapier o Make
- En el panel de Fotify, abre Ajustes de la cuenta → Integraciones.
- Escribe un nombre para la clave, por ejemplo "Zapier", y haz clic en Crear clave.
- Copia la clave de inmediato. Por tu seguridad, solo se muestra una vez.
- Abre la app de Fotify en Zapier o en Make desde estos enlaces (todavía no aparece en sus directorios de apps) y pega la clave cuando te pida conectar.
- Elige un disparador, como Nueva respuesta de confirmación o Nueva foto o video, y selecciona tu evento de la lista.
La lista de eventos muestra los eventos que gestionas cuyo plan incluye webhooks. Cada Zap o escenario que actives aparece en la página Webhooks del evento, marcado como Zapier o Make.
También puedes usar Webhooks by Zapier → Catch Hook de Zapier o el Custom webhook de Make en lugar de la app de Fotify: copia la dirección que te den y añádela como URL de webhook en el Paso 2.
Paso 2: Añade una URL de webhook
- Abre tu evento en el panel y baja hasta la tarjeta Webhooks, Zapier y Make.
- Haz clic en Configurar webhooks y luego en Añadir un webhook.
- Pega la dirección que debe recibir los mensajes. Debe empezar por
https://y ser accesible desde internet. - Marca qué enviar, añade una etiqueta si quieres y haz clic en Añadir webhook.
- Copia el secreto de firma que aparece sobre el nuevo webhook y guárdalo en tu receptor.
- Haz clic en Enviar evento de prueba para comprobar que todo llega.
Solo las personas que pueden gestionar el evento pueden añadir o cambiar sus webhooks, y cada momento requiere acceso a sus datos: los momentos de invitados requieren acceso a la lista de invitados y los de fotos, acceso a la galería.
Cómo es un mensaje
Cada mensaje es un POST con un cuerpo 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
}
}
}
El status de una RSVP es uno de accepted, declined, not_answered, attended, pending_approval (a la espera de tu aprobación) o waitlisted. Un invitado pendiente de aprobación o en la lista de espera tiene confirmedGuests en 0 y el grupo que pidió en requestedGuests; rsvp.responded se dispara de nuevo cuando lo apruebas o lo rechazas.
El id se mantiene igual cuando se vuelve a enviar un mensaje, así que tu receptor puede omitir los duplicados. Los encabezados indican el momento (Fotify-Event) y el mensaje (Fotify-Delivery).
Las fechas del propio evento, como eventDate y eventTime, se dan en la zona horaria del lugar, tal como las ven tus invitados.
Comprueba que un mensaje viene de Fotify
Cada mensaje lleva un encabezado Fotify-Signature como t=1780000000,v1=5257a8…. Para comprobarlo:
- Toma
t(la hora de envío) y el cuerpo sin procesar de la solicitud. - Calcula un HMAC-SHA256 de
t+.+ cuerpo, usando el secreto de firma de tu webhook. - Compara el resultado con
v1y rechaza los mensajes cuyottenga más de 5 minutos.
En 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));
}
Puedes volver a mostrar el secreto o crear uno nuevo desde la tarjeta del webhook. Un secreto nuevo reemplaza al anterior de inmediato.
Reintentos, registro de entregas y webhooks que se desactivan
- Responde con un estado 2xx en menos de 10 segundos para confirmar un mensaje.
- Los mensajes fallidos se reintentan 8 veces durante unas 4 horas.
- El registro de entregas de cada webhook muestra todos los mensajes de los últimos 30 días, con su estado, la respuesta y el cuerpo completo. Haz clic en Enviar de nuevo para reenviar uno.
- Un webhook se desactiva solo cuando su URL falla 50 veces seguidas, cuando el receptor responde
410 Gone(así es como Zapier y Make indican que se eliminó un Zap o escenario) o cuando la persona que lo añadió ya no tiene acceso al evento. Su tarjeta indica el motivo. Vuelve a activarlo cuando el problema esté resuelto: pasas a ser la persona en cuyo nombre actúa.
Configura webhooks con un asistente de IA
Si conectaste un asistente de IA como Claude, puedes pedirle que liste los webhooks de tu evento, añada uno, envíe una prueba o elimine uno. Necesita que le des la URL y te muestra el secreto de firma una sola vez.
Preguntas frecuentes
P: ¿Qué plan necesito? R: Los webhooks, Zapier y Make están incluidos desde el plan Professional y en todas las suscripciones de evento. En otros planes, la tarjeta de Webhooks indica qué plan los incluye.
P: ¿Necesito una cuenta de Zapier o Make? R: Sí, para usar Zapier o Make necesitas una cuenta allí. Los webhooks a tu propia URL no necesitan nada más.
P: ¿Cuántos webhooks puede tener un evento? R: Hasta 25, contando los que crean Zapier y Make.
P: ¿Por qué no llegó una foto a mi webhook? R: Las fotos se envían cuando aparecen en la galería. Una foto pendiente de aprobación se envía cuando la apruebas, y las fotos de álbumes privados nunca se envían.
P: ¿Puedo usar una URL de mi propio ordenador para probar?
R: No. Fotify solo envía a direcciones https:// públicas. Usa un servicio de túnel o un inspector de solicitudes para probar desde tu ordenador.
P: ¿Qué pasa con mis webhooks si revoco una clave de API? R: Zapier y Make dejan de poder crear o eliminar suscripciones con esa clave. Elimina las suscripciones que ya no quieras desde la página de Webhooks del evento.
¿Te resultó útil este artículo?