8 min قراءةintermediateآخر تحديث: 9 نوفمبر 2026

كيفية إرسال ردود الحضور وتسجيلات الدخول والصور الخاصة بفعاليتك إلى تطبيقات أخرى

تتيح لك Webhooks أن تُعلم فعاليتك التطبيقات الأخرى بما يحدث فور حدوثه. عندما يرد ضيف على دعوة الحضور، أو يُسجَّل دخوله عند الباب، أو تظهر صورة جديدة في المعرض، ترسل Fotify رسالة صغيرة إلى العنوان الذي تختاره. ومن هناك يمكن أن تصل إلى نظام CRM أو جدول Google أو قناة Slack أو سلسلة رسائل بريد إلكتروني أو خادمك الخاص.

يمكنك الربط بطريقتين:

  • Zapier أو Make، دون كتابة كود: اربط باستخدام مفتاح API واختر ما الذي يجب أن يحدث.
  • رابط Webhook خاص بك: ترسل Fotify إليه رسالة JSON موقّعة.

تُشمل Webhooks وZapier وMake ابتداءً من خطة Professional وما فوقها، وفي كل فعالية تعمل ضمن اشتراك الفعاليات.

ما الذي يمكن لـ Fotify إرساله

يستمع كل Webhook إلى واحدة أو أكثر من هذه اللحظات:

  • استلام رد حضور: ردّ ضيف على الدعوة أو غيّر ردّه. يتضمن اسمه وبريده الإلكتروني وهاتفه وإجابته وحجم مجموعته وتعليقاته وإجابات أسئلتك المخصصة.
  • تسجيل دخول ضيف: تم تسجيل دخول ضيف عند الباب، مع المجموعة والشخص الذي وصل.
  • صورة أو فيديو جديد: ظهر محتوى جديد في المعرض. تأتي الصور مع رابط للصورة يعمل لمدة 7 أيام. تُرسل الصور التي تنتظر الموافقة بعد أن توافق عليها، ولا تُرسل أبدًا صور الألبومات الخاصة.
  • بدء الفعالية: بدأت الفعالية ويمكن للضيوف رفع الصور.
  • انتهاء الفعالية: أنهيت الفعالية أو أُغلقت نافذة الرفع الخاصة بها.

الخطوة 1: ربط Zapier أو Make

  1. في لوحة تحكم Fotify، افتح إعدادات الحساب ← التكاملات.
  2. اكتب اسمًا للمفتاح، مثل "Zapier"، ثم انقر إنشاء مفتاح.
  3. انسخ المفتاح فورًا. لأمانك، يظهر مرة واحدة فقط.
  4. افتح تطبيق Fotify في Zapier أو Make من هذين الرابطين (فهو غير مدرج في دليلي تطبيقاتهما بعد)، والصق المفتاح عندما يطلب منك الربط.
  5. اختر مشغّلًا، مثل New RSVP response أو New photo or video، ثم اختر فعاليتك من القائمة.

تعرض قائمة الفعاليات الفعاليات التي تديرها والتي تشمل خطتها Webhooks. يظهر كل Zap أو سيناريو تشغّله في صفحة Webhooks الخاصة بالفعالية، مع وسم Zapier أو Make.

يمكنك أيضًا استخدام Webhooks by Zapier ← Catch Hook في Zapier أو Custom webhook في Make بدلًا من تطبيق Fotify: انسخ العنوان الذي يعطيانك إياه وأضفه كرابط Webhook في الخطوة 2.

الخطوة 2: إضافة رابط Webhook

  1. افتح فعاليتك في لوحة التحكم ومرّر إلى بطاقة Webhooks وZapier وMake.
  2. انقر إعداد Webhooks، ثم إضافة Webhook.
  3. الصق العنوان الذي يجب أن يستقبل الرسائل. يجب أن يبدأ بـ https:// وأن يكون متاحًا عبر الإنترنت.
  4. حدّد ما تريد إرساله، وأضف تسمية إن رغبت، ثم انقر إضافة Webhook.
  5. انسخ سر التوقيع الظاهر أعلى الـ Webhook الجديد واحفظه لدى المستقبِل.
  6. انقر إرسال حدث تجريبي للتأكد من وصول كل شيء.

لا يستطيع إضافة Webhooks الفعالية أو تغييرها إلا من يستطيعون إدارتها، وتتطلب كل لحظة صلاحية الوصول إلى بياناتها: تتطلب لحظات الضيوف صلاحية الوصول إلى قائمة الضيوف، وتتطلب لحظات الصور صلاحية الوصول إلى المعرض.

كيف تبدو الرسالة

كل رسالة هي طلب POST بمحتوى 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
    }
  }
}

تكون status الخاصة بـ RSVP إحدى القيم accepted أو declined أو not_answered أو attended أو pending_approval (بانتظار موافقتك) أو waitlisted. الضيف الذي ينتظر الموافقة أو الموجود في قائمة الانتظار تكون قيمة confirmedGuests لديه 0، ويكون عدد من طلب اصطحابهم في requestedGuests؛ ويُطلَق rsvp.responded مرة أخرى عندما توافق عليه أو ترفضه.

يبقى id كما هو عند إعادة إرسال الرسالة، ليتمكن المستقبِل من تجاهل التكرارات. تحدد الترويسات اللحظة (Fotify-Event) والرسالة (Fotify-Delivery).

تُعطى تواريخ الفعالية نفسها، مثل eventDate وeventTime، بالمنطقة الزمنية للمكان، كما يراها ضيوفك.

التحقق من أن الرسالة جاءت من Fotify

تحمل كل رسالة ترويسة Fotify-Signature مثل t=1780000000,v1=5257a8…. وللتحقق منها:

  1. خذ t (وقت الإرسال) ومحتوى الطلب الخام.
  2. احسب HMAC-SHA256 للقيمة t + . + المحتوى، باستخدام سر توقيع الـ Webhook الخاص بك.
  3. قارن النتيجة مع 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));
}

يمكنك إظهار السر مرة أخرى أو إنشاء سر جديد من بطاقة الـ Webhook. يحل السر الجديد محل القديم فورًا.

إعادة المحاولة وسجل التسليم وإيقاف Webhooks تلقائيًا

  • أجب برمز حالة 2xx خلال 10 ثوانٍ لتأكيد استلام الرسالة.
  • تُعاد محاولة الرسائل الفاشلة 8 مرات خلال نحو 4 ساعات.
  • يعرض سجل التسليم في كل Webhook كل رسائل آخر 30 يومًا، مع حالتها والرد والمحتوى الكامل. انقر إرسال مرة أخرى لإعادة إرسال إحداها.
  • يوقف الـ Webhook نفسه عندما يفشل رابطه 50 مرة متتالية، أو عندما يرد المستقبِل بـ 410 Gone (هكذا تخبر Zapier وMake بأن Zap أو سيناريو قد حُذف)، أو عندما يفقد من أضافه صلاحية الوصول إلى الفعالية. تذكر بطاقته السبب. أعد تشغيله بعد إصلاح المشكلة: وستصبح أنت الشخص الذي يعمل باسمه.

إعداد Webhooks باستخدام مساعد ذكاء اصطناعي

إذا ربطت مساعد ذكاء اصطناعي مثل Claude، يمكنك أن تطلب منه عرض Webhooks الخاصة بفعاليتك، أو إضافة واحد، أو إرسال اختبار، أو حذف واحد. يحتاج إلى الرابط منك، ويعرض عليك سر التوقيع مرة واحدة.

الأسئلة الشائعة

س: ما الخطة التي أحتاجها؟ ج: تُشمل Webhooks وZapier وMake ابتداءً من خطة Professional وما فوقها وفي كل اشتراك فعاليات. في الخطط الأخرى تذكر بطاقة Webhooks الخطة التي تشملها.

س: هل أحتاج إلى حساب في Zapier أو Make؟ ج: نعم، لاستخدام Zapier أو Make تحتاج إلى حساب لديهما. أما Webhooks إلى رابطك الخاص فلا تحتاج إلى شيء آخر.

س: كم Webhook يمكن أن تحتوي الفعالية؟ ج: حتى 25، بما فيها تلك التي تنشئها Zapier وMake.

س: لماذا لم تصل صورة إلى الـ Webhook الخاص بي؟ ج: تُرسل الصور عند ظهورها في المعرض. تُرسل الصورة التي تنتظر الموافقة بعد أن توافق عليها، ولا تُرسل أبدًا صور الألبومات الخاصة.

س: هل يمكنني استخدام رابط على جهاز الكمبيوتر الخاص بي للاختبار؟ ج: لا. ترسل Fotify فقط إلى عناوين https:// العامة. استخدم خدمة أنفاق أو أداة لفحص الطلبات للاختبار من جهازك.

س: ماذا يحدث لـ Webhooks الخاصة بي إذا ألغيت مفتاح API؟ ج: تفقد Zapier وMake القدرة على إنشاء الاشتراكات أو إزالتها بذلك المفتاح. احذف الاشتراكات التي لم تعد تريدها من صفحة Webhooks الخاصة بالفعالية.

هل كانت هذه المقالة مفيدة؟

مقالات ذات صلة