Skip to main content

واجهة برمجة تطبيقات Felo PPT تصدّر الآن ملفات PPTX حقيقية

· 7 دقائق
Felo Search Tips Buddy
Felo Search Tips Buddy
Committed to answers at your fingertips

واجهة برمجة تطبيقات المهام في Felo OpenAPI يمكنها الآن تصدير العروض التقديمية التي تم إنشاؤها كملفات .pptx قابلة للتحرير. مفتاح API واحد، تدفق غير متزامن من أربع خطوات، ورابط تنزيل.

يمكن لوكيلك البحث في موضوع، بناء مخطط، وإنشاء عرض شرائح مكتمل دون الحاجة إلى استخدام أي أداة تصميم. الشيء الوحيد الذي لم يستطع فعله هو تسليم ملف يمكن لفريقك فتحه في PowerPoint.

هذا النقص انتهى. واجهة Felo OpenAPI تصدّر الآن العروض التقديمية التي تم إنشاؤها كملفات .pptx حقيقية. واجهة برمجة تطبيقات المهام في PPT كانت تنتج شرائح قابلة للتحرير داخل Felo؛ نقاط النهاية الجديدة للتصدير تحولها إلى ملف PowerPoint يمكنك تنزيله وتحريره ومشاركته. نفس مفتاح API، نفس النمط غير المتزامن، مكالمة إضافية واحدة فقط.

جرّبها الآن: https://openapi.felo.ai/docs/api-reference/ppt-tasks

واجهة برمجة تطبيقات Felo PPT تصدّر الآن ملفات .pptx حقيقية: من البحث إلى العرض في تدفق واحد، POST /v2/ppts/{id}/export، رابط التنزيل صالح لمدة 30 دقيقة

ما الذي تغير فعليًا​

قبل هذا التحديث، كانت واجهة برمجة تطبيقات المهام في PPT تنتهي عند رابط شريحة Felo. تحصل على عرض تقديمي، لكن التسليم يتوقف هناك: لعرضه أمام عميل أو فصل أو مجلس إدارة، كان يجب على أحدهم إعادة بنائه يدويًا في PowerPoint.

الآن يكتمل التدفق. عندما تصل مهمة إنشاء PPT إلى الحالة COMPLETED، تستدعي نقطة نهاية تصدير واحدة وتستعلم عن الثانية. تعيد الواجهة رابط download_url موقع يشير إلى ملف .pptx أصلي — نفس العرض، بالتنسيق الذي يستخدمه الجميع.

هناك أمران يجعلان هذا أكثر من مجرد تحويل تنسيق:

  • العرض قابل للتحرير. ليس PDF، ولا مجموعة صور ثابتة. النص والتخطيطات وبنية القالب تنتقل إلى PowerPoint، فيستطيع زميل تعديل رقم أو إعادة ترتيب قسم دون إعادة الإنشاء.
  • البحث تم بالفعل. إنشاء PPT في Felo لا يضع مطالبتك فقط على الشرائح. يجري بحثًا حول الموضوع، يجمع المصادر، ينظم الحجة، ويطبق القالب. تحصل على عرض جاهز للتقديم، وليس مسودة أولى تحتاج إلى إعادة كتابة.

هذا الجمع هو الهدف. معظم الأدوات إما تبحث جيدًا وتسلمك نصًا، أو تنسق جيدًا وتسلمك هيكلًا فارغًا. Felo يفعل الأمرين، والآن يرسل النتيجة كملف.

كيف يعمل التصدير​

التصدير غير متزامن، مثل بقية واجهة برمجة تطبيقات المهام في PPT. ترسل مهمة، تستعلم حتى تنتهي، ثم تنزل النتيجة.

الخطوة 1 — أنشئ العرض التقديمي​

أنشئ مهمة PPT مع مطالبة. إذا رغبت في مظهر معين، اعرض القوالب المتاحة أولًا ومرر معرف القالب.

POST https://openapi.felo.ai/v2/ppts
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "query": "Q3 competitive landscape review, 12 pages",
  "ppt_config": {
    "ai_theme_id": "02968979-a69f-42c4-b136-de02c40ab2d7"
  }
}

الاستجابة تعيد task_id و ppt_business_id. احتفظ بهما — تحتاج معرف المهمة للاستعلام عن التوليد، ومعرف العمل للتصدير.

الخطوة 2 — استعلم حتى يصبح العرض جاهزًا​

GET https://openapi.felo.ai/v2/tasks/{task_id}/historical
Authorization: Bearer YOUR_API_KEY

استعلم كل 2–5 ثوانٍ. عندما تظهر task_status كـ COMPLETED، يصبح العرض موجودًا ويمكنك تصديره. يعود أيضًا ppt_url إذا رغبت في معاينة الشرائح في Felo أولًا.

الخطوة 3 — أرسل طلب التصدير​

POST https://openapi.felo.ai/v2/ppts/YOUR_PPT_BUSINESS_ID/export
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{}

هذا هو كامل جسم الطلب: {}. التصدير يعمل كعملية في الخلفية.

الخطوة 4 — استعلم عن التصدير ونزل الملف​

GET https://openapi.felo.ai/v2/ppts/{ppt_business_id}/export
Authorization: Bearer YOUR_API_KEY

استعلم كل 2–5 ثوانٍ. تنتقل data.status عبر NOT_STARTED، PROCESSING، و COMPLETED. فقط COMPLETED تحمل الحمولة المطلوبة:

{
  "status": "ok",
  "message": null,
  "data": {
    "status": "COMPLETED",
    "download_url": "https://example.com/presentation.pptx?signature=...",
    "expires_at": "2026-09-29T10:30:00Z"
  }
}

نزّل الملف من download_url وتنتهي العملية.

تدفق تصدير PPTX: POST /v2/ppts ينشئ العرض، GET /v2/tasks/{task_id}/historical يستعلم حتى COMPLETED، POST /v2/ppts/{id}/export يبدأ التصدير، GET /v2/ppts/{id}/export يعيد download_url صالح لمدة 30 دقيقة

أربع نقاط مهمة قبل الإطلاق​

رابط التنزيل ينتهي بعد 30 دقيقة من إصداره. هذا رابط موقع، وليس دائمًا. إذا انتهت صلاحيته، استدع نقطة نهاية GET للتصدير مرة أخرى — هذا يصدر رابطًا جديدًا دون إعادة إنشاء ملف PPTX، فلا توجد تكلفة إضافية.

إعادة تشغيل التصدير بعد اكتماله تستهلك رصيدًا. تكرار POST أثناء معالجة التصدير آمن ولا يبدأ مهمة ثانية. لكن استدعاء POST مرة أخرى بعد اكتمال التصدير يعيد إنشاء الملف ويستهلك رصيد تصدير PPT الحالي. إذا احتجت فقط إلى رابط جديد، استخدم GET.

مفتاح API يجب أن يملك العرض. التصدير مرتبط بالمفتاح الذي أنشأ العرض. المفتاح الذي لم ينشئ العرض لا يستطيع تصديره، وهذا يحافظ على العروض داخل الحساب الذي أنشأها.

الإخفاقات قابلة لإعادة المحاولة. تصدير بحالة FAILED يمكن إرساله مجددًا بنفس POST. الرصيد غير الكافي يعيد HTTP 402؛ حدود المعدل تعيد HTTP 429 ويمكن إعادة المحاولة بعد فترة قصيرة.

لماذا هذا مهم للوكلاء​

الأمر المثير ليس تنسيق الملف. بل ما يتيحه خط بحث إلى ملف مكتمل.

وكيل يستطيع البحث والتصدير يمكنه الآن تنفيذ الدورة الكاملة دون إشراف:

  • مراجعات الأعمال الأسبوعية — يسحب مؤشرات الأسبوع، يبحث في سياق الأرقام، ينشئ العرض، يصدره، ويضع ملف .pptx في المجلد المشترك قبل اجتماع الاثنين.
  • تسليمات العملاء — يحول ملخصًا إلى عرض موثق وذو قالب ويسلم ملفًا قابلاً للتحرير يمكن للعميل تخصيصه.
  • تمكين المبيعات — ينشئ عرضًا مخصصًا لكل عميل محتمل بناءً على بحث الحساب، يصدر كل واحد، ويرفقه تلقائيًا بسجل CRM.
  • مواد الدورات والتدريب — يبحث في موضوع، ينظمه كدرس، يصدر شرائح يمكن للمدرب تعديلها قبل الحصة.

في كل حالة، ينحصر دور الإنسان في المراجعة والتعديل. لا أحد يبدأ من شريحة فارغة.

إذا لم ترغب في كتابة حلقة الاستعلام بنفسك، مهارة Felo PPT تتولى ذلك. ثبت حزمة وكيل Felo AI فيكتسب وكيلك القدرة على إنشاء واستعلام وتصدير العروض كقدرة واحدة — نفس التدفق أعلاه، مغلف بحيث يمكن للوكيل استدعاؤه مباشرة.

البدء​

التصدير متاح الآن في واجهة برمجة تطبيقات المهام في PPT، متوفر لكل مفتاح Felo OpenAPI.

  1. احصل على مفتاح API من لوحة تحكم Felo OpenAPI.
  2. اقرأ مرجع واجهة برمجة تطبيقات المهام في PPT — قسم تصدير PPTX يحتوي على تفاصيل الطلب والاستجابة.
  3. أنشئ عرضًا، صدره، وافتح الملف في PowerPoint.

إذا رغبت في الطريق الأسرع، ثبت مهارة Felo PPT ودع وكيلك ينفذ التدفق كاملًا.

ابدأ البناء مع Felo OpenAPI: https://openapi.felo.ai

الأسئلة الشائعة​

هل الملف المصدر قابل للتحرير فعلاً في PowerPoint؟ نعم. التصدير ينتج ملف .pptx قياسي. النص والتخطيط وبنية القالب تنتقل، فيمكن تحرير العرض في PowerPoint أو Google Slides أو Keynote.

هل التصدير يكلف رسومًا إضافية؟ إرسال التصدير بعد إنشاء العرض يستهلك رصيد تصدير PPT الحالي. الرصيد غير الكافي يعيد HTTP 402. جلب رابط تنزيل جديد عبر GET لا يعيد إنشاء الملف ولا يضيف تكلفة.

كم مدة صلاحية رابط التنزيل؟ 30 دقيقة من الإصدار. استدع نقطة نهاية GET للتصدير مرة أخرى للحصول على رابط جديد.

هل يمكنني تصدير عرض تم إنشاؤه بمفتاح API مختلف؟ لا. مفتاح API الذي ينفذ طلب التصدير يجب أن يملك العرض.

ماذا يحدث إذا فشل التصدير؟ تعيد data.status القيمة FAILED. أرسل طلب POST للتصدير مرة أخرى لإعادة المحاولة.

تتوفر هذه المقالة أيضًا باللغات التالية: English, 简体中文, 日本語, 한국어, 繁體中文, हिन्दी, Français, Русский, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Türkçe, Italiano, ไทย, Español, বাংলা and Português.