Webhook بالعربي: إزاي برنامجين يكلموا بعض لحظة ما حاجة تحصل

Webhook هو الطريقة اللي برنامج بيبلّغ بيها برنامج تاني لحظة ما حاجة تحصل: عميل عمل أوردر، أو ليد ملا فورم، أو دفع اتأكد. بدل ما سكريبتك يفضل يسأل المتجر كل 5 دقايق “فيه أوردرات جديدة؟”، المتجر نفسه بيبعتلك تفاصيل الأوردر في نفس الثانية على رابط إنت محدده. وده أساس أي أتمتة بالكود: من غير Webhook هتفضل يا متأخر يا بتستهلك موارد على الفاضي.
لو عايز التعريف المختصر بس، عندك Webhook في القاموس. المقال ده للخطوة اللي بعدها: إزاي تستقبل Webhook فعلًا بسكريبت صغير في Google Apps Script أو PHP، وإزاي تختبره قبل ما تعتمد عليه، وإزاي تأمّنه علشان محدش يبعتلك بيانات مزيفة، وأمثلة من ووكومرس وفيسبوك وبوابات الدفع.
محتويات المقال
Webhook بيشتغل إزاي من جوه؟
أي Webhook فيه 3 أطراف:
- المصدر: البرنامج اللي الحدث بيحصل عنده، زي ووكومرس أو سلة أو بوابة دفع أو فيسبوك.
- الرابط (Webhook URL): عنوان على الإنترنت إنت بتعمله وبتديه للمصدر.
- المستقبِل: الكود اللي شغال على الرابط ده، بيستلم البيانات ويعمل بيها حاجة.
لما الحدث يحصل، المصدر بيبعت طلب HTTP من نوع POST للرابط، وجواه البيانات غالبًا بصيغة JSON. الكود بتاعك بيقرا البيانات، ويعمل المطلوب (يكتب في شيت، يبعت إشعار، يحدّث CRM)، ويرد بكود 200 معناه “استلمت”. لو ما ردّتش أو رديت بخطأ، أغلب المصادر بتحاول تاني كام مرة.
الفرق بين Webhook والـ API
الـ API إنت اللي بتسأل: “ابعتلي الأوردرات”. الـ Webhook هو اللي بيبلّغك: “فيه أوردر جديد، أهو”. في الشغل الحقيقي بتستخدم الاتنين مع بعض: الـ Webhook يقولك إن فيه أوردر رقم 1520، وتستخدم الـ API تجيب تفاصيل زيادة لو محتاجها. شرح الـ API نفسه في API يعني إيه.
| الـ API (السؤال) | الـ Webhook (الإشعار) | |
|---|---|---|
| مين بيبدأ | إنت | المصدر |
| التوقيت | لما تسأل | لحظة الحدث |
| الاستهلاك | طلبات كتير حتى لو مفيش جديد | طلب واحد لكل حدث |
| محتاج | مفتاح وصلاحية | رابط شغال على طول |
تستقبل Webhook بـ Google Apps Script من غير سيرفر
ده أسهل طريق لو بياناتك هتروح جوجل شيت، ومش محتاج استضافة ولا سيرفر. افتح الشيت، ومن Extensions اختار Apps Script، والصق:
function doPost(e) {
const data = JSON.parse(e.postData.contents);
const sheet = SpreadsheetApp.getActive().getSheetByName('orders');
sheet.appendRow([
new Date(),
data.id,
data.billing ? data.billing.first_name : '',
data.billing ? data.billing.phone : '',
data.total
]);
return ContentService.createTextOutput('ok');
}بعدها من Deploy اختار New deployment، والنوع Web app، وخلي Execute as نفسك وWho has access على Anyone. هياخد منك صلاحيات مرة واحدة، وبعدين يديك رابط بينتهي بـ /exec. ده الـ Webhook URL اللي هتحطه في المصدر.
ملاحظتين مهمين: أي تعديل في الكود محتاج Deploy جديد (أو تعديل الـ deployment الموجود) علشان يتطبق. والرابط ده عام، أي حد يعرفه يقدر يبعتله، فلازم تأمّنه زي ما هنشرح تحت. وعندك تفاصيل أكتر عن الطريقة دي في ربط فورم الموقع بـ Google Sheets، ولو أول مرة تتعامل مع Apps Script ابدأ من Google Apps Script للمسوّقين.
تستقبل Webhook بـ PHP على استضافتك
لو عندك موقع ووردبريس أو أي استضافة PHP، تقدر تعمل ملف صغير يستقبل الـ Webhook. ده أسرع من Apps Script وبيدّيك تحكم أكبر:
// webhook-orders.php
$raw = file_get_contents('php://input');
$data = json_decode($raw, true);
if (!$data) { http_response_code(400); exit('bad'); }
$line = date('c') . ' | ' . ($data['id'] ?? '') . ' | ' . ($data['total'] ?? '') . PHP_EOL;
file_put_contents(__DIR__ . '/../private/orders.log', $line, FILE_APPEND);
http_response_code(200);
echo 'ok';الكود بيقرا الجسم الخام للطلب، ويحوّله من JSON، ويسجّل سطر في ملف برة الفولدر العام للموقع. في الشغل الحقيقي بدل الملف هتكتب في قاعدة بيانات، أو تبعت إشعار، أو تنادي API تاني. القاعدة الذهبية: رد بسرعة. لو المعالجة هتاخد وقت، سجّل البيانات وارجع بـ 200 فورًا، وكمّل المعالجة بعدين بمهمة مجدولة.
أمثلة Webhook من أدوات بتستخدمها
ووكومرس
من WooCommerce ثم Settings ثم Advanced ثم Webhooks، تعمل Webhook جديد وتختار الحدث (Topic) زي Order created أو Order updated، وتحط الرابط، وتكتب Secret. ووكومرس بيبعت مع كل طلب توقيع في هيدر اسمه X-WC-Webhook-Signature، وده اللي هتتحقق بيه إن الطلب جاي من متجرك فعلًا. ومن هنا تقدر تبعت كل أوردر جديد لشيت متابعة زي شيت الأوردرات، أو لشركة الشحن، أو رسالة تأكيد للعميل.
سلة وزد
المنصتين فيهم Webhooks للأحداث المهمة (أوردر جديد، تغيير حالة، عميل جديد) من لوحة المطورين أو التطبيقات. ودي أساس ربطهم بأنظمة المحاسبة والمخزون، زي اللي في ربط سلة وزد مع الأنظمة الأخرى.
ليدز فيسبوك
فيسبوك بيبعت Webhook لما حد يملا فورم إعلان ليدز، بس محتاج تطبيق على Meta for Developers وخطوة تحقق: أول مرة فيسبوك بيبعت طلب GET فيه hub.challenge، والكود بتاعك لازم يرجّعه زي ما هو علشان يثبت إنه بتاعك. الإعداد ده أعقد شوية، فلو عايز طريق أسهل، عندك ربط ليدز فيسبوك بـ Google Sheets بأكتر من طريقة.
بوابات الدفع
بوابات الدفع بتبعت Webhook لما الدفع ينجح أو يفشل أو يترد. ده أهم Webhook في المتجر، لأن الاعتماد على صفحة “تم الدفع” اللي العميل بيشوفها بس غلط: العميل ممكن يقفل الصفحة قبل ما تحمّل. الـ Webhook هو المصدر الموثوق إن الفلوس اتدفعت.
تأمين Webhook: ما تصدقش أي طلب
الرابط بتاعك عام، وأي حد ممكن يبعتله بيانات مزيفة: أوردر مش موجود، أو دفع ما حصلش. علشان كده:
- اتحقق من التوقيع: أغلب المصادر بتبعت توقيع محسوب من البيانات وسر مشترك (HMAC). إنت بتحسب نفس التوقيع عندك وتقارنه. لو مختلف، ارفض الطلب.
- استخدم HTTPS بس: علشان البيانات ما تتقريش في الطريق.
- ما تعتمدش على البيانات الحساسة من الـ Webhook لوحده: لو الحدث “دفع ناجح”، اتأكد من حالة الدفع بطلب API مباشر لبوابة الدفع قبل ما تشحن.
- اتعامل مع التكرار: المصدر ممكن يبعت نفس الحدث مرتين لو ما وصلوش ردك في الوقت. احفظ رقم الحدث أو الأوردر، ولو اتكرر تجاهله.
- ما تطبعش البيانات في سجلات عامة: أرقام التليفونات والعناوين بيانات شخصية، وأي ملف سجل لازم يكون برة الفولدر اللي الزوار يقدروا يوصلوله.
مثال التحقق من توقيع ووكومرس بـ PHP:
$secret = 'السر-اللي-كتبته-في-ووكومرس';
$sig = $_SERVER['HTTP_X_WC_WEBHOOK_SIGNATURE'] ?? '';
$calc = base64_encode(hash_hmac('sha256', $raw, $secret, true));
if (!hash_equals($calc, $sig)) { http_response_code(401); exit('invalid'); }hash_equals بتقارن بطريقة آمنة. وخلي السر في ملف إعدادات برة الفولدر العام، مش مكتوب في الكود زي المثال.
تختبر Webhook إزاي قبل ما تعتمد عليه
أكبر غلطة إنك تربط Webhook وتفترض إنه شغال. اختبر على 3 مراحل:
- شوف شكل البيانات الأول: قبل ما تكتب أي كود، حط رابط مؤقت من خدمة زي webhook.site في المصدر، واعمل حدث تجريبي (أوردر تجريبي مثلًا). هتشوف البيانات بالظبط بتيجي إزاي، وأسماء الحقول، والهيدرز. ده بيوفر ساعات تخمين.
- جرّب الكود بطلب يدوي: ابعت نفس البيانات لرابطك بأداة زي Postman أو أمر curl، واتأكد إن الكود بيكتب صح.
- جرّب من المصدر الحقيقي: اعمل أوردر تجريبي حقيقي وتابع إنه وصل. وأغلب المصادر عندها سجل بيوريك كل محاولة إرسال ونتيجتها، زي صفحة الـ Webhook في ووكومرس.
وبعد ما يشتغل، حط مراقبة بسيطة: لو مفيش ولا Webhook وصل من أكتر من يوم والمتجر شغال، ابعتلك تنبيه. الـ Webhooks ممكن تتوقف بصمت لو المصدر عطّلها بعد أخطاء كتير، وده حصل كتير. وتقدر تبعت التنبيه ده على تليجرام بالطريقة اللي في تنبيهات تليجرام من Google Sheets.
أفكار Webhook جاهزة تبدأ بيها
لو مش عارف تبدأ منين، دي أفكار بتتكرر في أغلب المتاجر والشركات، وكل واحدة فيها بتوفر شغل يدوي يومي:
- أوردر جديد ← رسالة تأكيد للعميل: أول ما الأوردر يتعمل، العميل يوصله تأكيد فيه رقم الأوردر والمبلغ. ودي من أسرع الطرق اللي بتقلل رفض الاستلام في الدفع عند الاستلام.
- أوردر جديد ← تنبيه للمخزن: المخزن يعرف فورًا يجهّز إيه، بدل ما يستنى حد يطبع الأوردرات آخر اليوم.
- ليد جديد ← المبيعات في دقيقة: كل ما الليد يتأخر في الرد، فرصة إقفاله بتقل. الـ Webhook بيوصّل الليد لمسؤول المبيعات لحظة ما يتسجل، وده جوهر أتمتة المبيعات.
- دفع ناجح ← فاتورة: الفاتورة تتعمل وتتبعت لوحدها، زي اللي في الفاتورة الأوتوماتيك من جوجل شيت.
- تغيير حالة الشحنة ← تحديث العميل: لو شركة الشحن عندها Webhook، العميل يعرف إن شحنته خرجت للتوصيل من غير ما يكلّمك.
- تقييم سلبي ← تنبيه للمدير: أي تقييم أقل من 3 نجوم يوصل للمسؤول فورًا علشان يتعامل معاه قبل ما يكبر.
ابدأ بواحدة بس، الأكتر تكرارًا والأوضح في نتيجتها، وخليها تشتغل أسبوعين وتتأكد إنها مستقرة قبل ما تضيف التانية.
Webhook بالكود ولا بأداة زي n8n؟
أدوات زي n8n وZapier وMake بتديك رابط Webhook جاهز، وتوصّله بخطوات من غير كود. ده ممتاز لو الشغل بسيط وعايز تخلص بسرعة. الكود بيبقى أنسب لما:
- عدد الأحداث كبير: المنصات بتتحاسب بعدد العمليات، والسكريبت على استضافتك تكلفته ثابتة تقريبًا.
- محتاج منطق خاص: شروط كتير، أو حسابات، أو تعامل مع بيانات معقدة.
- عايز البيانات تفضل عندك: من غير ما تعدي على منصة تالتة.
- محتاج سرعة رد عالية وتحكم في الأمان والتوقيع.
ومقارنة المنصات نفسها في Make ولا Zapier ولا n8n. وكتير بيبقى الحل الأحسن خليط: Webhook بيوصل لسكريبت صغير بيتحقق وينضف البيانات، وبعدين يبعتها لأداة أتمتة تكمّل باقي الخطوات.
أسئلة شائعة
يعني إيه Webhook URL؟
ده الرابط اللي بتعمله وتديه للبرنامج المصدر، وعليه الكود اللي بيستقبل البيانات. ممكن يكون رابط Apps Script، أو ملف على استضافتك، أو رابط جاهز من n8n أو Zapier.
محتاج سيرفر علشان أستقبل Webhook؟
مش لازم. Google Apps Script بيدّيك رابط مجاني من غير سيرفر، وأدوات الأتمتة بتدّيك رابط جاهز. السيرفر أو الاستضافة بيبقى أفضل لما العدد يكبر أو المعالجة تبقى تقيلة.
الـ Webhook بيبعت البيانات بصيغة إيه؟
غالبًا JSON في جسم طلب POST. بعض الأدوات القديمة بتبعت بصيغة فورم عادية. أسهل طريقة تعرف: ابعت حدث تجريبي على webhook.site وشوف.
ليه الـ Webhook وقف فجأة؟
الأسباب المشهورة: الرابط اتغير بعد Deploy جديد، أو الكود بيرجّع خطأ فالمصدر عطّل الـ Webhook بعد محاولات فاشلة، أو انتهت صلاحية في الاستضافة. راجع سجل المحاولات في المصدر الأول.
الـ Webhook بيوصل على طول ولا ممكن يتأخر؟
غالبًا بيوصل في ثواني. بس لو السيرفر بتاعك كان واقع أو رد بخطأ، المصدر بيعيد المحاولة بعد دقايق أو ساعات حسب نظامه. علشان كده خلي عندك مراجعة يومية بالـ API تلقط أي حدث فاته الـ Webhook.
الـ Webhook آمن؟
آمن لو اتحققت من التوقيع، واستخدمت HTTPS، وما اعتمدتش عليه لوحده في القرارات الحساسة زي الشحن بعد الدفع.
لو عايز تربط متجرك أو موقعك بأنظمتك التانية بـ Webhooks مضمونة ومؤمّنة، سواء بالكود أو بأداة أتمتة، شوف خدمة أتمتة الأعمال أو ابعتلي تفاصيل الربط اللي محتاجه: احجز استشارة.