Webhook

الـ webhook هو استدعاء HTTP يُرسل البيانات تلقائيًا من تطبيق إلى آخر عند وقوع حدث محدد. وعلى عكس [واجهات API](/glossary/api) التي تتطلب الاستعلام الدوري عن التحديثات، تدفع الـ webhooks البيانات في الوقت الفعلي فور وقوع الأحداث. يستمع التطبيق المستقبِل عند عنوان URL محدد ويعالج البيانات الواردة فور وصولها. تتبع الـ webhooks نموذج الناشر-المشترك؛ إذ يُطلق التطبيق المصدر (الناشر) طلب HTTP POST إلى عنوان URL مسجَّل مسبقًا كلما وقع حدث مُحفِّز، ويعالج المشترك الحمولة دون الحاجة إلى طلبها.

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

تدعم ميزة [الأتمتة والتكاملات](/features/automation-and-integrations) في FlipLink الـ webhooks التي تُطلَق عند وقوع الأحداث الرئيسية. يمكنك تهيئة نقاط نهاية الـ webhook لاستقبال البيانات عند التقاط عميل محتمل جديد، أو عرض مستند، أو إتمام عملية بيع عبر Stripe. يرسل كل webhook حمولة JSON منظَّمة تحتوي على تفاصيل الحدث إلى عنوان URL الذي تحدده. ويتيح لك ذلك ربط FlipLink بأي نظام تقريبًا، بما في ذلك أدوات مثل Zapier وMake أو الأنظمة الخلفية المخصصة. وبالاشتراك مع [تكامل Google Sheets](/features/automation-and-integrations)، تمنح الـ webhooks الناشرين طريقة مرنة لأتمتة سير عمل النشر بالكامل دون كتابة أي شيفرة.

عند وقوع حدث مُحفِّز، يرسل FlipLink طلب HTTP POST إلى عنوان نقطة النهاية المسجَّل لديك. ويحتوي جسم الطلب على حمولة JSON منظَّمة على النحو التالي: - **نوع الحدث** — سلسلة نصية تحدد الحدث (على سبيل المثال `lead.captured`، `document.viewed`، `sale.completed`). - **الطابع الزمني** — التاريخ والوقت بتنسيق ISO 8601. - **بيانات الحمولة** — الحقول الخاصة بالحدث مثل اسم جهة الاتصال والبريد الإلكتروني وعنوان المستند أو قيمة المعاملة. ينبغي أن تُرجع نقطة النهاية الخاصة بك رمز الحالة HTTP 200 لتأكيد الاستلام. وإذا أعادت نقطة النهاية خطأً أو انتهت مهلتها، يُعيد FlipLink محاولة التسليم لضمان عدم فقدان أي أحداث. تُرسَل جميع حمولات الـ webhook عبر HTTPS، فتكون البيانات مشفَّرة أثناء النقل. وبالنسبة للمطوّرين الذين يبنون تكاملات مخصصة، فإن البنية الموحَّدة لـ JSON تجعل من السهل تحليل الأحداث وتوجيهها إلى المعالج المناسب في تطبيقك.

1. **هيّئ نقطة النهاية الخاصة بك.** أنشئ عنوان URL يعمل بـ HTTPS على خادمك أو على Zapier أو Make أو أي خدمة قادرة على استقبال طلبات POST. يجب أن تكون نقطة النهاية متاحة للجميع وتُرجع استجابة 200. 2. **انتقل إلى التكاملات.** من لوحة تحكم FlipLink، ادخل إلى إعدادات [الأتمتة والتكاملات](/features/automation-and-integrations) الخاصة بمنشورك. 3. **أضف عنوان webhook.** الصق عنوان URL لنقطة النهاية في حقل إعداد الـ webhook. 4. **اختر الأحداث المُحفِّزة.** حدّد الأحداث التي ينبغي أن تُطلق الـ webhook — التقاط عميل محتمل، أو عرض مستند، أو إتمام بيع، أو غيرها بحسب احتياجات سير عملك. 5. **أرسل حدث اختبار.** استخدم وظيفة الاختبار لإرسال حمولة عيّنة إلى نقطة النهاية. تحقق من أن نظامك يستقبل البيانات ويعالجها بشكل صحيح. 6. **انتقل إلى التشغيل الفعلي.** احفظ إعداداتك. من هذه النقطة، سيُطلق كل حدث مطابق في كتابك التفاعلي طلب POST لحظي إلى نقطة النهاية. 7. **راقب التسليم.** افحص سجلات نقطة النهاية بشكل دوري للتأكد من وصول الـ webhooks. وإذا لاحظت فجوات، فتحقق من أن نقطة النهاية تُرجع استجابات 200 ومن أن قواعد جدار الحماية على خادمك لا تحجب طلبات FlipLink.

| الجانب | Webhook | استعلام API | |--------|---------|-------------| | **تسليم البيانات** | يُدفَع تلقائيًا عند وقوع الأحداث | يُسحَب وفق جدول زمني تحدده | | **زمن الاستجابة** | شبه فوري (أجزاء من الثانية) | يعتمد على فترة الاستعلام (ثوانٍ إلى دقائق) | | **الحمل على الخادم** | بسيط — تحدث الطلبات عند إطلاق الأحداث فقط | أعلى — تحدث الطلبات في كل فترة حتى لو لم يتغيّر شيء | | **التطبيق** | تسجيل عنوان URL ومعالجة طلبات POST الواردة | بناء مهمة مجدوَلة تستدعي نقطة نهاية API بشكل متكرر | | **الأنسب لـ** | الإشعارات اللحظية، ومزامنة CRM، والتنبيهات الفورية | المعالجة المجمَّعة، والتقارير الدورية، ولقطات البيانات | | **المخاطر** | يمكن أن يفوّت تعطُّل نقطة النهاية أحداثًا دون منطق إعادة المحاولة | لا تفوت أحداث مع استعلام لاحق، لكن الإدراك يتأخر | بالنسبة لمعظم ناشري FlipLink، تُعدّ الـ webhooks الخيار الأفضل لالتقاط العملاء المحتملين وأحداث المبيعات حيث تكون السرعة عاملًا حاسمًا. ويعمل استعلام API بشكل أفضل لعمليات تصدير التحليلات الدورية أو لوحات التحكم التي تتحدث على فترات محددة. ويستخدم كثير من الفرق الاثنين معًا: الـ webhooks لتوجيه العملاء المحتملين لحظيًا و[واجهة REST API](/glossary/rest-api) لسحب التحليلات الليلية.