3.5الخطافات والتكاملات المخصصة
الأساسي في 30 ثانية
- الخطاف (webhook) يُشغّل لحظيا : رابط يوفره سيناريوكم ؛ وحالما ترسل خدمة بيانات إليه، يبدأ السيناريو فورا.
- وحدة HTTP تنادي كل شيء : طلب GET/POST (رابط وطريقة وترويسات وجسم) نحو أي API، ورد غالبا بـJSON يُعيَّن.
- والأسرار تبقى أسرارا : مفتاح API عبر الاتصالات المشفرة للأداة، لا علنا أبدا — والخطاف مختبَر قبل بناء الباقي.
حالة مصغرة متسلسلة — لينا تربط أداتها المهنية دون موصّل
لينا، مسؤولة الرقمنة في وهران، تستعمل أداة مهنية دون موصّل جاهز : مستحيل الربط معياريا. تُنشئ سيناريو يُشغَّل بخطاف، وتلصق الرابط الموفر في إعدادات تبليغات الأداة، ثم ترسل نداء اختبار تراقب بنيته. وفي الاتجاه الآخر، تضيف وحدة HTTP تنادي API الخدمة (والمفتاح مخزَّن في الاتصال المشفر)، وتسترجع الرد وتعيّن حقوله نحو القاعدة. البرمجة بدون كود تصير بلا حدود.
الحلقة الأخيرة لخيط لينا — من اختيار الأداة إلى التكاملات المخصصة : الأتمتة المتقدمة من البداية إلى النهاية.
1. الخطاف، المشغّل الشامل
عندما لا يكون لتطبيق موصّل جاهز، نمر عبر الخطافات ونداءات API. الخطاف رابط يوفره سيناريوكم : وحالما ترسل خدمة أخرى بيانات إلى هذا الرابط (تأكيد دفع أو استمارة أو حدث مخصص)، ينطلق السيناريو فورا بهذه البيانات. إنه المشغّل الشامل، لحظيا.
والمبدأ المطلوب فهمه : « عنوان إذا خاطبناه أيقظ أتمتتي ». دون حاجة إلى برمجة : نلصق الرابط في إعدادات « الخطاف / التبليغات » للخدمة الأخرى، ونرسل نداء اختبار، ونراقب البنية المستلمة للتعيين.
2. وحدة HTTP وانضباط الأسرار
وفي الاتجاه الآخر، تتيح وحدة HTTP نداء أي API : إرسال طلب (GET أو POST…) إلى خدمة، بوسائطه وتصديقه، واسترجاع الرد (غالبا بـJSON) لباقي السيناريو. وفهم الأسس (الرابط والطريقة والترويسات والجسم و JSON) يفتح الوصول إلى آلاف الخدمات حتى دون موصّل رسمي.
انضباط لا مساومة فيه : مفتاح API كلمة سر — اتصالات الأداة المشفرة، وحقوق دنيا، وتجديد إذا احتمل التسرب، ولا علنا أبدا في السيناريو ولا على لقطة مشترَكة. الخطافات (دخولا) + نداءات HTTP (خروجا) تجعل البرمجة بدون كود فعلا بلا حدود : وهي أيضا الجسر نحو الذكاء الاصطناعي والتكاملات المخصصة في المستوى 4.
🔎 مثال ملموس — الاستلام بخطاف، ثم نداء API
تربط لينا ما لا يُربَط، في الاتجاهين.
المشغّل : خطاف (رابط يوفره السيناريو)
← الخدمة ترسل إليه بيانات (JSON) عند كل حدث
وحدة HTTP : نداء API (GET/POST وترويسات ومفتاح مشفر)
← استرجاع رد JSON وتعيينه نحو الفعل التالي.القراءة : دخول لحظي من جهة، وخروج مخصص من جهة أخرى.
الدرس : اختبار استلام الخطاف قبل بناء الباقي.
مفردات القسم
- الخطاف
- رابط يوفره سيناريوكم ؛ استلام بيانات عليه يُشغّله فورا (مشغّل شامل، لحظي).
مثال بسيط: الرابط الذي تلصقه لينا في تبليغات أداتها المهنية.
ما ليس كذلك: تحقق دوري بمهلة (استطلاع).
رد فعل: إرسال نداء اختبار ومراقبة البنية المستلمة.
- API
- واجهة تتيح لبرنامجين التواصل : نرسل طلبا ونستقبل ردا (غالبا بـ JSON).
مثال بسيط: API الأداة المهنية التي تستجوبها لينا عبر HTTP.
ما ليس كذلك: موصّل جاهز مدمج فعلا.
رد فعل: قراءة توثيق API قبل أول نداء.
- طلب HTTP
- نداء API (طريقة GET/POST… ورابط وترويسات وجسم) لقراءة بيانات أو إرسالها.
مثال بسيط: نداء لينا المضبوط نحو الخدمة الخارجية.
ما ليس كذلك: مجرد مشغّل باستمارة.
رد فعل: التحقق من الطريقة والرابط والترويسات قبل الإرسال.
- JSON
- صيغة نصية معيارية لتبادل البيانات المهيكلة (أزواج مفتاح/قيمة وقوائم) ترجعها معظم API.
مثال بسيط: الرد المستلم لدى لينا، معيَّن حقلا بحقل.
ما ليس كذلك: مستند منسَّق للطباعة.
رد فعل: تعيين كل مفتاح JSON نحو الحقل المستهدف الصحيح.
- التصديق (مفتاح API/رمز)
- آلية تثبت هويتكم لدى API (مفتاح أو رمز)، تُرسَل في الطلب وتُحفَظ سرا.
مثال بسيط: مفتاح لينا المخزَّن في الاتصال المشفر للأداة.
ما ليس كذلك: مفتاح ملصَق علنا في سيناريو مشترَك.
رد فعل: سر مشفر + حقوق دنيا + تجديد عند الشك.
في التطبيق — التشغيل بخطاف ونداء API
- أنشئوا سيناريو يُشغَّل بخطاف : انسخوا الرابط الموفَّر واضبطوا خدمة لإرسال بيانات إليه.
- أرسلوا أول نداء اختبار وراقبوا البيانات المستلمة (بنية JSON) في السيناريو.
- أضيفوا وحدة HTTP لنداء API خارجية (الطريقة والرابط والترويسات، والمفتاح عبر الاتصال المشفر).
- استرجعوا رد JSON وعيّنوا حقوله نحو الفعل التالي ؛ واختبروا من البداية إلى النهاية.
نص جاهز للقول — ربط أداة دون موصّل (30 ثانية)
« هذه الأداة دون موصّل، فأمر مخصصا. واحد : أُنشئ مشغّل خطاف، وألصق رابطه في تبليغات الأداة وأرسل نداء اختبار. اثنان : أضيف وحدة HTTP لنداء API الخاصة بها، والمفتاح في الاتصال المشفر، وأعيّن رد JSON نحو قاعدتنا. أختبر من البداية إلى النهاية قبل التفعيل. »
يُقال قبل الربط ؛ ولا يُلصَق أي مفتاح حقيقي في عرض مشترَك.
نموذج للنسخ واللصق — حمولة خطاف (مثال وهمي)
// الحمولة المستلمة على الخطاف — بيانات ورابط وهميان (مثال تعليمي)
// رابط وهمي : https://exemple-fictif.test/crochet/abc123 (لا تستعمله كما هو)
{
"evenement": "demande_recue",
"contact": { "nom": "Exemple Fictif", "objet": "DEVIS" },
"articles": [ { "nom": "Article A", "montant": 1200 } ]
}
// التعيين ← القاعدة : الاسم ← جهة الاتصال، والموضوع ← العنوان، والأصناف ← مكرر (3.4)مقاولة صغيرة جدا / مستقل
خطاف واحد يكفي لربط استمارة أو أداة بسيطة لحظيا، دون تغيير الاشتراك.
مقاولة صغيرة ومتوسطة في وهران
تربط لينا أداتها المهنية بالمتابعة الداخلية : خطاف دخولا، و HTTP خروجا، وأسرار مشفرة.
فريق رقمي
توثيق كل تكامل مخصص (الرابط والطريقة وتعيين JSON) لصيانته دون الاتكال على شخص.
مبتدئ
التدرب أولا بالخطاف وحده : استلام نداء اختبار ومراقبة البيانات قبل أي نداء HTTP.
✓ ممارسات جيدة
- استعمال خطاف لتشغيل شامل لحظي.
- نداء API الناقصة عبر وحدة HTTP (JSON).
- تخزين مفاتيح API مشفرة (الاتصالات المدمجة).
✗ أخطاء شائعة
- وضع مفتاح API علنا في السيناريو.
- نسيان التصديق/الترويسات في طلب HTTP.
- عدم اختبار استلام الخطاف قبل بناء الباقي.
النقاط الأساسية
- الخطاف رابط يُشغّل السيناريو فورا عندما ترسل خدمة بيانات إليه.
- وحدة HTTP تنادي أي API (GET/POST وترويسات وجسم) وتسترجع الرد.
- تعبر البيانات غالبا بـ JSON (مفتاح/قيمة وقوائم) تُعيَّن نحو الباقي.
- الخطافات + نداءات HTTP تفتح الخدمات دون موصّل رسمي — برمجة بدون كود بلا حدود.
تحدي 48 ساعة — طبّق غدا
أنشئوا سيناريو خطاف واحدا، وأرسلوا نداء اختبار وراقبوا بنية JSON المستلمة.
- أعرف ما هو الخطاف اللحظي.
- أعرف نداء API عبر HTTP + JSON.
- مفاتيحي في اتصال مشفر، لا علنا أبدا.
أسئلة شائعة
الخطاف، هل هو معقد ؟ وهل يتطلب برمجة ؟
لا، دون حاجة إلى برمجة. عمليا، تمنحكم الأداة رابطا ؛ ويكفي إدخال هذا الرابط في الخدمة الأخرى (في إعداداتها « خطاف » / « تبليغات ») لترسل إليه بيانات عند كل حدث. يستقبلها سيناريوكم وينطلق. والشيء الوحيد المطلوب فهمه هو المبدأ : « عنوان إذا خاطبناه أيقظ أتمتتي ». تصل البيانات بـ JSON، وتعرضه الأداة مقروءا للتعيين. وهو غالبا أبسط وأسرع من موصّل كلاسيكي، ويعمل مع كل خدمة تقريبا قادرة على إرسال خطاف.
أين أضع مفتاح API لنداء خدمة بأمان تام ؟
لا علنا أبدا في جسم السيناريو المرئي ولا في حقل مشترَك. المنعكسات الصحيحة : استعمال اتصالات/تصديقات الأداة المدمجة (التي تخزن السر مشفرا)، أو متغيرات البيئة/خزائن الأسرار عندما تتاح (خصوصا مع n8n، المستوى 4). مفتاح API كلمة سر : من يحصل عليه يستطيع التصرف باسمكم واستهلاك حصصكم. نحفظه سرا، ونجدده إذا تسرب، ونقصر حقوقه على الدنيا اللازمة. وأمن الأسرار مفصَّل في القسم 4.5.
ماذا يتيح الخطاف ؟