كيفية ربط الـ Webhooks وZapier وMake بمنصة SocialProof.Reviews

تبلغ الشهادات أقصى أثرها حين تتدفق آلياً إلى بقية منظومة أعمالك؛ نظام إدارة علاقات العملاء، وقناة Slack، ومنصة التسويق عبر البريد الإلكتروني، وجداول البيانات. تُطلق منصة SocialProof.Reviews إشعار webhook فور ورود أي شهادة جديدة، فتحصل على مُحفِّز آني يمكنك توجيهه إلى أي وجهة تختارها.

ما هو الـ Webhook؟

الـ webhook طلب HTTP POST تُرسله مساحة عملك إلى عنوان URL تحدده، في اللحظة التي تَرِد فيها شهادة جديدة. يحمل الطلب كامل تفاصيل التقديم: اسم صاحب المراجعة، وبريده الإلكتروني، ودرجة التقييم، ونص المراجعة، والصور، والبيانات الوصفية. ويستطيع النظام المُستقبِل عندئذٍ اتخاذ أي إجراء تريده: تسجيل البيانات، أو تنبيه الفريق، أو تحديث سجل في نظام CRM، أو تشغيل تسلسل رسائل تلقائي.

إعداد عنوان URL للـ Webhook

الخطوة 1: الانتقال إلى إعدادات مساحة العمل

سجّل الدخول إلى SocialProof.Reviews، وافتح مساحة العمل، ثم توجّه إلى قسم التضمين والتكاملات في لوحة الإدارة، وافتح تبويب Webhooks.

الخطوة 2: إضافة عنوان URL لنقطة النهاية

الصق عنوان URL الذي ستستقبل عليه طلب POST، ويمكن أن يكون:

• عنوان webhook محفِّز من Zapier
• عنوان webhook من Make (Integromat سابقاً)
• نقطة نهاية على خادمك الخاص
• عنوان من Pipedream أو n8n أو أي منصة أتمتة أخرى

الخطوة 3: الحفظ والاختبار

اضغط حفظ، ثم استخدم زر إرسال حدث تجريبي لإطلاق حمولة نموذجية إلى نقطة النهاية، وتحقّق من وصولها كما ينبغي قبل الانتقال إلى التشغيل الفعلي.

صيغة حمولة الـ webhook

تُرسَل مع كل شهادة حمولة JSON بالبنية التالية:

{
  "event": "testimonial.submitted",
  "workspaceId": "abc123",
  "testimonialId": "t_xyz789",
  "submittedAt": "2026-03-17T10:30:00Z",
  "reviewer": {
    "name": "Jane Smith",
    "email": "[email protected]",
    "jobTitle": "Head of Marketing",
    "company": "Acme Corp",
    "photoUrl": "https://..."
  },
  "rating": 5,
  "review": "This tool completely changed how we collect and display customer feedback.",
  "photos": ["https://...", "https://..."],
  "videoUrl": null,
  "approved": false,
  "source": "collect-form"
}

---

الربط بـ Zapier

يتيح لك Zapier ربط SocialProof.Reviews بأكثر من 6,000 تطبيق دون كتابة أي شفرة برمجية.

الخطوة 1: إنشاء Zap جديد

سجّل الدخول إلى zapier.com واضغط Create Zap.

الخطوة 2: إعداد المُحفِّز

1. ابحث عن تطبيق Webhooks by Zapier واختره محفِّزاً
2. اختر حدث Catch Hook محفِّزاً
3. اضغط Continue، وسيُولّد Zapier عنوان webhook فريداً بالصيغة https://hooks.zapier.com/hooks/catch/123456/abcdef/
4. انسخ هذا العنوان

الخطوة 3: لصق العنوان في SocialProof.Reviews

1. افتح صفحة Webhooks وZapier في لوحة إدارة مساحة العمل
2. الصق عنوان Zapier في حقل عنوان URL لنقطة النهاية
3. اضغط حفظ التغييرات

الخطوة 4: الاختبار — لا بد أن يكون Zapier في وضع الإنصات أولاً

⚠️ تنبيه مهم: لا يقبل Zapier الحمولة التجريبية إلا حين يكون منتظراً المحفِّز فعلياً. فإن لم يكن في وضع الإنصات ستتلقى خطأ 401.

1. في Zapier، تأكد أنك في خطوة Test trigger — فعند هذه الخطوة يكون Zapier منصِتاً
2. ارجع إلى SocialProof.Reviews واضغط ⚡ إرسال تجريبي
3. عد إلى Zapier واضغط Test trigger — سيؤكّد استلام الحمولة ويعرض كل الحقول المتاحة (اسم المُراجِع، بريده، التقييم، نص المراجعة، وغيرها)

الخطوة 5: إضافة الإجراء

يمكنك الآن ربط أي إجراء تريده. ومن الأمثلة:

تنبيه الفريق عبر Slack:

• تطبيق الإجراء: Slack
• الحدث: Send Channel Message
• الرسالة: وردت مراجعة جديدة ⭐⭐⭐⭐⭐ من {{reviewer__name}} في {{reviewer__company}}: "{{review}}"
• القناة: #testimonials

إضافة المُراجِع إلى قائمة بريدية (Mailchimp):

• تطبيق الإجراء: Mailchimp
• الحدث: Add/Update Subscriber
• البريد: {{reviewer__email}}
• الاسم الأول: {{reviewer__name}}
• الوسم: testimonial-submitted

تسجيل البيانات في Google Sheet:

• تطبيق الإجراء: Google Sheets
• الحدث: Create Spreadsheet Row
• تعيين الأعمدة: التاريخ، الاسم، البريد، الشركة، التقييم، نص المراجعة

إنشاء جهة اتصال في HubSpot:

• تطبيق الإجراء: HubSpot
• الحدث: Create or Update Contact
• البريد: {{reviewer__email}}
• خاصية مخصّصة «قدّم شهادة»: نعم

الخطوة 6: تفعيل الـ Zap

اضغط Publish، وستُشغّل كل شهادة جديدة سير عملك آلياً.

---

الربط بـ Make (Integromat سابقاً)

Make منصة أتمتة مرئية وأقرب إلى ذهنية المطوّرين، وتناسبك متى احتجت إلى تدفقات متعددة الخطوات، أو منطق شرطي، أو تحويل بيانات.

الخطوة 1: إنشاء سيناريو جديد

سجّل الدخول إلى make.com واضغط Create a new scenario.

الخطوة 2: إضافة وحدة Webhooks

1. اضغط + لإضافة وحدة
2. ابحث عن Webhooks
3. اختر Custom webhook (وليس "Custom mailhook")
4. اضغط Add، ثم أعطِ الوحدة اسماً (مثل "SocialProof Reviews")، ثم اضغط Save
5. يُولّد Make عنواناً بالصيغة https://hook.eu1.make.com/abc123xyz — انسخه
6. اضغط OK على الوحدة، وستظهر عليها أيقونة ساعة (🕐) دلالةً على أنها في وضع انتظار البيانات

الخطوة 3: لصق العنوان في SocialProof.Reviews

1. افتح صفحة Webhooks وZapier في لوحة الإدارة
2. الصق عنوان Make في حقل عنوان URL لنقطة النهاية
3. اضغط حفظ التغييرات

الخطوة 4: إرسال الاختبار — لا بد أن يكون Make في وضع الإنصات أولاً

⚠️ تنبيه مهم: لا يستقبل Make الـ webhook إلا حين يكون منصِتاً فعلياً؛ وإلا ستحصل على خطأ 401.

1. في Make، تأكّد من ظهور أيقونة الساعة على وحدة الـ webhook — فهذه إشارة إلى أنها تنتظر
2. إن لم تظهر، فاضغط Run once (أسفل يسار محرر السيناريو) لإعادة التنشيط
3. ارجع إلى SocialProof.Reviews واضغط ⚡ إرسال تجريبي
4. عد إلى Make، وستجده قد التقط الحمولة واكتشف حقولها تلقائياً (الحدث، اسم المُراجِع، البريد، التقييم، نص المراجعة، وغيرها)
5. اضغط OK لاعتماد بنية البيانات

الخطوة 5: تحديد بنية البيانات

بعد استلام الحمولة التجريبية، يعرض Make كامل الحقول المتاحة لاستخدامها داخل الأتمتة.

الخطوة 5: إضافة وحدات بعد المحفِّز

من الأمثلة القوية على أتمتة Make:

التصفية حسب التقييم ثم الإشعار:

• أضف وحدة Filter: المتابعة فقط إذا كان rating >= 4
• أضف وحدة Slack: النشر في قناة #wins

الاعتماد التلقائي للشهادات ذات التقييم المرتفع:

• أضف Filter: التقييم = 5
• أضف وحدة HTTP: PATCH إلى نقطة نهاية API لمساحة العمل لضبط approved: true

الإضافة إلى CRM بمنطق شرطي:

• أضف وحدة Router لتقسيم المسارات
• المسار أ: إن لم يكن reviewer.company فارغاً ← حدّث سجل الشركة في Salesforce
• المسار ب: إن كان reviewer.company فارغاً ← أضف إلى قائمة Mailchimp للعملاء الأفراد

إنشاء مُدخل في قاعدة بيانات Notion:

• أضف وحدة Notion: Create database item
• عيّن الحقول: الاسم، الشركة، التقييم، نص المراجعة، تاريخ التقديم

الخطوة 6: تفعيل السيناريو

اضغط مفتاح التشغيل أسفل يسار محرر السيناريو لتفعيله، وسيُعالج Make من حينها كل webhook وارد لكل شهادة جديدة.

---

ملاحظة أمنية

تُرسِل SocialProof.Reviews الـ webhooks من مجموعة ثابتة من عناوين IP، وتُدرج رأس توقيع (X-SPR-Signature) يمكنك استخدامه للتحقق من أصالة الطلب. وللتحقق:

1. احسب HMAC-SHA256 لنص الطلب الخام باستخدام المفتاح السرّي لمساحة عملك
2. قارن الناتج بقيمة X-SPR-Signature
3. لا تُعالج الطلب إلا عند تطابق القيمتين

يمنع ذلك هجمات إعادة التشغيل ويضمن استحالة تمرير شهادات مُزيّفة إلى منظومة أتمتتك.

---

حالات الاستخدام الشائعة للـ Webhook

حالة الاستخدام	المنصة	المحفِّز	الإجراء
تنبيه فوري في Slack	Zapier	testimonial.submitted	رسالة Slack
وسم آلي في القائمة البريدية	Make	testimonial.submitted (تقييم ≥ 4)	وسم المشترك
تسجيل كل المراجعات	Zapier	testimonial.submitted	صف في Google Sheets
الدفع إلى CRM	Make	testimonial.submitted	جهة اتصال في HubSpot/Salesforce
اعتماد آلي للتقييم الخماسي	Make	testimonial.submitted (تقييم = 5)	API PATCH approved=true
تشغيل تسلسل بريدي	Zapier	testimonial.submitted	أتمتة في Mailchimp

---

استكشاف الأخطاء وحلّها

الخطوة 1 — تحقّق أولاً عبر webhook.site

قبل إلقاء اللوم على Make أو Zapier أو خادمك، تأكّد من أن SocialProof.Reviews يُرسل الطلب فعلاً:

1. افتح webhook.site — وستحصل فوراً على عنوان URL فريد دون الحاجة إلى تسجيل
2. انسخ هذا العنوان
3. الصقه في حقل عنوان URL لنقطة النهاية داخل إعدادات Webhooks وZapier
4. اضغط حفظ التغييرات
5. اضغط ⚡ إرسال تجريبي

من المفترض أن تظهر لك رسالة ✓ تم الإرسال! سُلّمت الحمولة إلى نقطة النهاية. داخل التطبيق، وأن يظهر طلب جديد في webhook.site خلال ثانية أو ثانيتين. اضغط عليه لمعاينة حمولة JSON كاملة.

فإن استقبلها webhook.site فهذا يعني أن webhook الخاص بـ SocialProof.Reviews يعمل سليماً، وأن الخلل في إعدادات Make أو Zapier لا في المنصة؛ فانتقل إلى الخطوة 2.

أما إن لم يستقبلها webhook.site، فتأكّد من أنك ضغطت حفظ التغييرات بعد لصق العنوان، ومن أن مفتاح تفعيل الـ webhooks مُفعَّل.

---

الخطوة 2 — معالجة خطأ 401 في Make: احذف وحدة الـ webhook وأعد إنشاءها

خطأ 401 من Make يعني أن رمز الـ webhook غير صالح أو غير مُسجَّل، فالمنصة لا تتعرّف على العنوان. يحدث ذلك حين لا يُحفظ السيناريو بعد إنشاء الـ webhook، أو حين يُحذف الـ webhook. ولن يحلّ ضغط "Run once" هذه المشكلة؛ بل يلزم إعادة إنشاء وحدة الـ webhook بالكامل.

1. في سيناريو Make، انقر بزر الفأرة الأيمن على وحدة Webhooks ← اضغط Delete
2. اضغط + لإضافة وحدة جديدة ← ابحث عن Webhooks ← اختر Custom webhook
3. اضغط Add ← سمِّها (مثل "SocialProof Reviews") ← اضغط Save
4. يُولّد Make عنواناً جديداً — انسخه، ثم اضغط OK لإغلاق النافذة
5. الأهم: اضغط زر 💾 Save (أعلى محرر السيناريو) لحفظ الـ webhook الجديد. فإن أغفلت هذه الخطوة لن يُسجَّل الرمز وستتكرر رسالة 401.
6. اضغط الآن Run once (أسفل يسار)، ولا بد أن تظهر أيقونة ساعة (🕐) على الوحدة دلالةً على أن Make صار منصِتاً
7. عد إلى SocialProof.Reviews — الصق العنوان الجديد في عنوان URL لنقطة النهاية، واضغط حفظ التغييرات، ثم ⚡ إرسال تجريبي

سيلتقط Make الحمولة ويعرض كامل الحقول المتاحة. اضغط OK لاعتماد بنية البيانات، ثم تابع بناء السيناريو.

---

✗ HTTP 401 — رفض Make أو Zapier الطلب. أشيع الأسباب أن Make أو Zapier لم يكن منصِتاً فعلياً حين ضغطت "إرسال تجريبي"، أو أن رمز الـ webhook غير صالح (راجع الخطوة 2 أعلاه لـ Make). الإصلاح:

• Make: اتّبع الخطوة 2 أعلاه لحذف وحدة الـ webhook وإعادة إنشائها، واحفظ السيناريو، ثم اضغط Run once قبل الإرسال التجريبي.
• Zapier: انتقل إلى خطوة Test trigger في محرر Zap ليكون منصِتاً، ثم اضغط إرسال تجريبي مجدداً. لا يبقى وضع الإنصات نشطاً إلا لدقائق معدودة، فاحرص على الاختبار فور تفعيله.

✗ HTTP 404 — تعذّر العثور على عنوان الـ webhook. العنوان محذوف، أو أن السيناريو/الـ Zap مُعطَّل. ارجع إلى Make أو Zapier، وتحقّق من وجود الوحدة، ثم انسخ عنواناً جديداً.

✗ تعذّر الاتصال / HTTP 0. إما أن العنوان غير قابل للوصول، أو أنك لم تحفظه بعد. تأكّد من أنك ضغطت حفظ التغييرات بعد لصق العنوان، ومن أنه يبدأ بـ https://.

يُسلَّم الاختبار لكن التقديمات الحقيقية لا تُشغِّل الـ webhook. تحقّق من أمرين: (1) أن مفتاح تفعيل الـ webhooks مُفعَّل ومحفوظ، و(2) أن الأحداث المطلوبة مُحدَّدة ضمن الأحداث المُرسَلة. لن تُشغّل التقديمات الحقيقية الـ webhook إلا إذا كان مُفعَّلاً.

نقطة النهاية لا تستلم الـ webhook. تأكّد من أن العنوان متاح للعموم؛ فعناوين localhost المحلية مرفوضة. واستعن بـ webhook.site للتأكد من أن الحمولة تُرسَل فعلاً (راجع الخطوة 1 أعلاه).

تصلني أحداث مكرَّرة. طبّق مبدأ الـ idempotency في نقطة النهاية المُستقبِلة باستخدام testimonialId مفتاحاً لإزالة التكرار.