Skip to main content
نوصي بشدة باستخدام «تشغيل برنامج نصي» لإنشاء عمليات الأتمتة، لأنه يستطيع تغطية جميع سلوكيات الإجراءات، بما فيها الإجراءات التي كان يلزم إنشاؤها يدويًا لولا ذلك. ما عليك سوى وصف متطلباتك للذكاء الاصطناعي في الدردشة.يُرجى ملاحظة أنه إذا أضفت إجراءات يدويًا، فلن يتعرف عليها الذكاء الاصطناعي أو يعدّلها لاحقًا.

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

افتح دردشة الذكاء الاصطناعي في الشريط الجانبي الأيمن للجدول وصِف ما تريده. يتولى الذكاء الاصطناعي كل شيء: يختار المشغّل المناسب، وينتقي الإجراءات الملائمة، ويربط الحقول، ويهيئ سير العمل بالكامل تلقائيًا. صِف الهدف مرة واحدة، وسيصبح سير العمل جاهزًا دون الحاجة إلى إعداد يدوي. يرسل طلب HTTP إلى أي عنوان URL ويعيد الاستجابة. استخدمه لاستدعاء واجهات REST API، أو إرسال إشعارات إلى Slack أو Discord، أو دفع البيانات إلى أنظمة CRM، أو التفاعل مع أي خدمة تملك واجهة HTTP API.

​
التهيئة

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

  1. أضف إجراء طلب HTTP إلى سير العمل.
  2. أدخل عنوان URL لنقطة نهاية API. يمكنك استخدام + لإدراج قيم ديناميكية (مثل تضمين معرّف سجل في مسار URL).
  3. اختر الطريقة:
    • GET — استرداد البيانات.
    • POST — إرسال بيانات لإنشاء شيء.
    • PUT / PATCH — تحديث بيانات موجودة.
    • DELETE — حذف البيانات.
  4. أضف ترويسات إذا كانت واجهة API تتطلبها (مثل رموز التفويض أو الترويسات المخصصة).
  5. اختر Content-Type واكتب النص عند الحاجة (مع POST وPUT وPATCH).
  6. احفظ الإجراء.

​
شرح خيارات Content-Type

إذا لم تكن متأكدًا من Content-Type المناسب، فاختر application/json. تستخدم معظم واجهات API الحديثة JSON.
إذا لم تكن متأكدًا من الخيار المناسب، فإن application/json هو الاختيار الصحيح لمعظم واجهات API الحديثة.

​
أمثلة المصادقة

تتطلب واجهات API كثيرة المصادقة. فيما يلي أنماط شائعة يمكنك إعدادها في قسم الترويسات:

​
رمز Bearer

أضف ترويسة:
  • المفتاح: Authorization
  • القيمة: Bearer your-api-token-here
يعمل ذلك مع واجهات API مثل Slack وGitHub وNotion وغيرها الكثير.

​
مفتاح API في الترويسة

أضف ترويسة:
  • المفتاح: X-API-Key (أو ما تتوقعه واجهة API، مثل api-key أو x-api-token)
  • القيمة: your-api-key

​
المصادقة الأساسية

أضف ترويسة:
  • المفتاح: Authorization
  • القيمة: Basic base64encoded(username:password)
ستحتاج إلى ترميز بيانات اعتمادك باستخدام Base64 خارج Teable أو استخدام إجراء برنامج نصي لإنشاء قيمة الترويسة.

​
مثال عملي: إرسال إشعار إلى Slack

الهدف: نشر رسالة في قناة Slack عند إنشاء سجل جديد.
  1. المشغّل: عند إنشاء سجل.
  2. الإجراء: طلب HTTP بالإعدادات التالية:
    • عنوان URL: https://hooks.slack.com/services/T00/B00/xxxx (عنوان URL لخطاف Slack لديك)
    • الطريقة: POST
    • Content-Type: application/json
    • النص:
    استبدل {{Task Name}} و{{Priority}} بمتغيرات ديناميكية من المشغّل بالنقر على +.

​
استخدام بيانات الاستجابة في الخطوات التالية

بعد تنفيذ طلب HTTP، تصبح الاستجابة متاحة للإجراءات اللاحقة:
  • رمز الحالة — حالة HTTP ‏(200 و201 و404، إلخ).
  • نص الاستجابة — البيانات التي تعيدها واجهة API، وتُحلل بوصفها JSON عند انطباق ذلك.
يمكنك الإشارة إلى حقول محددة في الاستجابة باستخدام منتقي المتغيرات + في الخطوات اللاحقة. على سبيل المثال، إذا أعادت واجهة API القيمة {"id": "abc123", "status": "created"}، فيمكنك الإشارة إلى id وstatus كلًا على حدة. وعند إدراج قيم ديناميكية باستخدام +، يمكنك أيضًا استخدام مسارات الحقول وخيارات التنسيق عندما تتطلب واجهة API خارجية تنسيق طلب محددًا. يفيد ذلك في تسلسل استدعاءات API — على سبيل المثال، أنشئ شيئًا عبر POST، واستلم معرّفًا، ثم استخدمه في إجراء لاحق لتحديث سجل أو في طلب HTTP آخر.

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

  • نشر رسائل في Slack أو Discord. أرسل إشعارات إلى القنوات باستخدام عناوين URL لخطافات الويب الواردة.
  • مزامنة البيانات مع CRM أو ERP. ادفع السجلات الجديدة أو المحدّثة إلى Salesforce أو HubSpot أو أي نظام يملك واجهة API.
  • استدعاء أي واجهة API لجهة خارجية. تفاعل مع معالجات الدفع أو خدمات الشحن أو أدوات التحليلات أو واجهات API داخلية مخصصة.
  • تشغيل تدفقات عمل خارجية. استدعِ خطافات Zapier أو سيناريوهات Make ‏(Integromat) أو منصات أتمتة أخرى.
  • جلب بيانات من مصادر خارجية. استخدم طلبات GET لسحب أسعار الصرف أو بيانات الطقس أو أي بيانات API عامة إلى سير العمل.

​
نصائح

  • راجع دائمًا وثائق واجهة API لمعرفة الترويسات والمصادقة وتنسيق النص المتوقع.
  • استخدم application/json بوصفه Content-Type لمعظم واجهات API الحديثة. إذا كانت الواجهة تتوقع بيانات نموذج، فانتقل إلى x-www-form-urlencoded.
  • إذا أعادت واجهة API خطأً (حالة 4xx أو 5xx)، يظل الإجراء مكتملًا، لكن الخطوات اللاحقة سترى استجابة الخطأ. تحقق من رمز الحالة في سير العمل إذا كنت تحتاج إلى معالجة شرطية.
  • بالنسبة إلى واجهات API التي تعيد استجابات كبيرة، لا تشر في الخطوات اللاحقة إلا إلى الحقول المحددة التي تحتاج إليها.
  • ادمج الإجراء مع الحلقة (دفعة) لإجراء عدة استدعاءات API، واحد لكل سجل. وانتبه إلى حدود معدل واجهة API الخارجية.
  • استخدم ميزة نص مصفوفة HTTP عندما تحتاج إلى إرسال عدة عناصر في طلب واحد بدلًا من طلب لكل عنصر.

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

آخر تعديل في ٤ سبتمبر ٢٠٢٦