دليل تكامل Webhook المخصص عبر HTTP

تتيح لك ميزة Webhook المخصص في DuRT إرسال مخرجات المهام المنظمة بالكامل (العناوين، والملخصات، وبنود العمل، والنصوص الكاملة بالطوابع الزمنية) كحمولات JSON عبر طلبات HTTP POST إلى أي نقطة نهاية أو منصة أتمتة تابعة لجهة خارجية بمجرد اكتمال المعالجة.

تتكامل هذه الميزة بسلاسة مع أدوات سير العمل الشائعة مثل Zapier وMake (Integromat) وn8n، بالإضافة إلى البوابات البرمجية المؤسسية والخوادم المخصصة.

---

منصات الأتمتة المدعومة

• Zapier: اختر مشغل "Catch Hook" في Zapier Webhooks.
• Make: استخدم مشغل "Custom Webhook".
• n8n: أضف عقدة Webhook مضبوطة على طريقة POST.
• الخوادم الخاصة المخصصة: أي خادم HTTP / HTTPS يستقبل حمولات JSON.

---

دليل التكوين خطوة بخطوة

1. في DuRT، انتقل إلى الإعدادات ➔ التكاملات والتسليم (Settings -> Integrations & Delivery).
2. انقر فوق + إضافة حساب (+ Add Account) واختر Custom Webhook.
3. اسم الحساب (Account Name): اسم مميز لمساعدتك في التعرف على الوجهة (مثل أتمتة Zapier).
4. رابط نقطة النهاية (Endpoint URL): أدخل عنوان URL الكامل لنقطة نهاية HTTP POST.
5. الترويسات المخصصة (Custom Headers - اختياري): أضف مفاتيح التحقق والتوثيق بتنسيق JSON، على سبيل المثال:

   {
     "Authorization": "Bearer YOUR_SECRET_TOKEN",
     "Content-Type": "application/json"
   }

6. انقر فوق حفظ (Save).

---

نموذج حمولة البيانات بصيغة JSON

{
  "task_id": "8f9b0c2e-4d5a-4e8a-bf90-33219488a0e1",
  "title": "مراجعة الاستراتيجية وخريطة الطريق",
  "created_at": "2026-10-14T07:30:00Z",
  "duration_seconds": 1542.8,
  "formatted_duration": "00:25:42",
  "summary": "النقاط الرئيسية التي تمت مناقشتها بخصوص محركات التعرف الصوتي على الجهاز ومسارات العمل متعددة اللغات...",
  "document_markdown": "## ملخص تنفيذي\n...",
  "action_items": [
    "استكمال اختبار التحقق الشامل من تكامل Webhook",
    "تحديث وثائق الفريق البرمجية"
  ],
  "transcript": [
    {
      "start": 0.0,
      "end": 2.45,
      "speaker": "المتحدث 1",
      "text": "أهلاً بالجميع في جلسة المراجعة اليوم."
    }
  ],
  "metadata": {
    "workflow": "مسار الاجتماعات القياسي",
    "app_version": "3.1.0",
    "platform": "macOS"
  }
}