لو بتدور على Webhook شرح بسيط من غير كود، خد الجملة دي الأول: الـ Webhook رقم تليفون للـ workflow بتاعك. أي برنامج تاني يعرف الرقم يقدر يتصل بيه، وأول ما يتصل الـ workflow يصحى ويشتغل ومعاه البيانات اللي اتبعتت. فورم اتملى، أوردر جديد في متجرك، دفعة اتسجلت، كلها ممكن توصل للـ workflow في نفس الثانية.
في المقال ده هشرح الفكرة لحد مش مبرمج، وبعدين نطبّقها على n8n: الفرق بين Test URL و Production URL، مثال فورم طلبات، وإزاي تقفل الرقم ده في وش أي حد مش المفروض يتصل.
المحتويات
- Push و Pull: الفرق اللي بيخلّيك تحتاج Webhook
- الـ Webhook ماهو بالظبط؟
- Webhook شرح عملي على n8n: Test URL و Production URL
- مثال: فورم طلبات بيسجّل في الشيت
- إزاي تحمي الـ Webhook بتاعك
- أخطاء بشوفها كتير
- أسئلة شائعة
Push و Pull: الفرق اللي بيخلّيك تحتاج Webhook
فيه طريقتين الـ workflow يعرف بيهم إن حاجة جديدة حصلت.
الطريقة الأولى اسمها pull أو polling. الـ workflow بيسأل كل شوية: "فيه أوردرات جديدة؟". في n8n ده Schedule Trigger بيشتغل كل 5 دقايق مثلاً ويروح يقرا من مكان ما. شبه إنك تفتح باب الشقة كل 5 دقايق تشوف فيه حد ولا لأ. أغلب المرات مفيش حد، والمرة اللي فيها حد ممكن يكون مستني من 4 دقايق.
الطريقة التانية اسمها push. البرنامج التاني هو اللي بيبلّغك أول ما الحاجة تحصل. ده الجرس. مش محتاج تفتح الباب كل شوية، الجرس هيضرب لما حد يوصل. الـ Webhook هو الجرس ده.
الـ pull مش غلط. تقرير مبيعات بيتبعت كل يوم الساعة 9 مكانه Schedule Trigger. لكن لو عميل ملى فورم وعايز رد دلوقتي، أو صيدلية في إسكندرية عايزة تعرف بالطلب أول ما يوصل، الـ push أسرع وأرخص لأنه مش بيشغّل الـ workflow على الفاضي.
الـ Webhook ماهو بالظبط؟
تقنياً، الـ Webhook رابط (URL). البرنامج التاني بيبعت على الرابط ده طلب HTTP، غالباً POST، وجوّاه البيانات بصيغة JSON. لو مش عارف يعني ايه HTTP و JSON، اقرا الأول ايه هو الـ API؟ لأن الـ Webhook هو نفس فكرة الـ API بس بالعكس: في الـ API انت اللي بتسأل، وفي الـ Webhook حد تاني هو اللي بيكلّمك.
الطلب اللي بيوصل فيه 3 أجزاء هتقابلهم في n8n:
- الـ body: البيانات نفسها، زي اسم العميل والمنتج والكمية.
- الـ query: بيانات صغيرة مكتوبة في آخر الرابط بعد علامة
?. - الـ headers: بيانات عن الطلب نفسه، زي نوع المحتوى، وأحياناً كلمة سر.
المنصات الكبيرة بتدعم Webhooks جاهزة. متجر على سلة مثلاً يقدر يبعت webhook لما أوردر جديد يتعمل، وده شرحته بالتفصيل في ويب هوك سلة مع n8n.
Webhook شرح عملي على n8n: Test URL و Production URL
في n8n فيه node اسمها Webhook. أول ما تحطها في workflow جديد هتلاقي فيها رابطين، وده أكتر حاجة بتلخبط الناس في الأول.
الـ Test URL شكله كده:
https://YOUR_DOMAIN/webhook-test/orders
ده بيشتغل وانت بتبني. بتدوس على Listen for test event (أو Execute workflow)، و n8n يفضل مستني طلب واحد لمدة محدودة، الـ docs بتقول 120 ثانية. لما الطلب يوصل، بتشوف البيانات قدامك في الـ output panel، وتبني باقي الـ workflow عليها.
الـ Production URL شكله كده:
https://YOUR_DOMAIN/webhook/orders
لاحظ إن الفرق كلمة واحدة: webhook-test بدل webhook. الرابط ده بيشتغل بس بعد ما تعمل Publish للـ workflow، وبيفضل شغّال طول الوقت. لكن البيانات مش هتظهر في الـ editor. هتلاقيها في تاب Executions بتاع الـ workflow.
الإعدادات المهمة في الـ node:
- HTTP Method: غالباً POST. الـ node بتدعم كمان GET و PUT و PATCH و DELETE و HEAD.
- Path: آخر جزء في الرابط. n8n بيحط اسم عشوائي عشان ميحصلش تعارض، وتقدر تغيّره لاسم مفهوم زي
orders. - Respond: إمتى الـ Webhook يرد على اللي بعتله. إما فوراً، أو لما آخر node تخلص، أو من خلال node اسمها Respond to Webhook لو عايز تتحكم في الرد بنفسك.
مثال: فورم طلبات بيسجّل في الشيت
خلّينا نبني حاجة حقيقية. محل صغير بيبيع شنط جلد وعايز فورم طلبات: العميل يكتب اسمه ورقمه والمنتج، الطلب يتسجّل في Google Sheets، وصاحب المحل يوصله تنبيه على Telegram.
فيه طريقتين في n8n:
الأولى: Form Trigger. دي node بتعمل الفورم نفسه، فيها حقول نص ورقم وقائمة اختيارات وملف. ليها برضه Test URL و Production URL، وبتقدر تختار الفورم يرد "تم الاستلام" فوراً أو بعد ما الـ workflow يخلص. لو معندكش موقع، دي أسهل بداية.
التانية: Webhook. دي لما الفورم موجود في مكان تاني، زي موقعك أو صفحة معمولة بـ Lovable، وعايزه يبعت البيانات لـ n8n.
الـ workflow في الحالتين:
- الـ trigger (Form أو Webhook) بيستقبل الطلب.
- Google Sheets node بتعمل Append لصف جديد فيه الاسم والرقم والمنتج والتاريخ.
- Telegram node بتبعتلك رسالة: "طلب جديد من فلان: شنطة سودا مقاس وسط".
- لو استخدمت Webhook، Respond to Webhook بترجّع للموقع رسالة "استلمنا طلبك".
ولو عايز تجرّب الـ Webhook من غير فورم، ابعتله طلب من الـ terminal بالـ Test URL وانت دايس Listen:
curl -X POST "https://YOUR_DOMAIN/webhook-test/orders" \
-H "Content-Type: application/json" \
-d '{"name": "Ahmed", "phone": "01000000000", "product": "black bag"}'
هتلاقي الـ body ظاهر في n8n، وتقدر تسحب name و product للـ nodes اللي بعده.
المثال ده بالظبط هو الـ lab بتاع المحاضرة 7 في دبلومة AI Automation العملية: فورم طلبات بيسجّل في الشيت ويرد على العميل، وبعدين workflow تاني بيبعت JSON للـ Webhook بتاعك انت.
إزاي تحمي الـ Webhook بتاعك
الـ Production URL رابط عام. أي حد يعرفه يقدر يبعتله بيانات، وده معناه أوردرات وهمية في الشيت، أو حد يشغّل الـ workflow آلاف المرات ويصرف رصيد الـ AI بتاعك لو فيه خطوة AI.
أسهل حماية في n8n اسمها Header Auth:
- في الـ Webhook node، خلّي Authentication = Header Auth.
- اعمل credential جديد: في Name اكتب اسم header، مثلاً
X-Api-Key، وفي Value اكتب كلمة سر طويلة وعشوائية. - أي برنامج هيبعت للـ Webhook لازم يحط الـ header ده بنفس القيمة. أي طلب من غيره n8n بيرفضه.
الطلب المحمي شكله كده:
curl -X POST "https://YOUR_DOMAIN/webhook/orders" \
-H "Content-Type: application/json" \
-H "X-Api-Key: YOUR_SECRET" \
-d '{"name": "Ahmed", "product": "black bag"}'
الـ node بتدعم كمان Basic Auth و JWT Auth. والمنصات الكبيرة زي Meta وسلة ليها طرق توقيع خاصة بيها، ودي بتتقرا من الـ docs بتاعة كل منصة.
وقاعدة مهمة: كلمة السر دي متتكتبش أبداً في صفحة HTML أو في كود بيشتغل في المتصفح. أي حد يفتح الصفحة يقدر يشوفها. لو الفورم على موقعك، خلّي السيرفر بتاعك هو اللي يبعت لـ n8n.
أخطاء بشوفها كتير
دي الأخطاء اللي بشوفها تتكرر مع الدارسين:
- الـ Test URL في الإنتاج. حد بيحط رابط
webhook-testفي المتجر، ويشتغل معاه وهو فاتح n8n، وتاني يوم مفيش ولا أوردر وصل. الحل: Production URL، والـ workflow يكون Published. - نسيان الـ Publish. الـ Production URL مش بيتسجّل غير لما تعمل Publish.
- البحث عن البيانات في الـ editor. في الإنتاج البيانات مش بتظهر في الـ canvas، بتظهر في Executions.
- نفس الـ Path مع نفس الـ Method في workflow تاني. n8n بيسمح بـ webhook واحد لكل مسار و method، والتاني هيطلع رسالة تعارض.
- الـ Method غلط. البرنامج بيبعت POST والـ node مستنية GET، فالطلب مش بيوصل.
- n8n على جهازك الشخصي. رابط
localhostمحدش في الإنترنت يقدر يوصله. محتاج n8n Cloud أو سيرفر عليه دومين. - workflow طويل بيرد متأخر. على n8n Cloud الطلب لازم يخلص في 100 ثانية وإلا بيفشل. لو الـ workflow فيه AI بطيء، رد فوراً وكمّل الشغل بعد الرد.
أسئلة شائعة
الـ Webhook ماهو وإيه الفرق بينه وبين الـ API؟
الـ API انت اللي بتبعتله سؤال وتستنى إجابة. الـ Webhook حد تاني هو اللي بيبعتلك لما حاجة تحصل. نفس التكنولوجيا (HTTP و JSON)، بس الاتجاه عكس.
محتاج أعرف برمجة عشان أستخدم Webhook في n8n؟
لأ. الـ Webhook node والـ Form Trigger بيتظبطوا من الواجهة. الـ curl اللي فوق للتجربة بس، وتقدر تستبدله بأي أداة زي Postman.
ليه الـ Test URL اشتغل والـ Production URL لأ؟
غالباً الـ workflow مش Published، أو انت بتبعت على الرابط الغلط، أو بتدور على النتيجة في الـ canvas بدل Executions.
أقدر أستقبل رسايل WhatsApp بـ Webhook؟
أيوه، من خلال WhatsApp Cloud API الرسمي بس. Meta بتبعت كل رسالة جديدة كـ webhook. الأدوات اللي بتشغّل رقمك الشخصي بشكل غير رسمي ممكن تقفل الرقم.
هل الـ Webhook آمن؟
آمن لما تحميه. من غير authentication أي حد يعرف الرابط يقدر يبعتله. Header Auth خطوة دقيقتين وبتقفل أغلب المشكلة.
لو عايز تشوف الـ Webhook شغّال قدامك قبل ما تقرر، تعالى الورشة المجانية، ولو عايز الصورة الكبيرة اقرا يعني ايه AI Automation.