8 min okunduintermediateSon güncelleme: 9 Kas 2026

Etkinliğinizin RSVP'lerini, Girişlerini ve Fotoğraflarını Diğer Uygulamalara Gönderme

Webhooks, etkinliğinizin neler olduğunu diğer uygulamalara olduğu anda bildirmesini sağlar. Bir misafir RSVP yanıtını verdiğinde, kapıda girişi yapıldığında veya galeriye yeni bir fotoğraf eklendiğinde Fotify, seçtiğiniz bir adrese küçük bir mesaj gönderir. Oradan CRM'inize, bir Google E-Tablosuna, bir Slack kanalına, bir e-posta serisine veya kendi sunucunuza ulaşabilir.

İki şekilde bağlanabilirsiniz:

  • Zapier veya Make, kod yazmadan: bir API anahtarıyla bağlanın ve ne olacağını seçin.
  • Kendinize ait bir webhook URL'si: Fotify buraya imzalı bir JSON mesajı gönderir.

Webhooks, Zapier ve Make Professional planından itibaren ve bir etkinlik aboneliği altında çalışan her etkinlikte dahildir.

Fotify Neler Gönderebilir

Her webhook, şu anlardan birini veya birkaçını dinler:

  • RSVP alındı: bir misafir RSVP yanıtını verdi veya değiştirdi. Adı, e-postası, telefonu, yanıtı, kişi sayısı, yorumları ve özel sorularınızın yanıtlarını içerir.
  • Misafir giriş yaptı: bir misafirin girişi kapıda yapıldı; grup ve gelen kişi bilgisiyle birlikte.
  • Yeni fotoğraf veya video: galeriye yeni bir şey eklendi. Fotoğraflar, 7 gün boyunca çalışan bir görsel bağlantısıyla gelir. Onay bekleyen fotoğraflar siz onayladığınızda gönderilir, özel albümlerdeki fotoğraflar ise asla gönderilmez.
  • Etkinlik başladı: etkinliği başlattınız ve misafirler yükleme yapabilir.
  • Etkinlik bitti: etkinliği sonlandırdınız veya yükleme süresi doldu.

Adım 1: Zapier veya Make'i Bağlayın

  1. Fotify panosunda Hesap ayarları → Entegrasyonlar bölümünü açın.
  2. Anahtara bir ad yazın, örneğin "Zapier", ve Anahtar oluştur'a tıklayın.
  3. Anahtarı hemen kopyalayın. Güvenliğiniz için yalnızca bir kez gösterilir.
  4. Fotify uygulamasını bu bağlantılardan Zapier veya Make üzerinde açın (uygulama henüz uygulama dizinlerinde listelenmiyor) ve bağlanmanız istendiğinde anahtarı yapıştırın.
  5. Yeni RSVP yanıtı veya Yeni fotoğraf veya video gibi bir tetikleyici seçin ve listeden etkinliğinizi belirleyin.

Etkinlik listesi, planı webhooks içeren ve yönettiğiniz etkinlikleri gösterir. Açtığınız her Zap veya senaryo, etkinliğin Webhooks sayfasında Zapier veya Make olarak işaretlenmiş şekilde görünür.

Fotify uygulaması yerine Zapier'ın Webhooks by Zapier → Catch Hook özelliğini ya da Make'in Custom webhook özelliğini de kullanabilirsiniz: verdikleri adresi kopyalayın ve Adım 2'de bir webhook URL'si olarak ekleyin.

Adım 2: Webhook URL'si Ekleyin

  1. Etkinliğinizi panoda açın ve Webhooks, Zapier ve Make kartına kadar kaydırın.
  2. Webhooks'u kur'a, ardından Webhook ekle'ye tıklayın.
  3. Mesajları alacak adresi yapıştırın. https:// ile başlamalı ve internetten erişilebilir olmalıdır.
  4. Nelerin gönderileceğini işaretleyin, isterseniz bir etiket ekleyin ve Webhook ekle'ye tıklayın.
  5. Yeni webhook'un üstünde gösterilen imza sırrını kopyalayın ve alıcınızda saklayın.
  6. Her şeyin ulaştığını kontrol etmek için Test olayı gönder'e tıklayın.

Webhook'ları yalnızca etkinliği yönetebilen kişiler ekleyebilir veya değiştirebilir; ayrıca her an, verilerine erişim gerektirir: misafir anları için misafir listesine, fotoğraf anları için galeriye erişim gerekir.

Bir Mesaj Nasıl Görünür

Her mesaj, JSON gövdeli bir POST isteğidir:

{
  "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
    }
  }
}

Bir RSVP'nin status değeri şunlardan biridir: accepted, declined, not_answered, attended, pending_approval (onayınızı bekliyor) veya waitlisted. Onay bekleyen ya da bekleme listesindeki bir misafirin confirmedGuests değeri 0'dır; istediği grup büyüklüğü requestedGuests içinde yer alır. Onayladığınızda veya reddettiğinizde rsvp.responded yeniden tetiklenir.

Bir mesaj tekrar gönderildiğinde id aynı kalır; böylece alıcınız yinelenenleri atlayabilir. Başlıklar anı (Fotify-Event) ve mesajı (Fotify-Delivery) belirtir.

eventDate ve eventTime gibi etkinliğin kendi tarihleri, misafirlerinizin gördüğü şekilde mekânın saat diliminde verilir.

Bir Mesajın Fotify'dan Geldiğini Doğrulayın

Her mesaj, t=1780000000,v1=5257a8… gibi bir Fotify-Signature başlığı taşır. Doğrulamak için:

  1. t değerini (gönderilme zamanı) ve ham istek gövdesini alın.
  2. Webhook'unuzun imza sırrını kullanarak t + . + gövde için bir HMAC-SHA256 hesaplayın.
  3. Sonucu v1 ile karşılaştırın ve t değeri 5 dakikadan eski olan mesajları reddedin.

Node.js'te:

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));
}

Sırrı webhook'un kartından tekrar gösterebilir veya yenisini oluşturabilirsiniz. Yeni bir sır, eskisinin yerini hemen alır.

Yeniden Denemeler, Gönderim Günlüğü ve Kapanan Webhooks

  • Bir mesajı onaylamak için 10 saniye içinde 2xx durum koduyla yanıt verin.
  • Başarısız mesajlar yaklaşık 4 saat içinde 8 kez yeniden denenir.
  • Her webhook'taki gönderim günlüğü, son 30 günün her mesajını durumu, yanıtı ve tam gövdesiyle gösterir. Birini yeniden göndermek için Tekrar gönder'e tıklayın.
  • Bir webhook kendini kapatır: URL'si üst üste 50 kez başarısız olduğunda, alıcı 410 Gone yanıtı verdiğinde (Zapier ve Make bir Zap'in veya senaryonun silindiğini böyle bildirir) ya da onu ekleyen kişinin etkinliğe erişimi kalmadığında. Kartı nedenini belirtir. Sorun çözüldükten sonra tekrar açın: adına işlem yapılan kişi siz olursunuz.

Bir Yapay Zeka Asistanıyla Webhooks Kurma

Claude gibi bir yapay zeka asistanı bağladıysanız, ondan etkinliğinizin webhook'larını listelemesini, bir tane eklemesini, test göndermesini veya birini silmesini isteyebilirsiniz. URL'yi sizden alması gerekir ve imza sırrını size yalnızca bir kez gösterir.

Sık Sorulan Sorular

S: Hangi plana ihtiyacım var? C: Webhooks, Zapier ve Make Professional planından itibaren ve her etkinlik aboneliğinde dahildir. Diğer planlarda Webhooks kartı, bunları içeren planı belirtir.

S: Zapier veya Make hesabına ihtiyacım var mı? C: Evet, Zapier veya Make kullanmak için orada bir hesabınızın olması gerekir. Kendi URL'nize gönderilen webhooks için başka bir şey gerekmez.

S: Bir etkinliğin kaç webhook'u olabilir? C: Zapier ve Make'in oluşturduklarıyla birlikte en fazla 25.

S: Bir fotoğraf neden webhook'uma ulaşmadı? C: Fotoğraflar galeride göründüklerinde gönderilir. Onay bekleyen bir fotoğraf siz onayladığınızda gönderilir, özel albümlerdeki fotoğraflar ise asla gönderilmez.

S: Test etmek için kendi bilgisayarımdaki bir URL'yi kullanabilir miyim? C: Hayır. Fotify yalnızca herkese açık https:// adreslerine gönderir. Bilgisayarınızdan test etmek için bir tünel hizmeti veya bir istek denetleyicisi kullanın.

S: Bir API anahtarını iptal edersem webhook'larıma ne olur? C: Zapier ve Make artık o anahtarla abonelik oluşturamaz veya kaldıramaz. İstemediğiniz abonelikleri etkinliğin Webhooks sayfasından silin.

Bu makale yardımcı oldu mu?

İlgili Makaleler