이벤트의 RSVP, 체크인, 사진을 다른 앱으로 보내는 방법
웹훅을 사용하면 이벤트에서 일어나는 일을 발생하는 즉시 다른 앱에 알릴 수 있습니다. 게스트가 RSVP에 응답하거나, 입구에서 체크인되거나, 갤러리에 새 사진이 올라오면 Fotify가 지정한 주소로 작은 메시지를 보냅니다. 그 메시지는 CRM, Google 스프레드시트, Slack 채널, 이메일 시퀀스 또는 직접 운영하는 서버로 전달될 수 있습니다.
연결 방법은 두 가지입니다.
- Zapier 또는 Make: 코딩 없이 API 키로 연결하고 어떤 일이 일어나야 하는지 선택합니다.
- 직접 만든 웹훅 URL: Fotify가 서명된 JSON 메시지를 해당 주소로 보냅니다.
웹훅, Zapier, Make는 Professional 플랜 이상과 이벤트 구독으로 운영되는 모든 이벤트에 포함됩니다.
Fotify가 보낼 수 있는 항목
각 웹훅은 다음 순간 중 하나 이상을 수신 대기합니다.
- RSVP 수신: 게스트가 RSVP에 응답하거나 변경했습니다. 이름, 이메일, 전화번호, 응답, 동반 인원, 코멘트, 사용자 지정 질문의 답변이 포함됩니다.
- 게스트 체크인: 게스트가 입구에서 체크인되었습니다. 일행과 도착한 사람의 정보가 포함됩니다.
- 새 사진 또는 비디오: 갤러리에 새 항목이 올라왔습니다. 사진에는 7일 동안 유효한 이미지 링크가 함께 전달됩니다. 승인 대기 중인 사진은 승인하는 시점에 전송되며, 비공개 앨범의 사진은 절대 전송되지 않습니다.
- 이벤트 시작: 이벤트를 시작하여 게스트가 업로드할 수 있습니다.
- 이벤트 종료: 이벤트를 종료했거나 업로드 기간이 끝났습니다.
1단계: Zapier 또는 Make 연결하기
- Fotify 대시보드에서 계정 설정 → 연동을 엽니다.
- 키 이름(예: "Zapier")을 입력하고 키 만들기를 클릭합니다.
- 키를 바로 복사하세요. 보안을 위해 한 번만 표시됩니다.
- Zapier 또는 Make 링크에서 Fotify 앱을 엽니다(아직 두 서비스의 앱 디렉터리에는 등록되어 있지 않습니다). 연결을 요청하면 키를 붙여 넣습니다.
- New RSVP response 또는 New photo or video 같은 트리거를 선택하고 목록에서 이벤트를 고릅니다.
이벤트 목록에는 플랜에 웹훅이 포함된, 내가 관리하는 이벤트가 표시됩니다. 켜 둔 각 Zap 또는 시나리오는 이벤트의 웹훅 페이지에 Zapier 또는 Make 표시와 함께 나타납니다.
Fotify 앱 대신 Zapier의 Webhooks by Zapier → Catch Hook 또는 Make의 Custom webhook을 사용할 수도 있습니다. 그쪽에서 받은 주소를 복사해 2단계에서 웹훅 URL로 추가하세요.
2단계: 웹훅 URL 추가하기
- 대시보드에서 이벤트를 열고 웹훅, Zapier 및 Make 카드까지 스크롤합니다.
- 웹훅 설정을 클릭한 다음 웹훅 추가를 클릭합니다.
- 메시지를 받을 주소를 붙여 넣습니다.
https://로 시작해야 하며 인터넷에서 접근할 수 있어야 합니다. - 보낼 항목을 선택하고, 원하면 라벨을 추가한 뒤 웹훅 추가를 클릭합니다.
- 새 웹훅 위에 표시된 서명 시크릿을 복사해 수신 측에 보관합니다.
- 테스트 이벤트 보내기를 클릭해 모든 것이 도착하는지 확인합니다.
이벤트를 관리할 수 있는 사람만 웹훅을 추가하거나 변경할 수 있으며, 각 항목은 해당 데이터에 대한 접근 권한이 필요합니다. 게스트 관련 항목은 게스트 목록에 대한 접근 권한이, 사진 관련 항목은 갤러리에 대한 접근 권한이 필요합니다.
메시지는 이런 모습입니다
모든 메시지는 JSON 본문을 가진 POST 요청입니다.
{
"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
}
}
}
RSVP의 status는 accepted, declined, not_answered, attended, pending_approval(승인을 기다리는 중) 또는 waitlisted 중 하나입니다. 승인 대기 중이거나 대기자 명단에 있는 게스트는 confirmedGuests가 0이고, 요청한 인원은 requestedGuests에 담깁니다. 게스트를 승인하거나 거절하면 rsvp.responded가 다시 발생합니다.
메시지를 다시 보내도 id는 그대로이므로, 수신 측에서 중복을 건너뛸 수 있습니다. 헤더에는 해당 순간(Fotify-Event)과 메시지(Fotify-Delivery)가 표시됩니다.
eventDate, eventTime 같은 이벤트 자체의 날짜와 시간은 게스트에게 보이는 방식 그대로 행사장의 시간대로 제공됩니다.
메시지가 Fotify에서 왔는지 확인하기
모든 메시지에는 t=1780000000,v1=5257a8… 같은 Fotify-Signature 헤더가 포함됩니다. 확인 방법은 다음과 같습니다.
t(전송 시각)와 원본 요청 본문을 가져옵니다.- 웹훅의 서명 시크릿으로
t+.+ 본문의 HMAC-SHA256을 계산합니다. - 결과를
v1과 비교하고,t가 5분 이상 지난 메시지는 거부합니다.
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));
}
웹훅 카드에서 시크릿을 다시 확인하거나 새로 만들 수 있습니다. 새 시크릿은 이전 시크릿을 즉시 대체합니다.
재시도, 전송 기록, 꺼지는 웹훅
- 2xx 상태로 응답하면 10초 이내에 메시지를 확인한 것으로 처리됩니다.
- 실패한 메시지는 재시도됩니다. 약 4시간 동안 8번 시도합니다.
- 각 웹훅의 전송 기록에는 최근 30일간의 모든 메시지가 상태, 응답, 전체 본문과 함께 표시됩니다. 다시 보내기를 클릭하면 메시지를 다시 전송합니다.
- 웹훅은 스스로 꺼집니다. URL이 연속 50번 실패하거나, 수신 측이
410 Gone으로 응답하거나(Zapier와 Make가 Zap 또는 시나리오가 삭제되었음을 알리는 방식입니다), 웹훅을 추가한 사람이 더 이상 이벤트에 접근할 수 없을 때입니다. 카드에 그 이유가 표시됩니다. 문제를 해결한 뒤 다시 켜세요. 그러면 내가 해당 웹훅의 주체가 됩니다.
AI 어시스턴트로 웹훅 설정하기
Claude 같은 AI 어시스턴트를 연결했다면, 이벤트의 웹훅 목록 확인, 추가, 테스트 전송, 삭제를 요청할 수 있습니다. URL은 직접 알려 주어야 하며, 서명 시크릿은 한 번만 보여 줍니다.
자주 묻는 질문
Q: 어떤 플랜이 필요한가요? A: 웹훅, Zapier, Make는 Professional 플랜 이상과 모든 이벤트 구독에 포함됩니다. 다른 플랜에서는 웹훅 카드에 이를 포함하는 플랜이 안내됩니다.
Q: Zapier나 Make 계정이 필요한가요? A: 네, Zapier나 Make를 사용하려면 해당 서비스의 계정이 필요합니다. 직접 만든 URL로 보내는 웹훅에는 다른 것이 필요하지 않습니다.
Q: 이벤트당 웹훅을 몇 개까지 만들 수 있나요? A: Zapier와 Make가 만든 것을 포함해 최대 25개입니다.
Q: 사진이 웹훅으로 전달되지 않았어요. 왜죠? A: 사진은 갤러리에 나타나는 시점에 전송됩니다. 승인 대기 중인 사진은 승인하는 시점에 전송되며, 비공개 앨범의 사진은 절대 전송되지 않습니다.
Q: 테스트하려고 내 컴퓨터의 URL을 쓸 수 있나요?
A: 아니요. Fotify는 공개 https:// 주소로만 전송합니다. 컴퓨터에서 테스트하려면 터널 서비스나 요청 검사 도구를 사용하세요.
Q: API 키를 폐기하면 웹훅은 어떻게 되나요? A: Zapier와 Make는 해당 키로 구독을 만들거나 제거할 수 없게 됩니다. 더 이상 필요 없는 구독은 이벤트의 웹훅 페이지에서 삭제하세요.
이 문서가 도움이 되었나요?