عند استلام خطاف ويب

​

الإنشاء بالذكاء الاصطناعي

​

التهيئة

​

كيفية الإعداد

1. افتح الأتمتة وأضف مشغّلًا جديدًا.
2. اختر عند استلام خطاف ويب.
3. ينشئ المشغّل فورًا عنوان URL لخطاف ويب فريدًا. انسخ هذا العنوان؛ فستحتاج إليه في النظام الخارجي.
4. (اختياري لكن موصى به) انقر على إنشاء رمز لتمكين التفويض برمز Bearer. يؤدي ذلك إلى إنشاء رمز يجب تضمينه في ترويسة Authorization للطلبات الواردة.
5. احفظ الأتمتة وفعّلها.
6. هيّئ النظام الخارجي لإرسال طلب POST إلى عنوان خطاف الويب. ضمّن الرمز في الترويسة إذا فعّلت التفويض.
7. أرسل طلب اختبار (راجع الأمثلة أدناه). تحقق من سجل تشغيل الأتمتة للتأكد من استلام البيانات بصورة صحيحة.
8. أضف خطوات الإجراءات. انقر على + في أي حقل إجراء للإشارة إلى قيم من نص JSON لخطاف الويب.

​

البيانات المتاحة للخطوات التالية

{
  "order_id": "12345",
  "customer": "أليس",
  "amount": 99.95
}

​

تخصيص الاستجابة

{"challenge":"{{body.challenge}}"}

​

اختبار خطاف الويب

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -d '{"test": true, "message": "مرحبًا من curl"}'

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{"order_id": "12345", "status": "paid"}'

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{
    "event": "invoice.paid",
    "data": {
      "invoice_id": "INV-001",
      "amount": 250.00,
      "currency": "USD",
      "customer_email": "alice@example.com"
    }
  }'

​

حدود المعدل

​

أفضل ممارسات الأمان

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

​

حالات الاستخدام

• استلام أحداث الدفع من Stripe أو PayPal. هيّئ خطاف Stripe لإرسال أحداث invoice.paid إلى أتمتة Teable، وإنشاء سجلات الطلبات أو تحديثها تلقائيًا.
• قبول عمليات إرسال النماذج من موقعك. وجّه نموذج الاتصال أو التسجيل في موقعك إلى عنوان خطاف الويب لإنشاء سجلات مباشرةً في Teable.
• إدخال بيانات من أجهزة إنترنت الأشياء. تستطيع أجهزة الاستشعار أو الأجهزة القادرة على إرسال طلبات HTTP دفع البيانات إلى Teable للمراقبة والتنبيه.
• ربط مسارات CI/CD. شغّل تدفقات العمل عند نجاح بناء أو فشله؛ لإنشاء سجلات أو إرسال إشعارات أو تحديث حالة المشروع.
• استلام أحداث من أي أداة SaaS. تدعم أدوات كثيرة (GitHub وJira وShopify وTwilio وغيرها) إشعارات خطافات الويب. وجّهها إلى خطاف Teable لأتمتة تدفقات العمل بين الأدوات.

​

نصائح

• لا يقبل خطاف الويب إلا طلبات POST. ولن تشغّل طلبات GET أو PUT أو الطرق الأخرى الأتمتة.
• أرسل دائمًا ترويسة Content-Type: application/json. وإذا لم يكن النص JSON صالحًا، فقد لا يحلل المشغّل البيانات بصورة صحيحة.
• إذا أردت إرسال بيانات من نظام لا يدعم الترويسات المخصصة (لمصادقة Bearer)، ففكّر في استخدام الوضع العام مع إضافة مفتاح سري إلى نص JSON يتحقق منه سير العمل بعامل تصفية أو برنامج نصي.
• لتصحيح الأخطاء، يمكنك استخدام خدمات مثل webhook.site لفحص ما يرسله نظامك الخارجي فعلًا قبل توجيهه إلى Teable.

​

موضوعات ذات صلة

• إجراء طلب HTTP — النظير الصادر: استدعاء واجهات API خارجية من سير العمل
• تشغيل برنامج نصي — للمعالجة المتقدمة لحمولات خطاف الويب
• إجراء الحلقة (دفعة) — معالجة المصفوفات في حمولات خطاف الويب